Container Registry:Dockerfile最適化の推奨事項

背景情報

Container Registry Enterprise Editionが提供するイメージ構築サービスを使用すると、Container Registryは、Container Registryがイメージを構築する前に、Dockerfilesを自動的に最適化および推奨できます。 Container Registryは、Dockerfile最適化推奨機能を使用して、構文ルールとベストプラクティスルールに基づいてDockerfilesを分析し、分析結果を提供します。 構文ルールの詳細については、「Dockerfile reference」をご参照ください。

分析結果は、次のレベルの問題に分けられます。

• エラー: Dockerfileには、Container Registryでサポートされていない構文エラーまたは建物パラメーターが含まれています。 エラーレベルの問題は、イメージビルディングでエラーを引き起こす可能性があります。 エラーレベルの問題を修正する必要があります。

• 警告: Dockerfileには潜在的な問題が含まれています。 警告レベルの問題は、予期しない画像構築結果や画像内の冗長データを引き起こす可能性があります。

分析結果の形式

構文検出結果

[Error] <Error message> at line <line number>: <Specific instruction content>
[Warning] <Warning message> at line <line number>: <Specific instruction content>
[Error] [Rule <Rule id>] <Error message> at line <line number>: <Specific instruction content>
[Warning] [Rule <Rule id>] <Warning message> at line <line number>: <Specific instruction content>

例 1

Dockerfileに構文エラーが含まれています。

# The FROM instruction uses a base image of an unsupported architecture and does not specify the names of the stages in multi-stage building.
FROM --platform=windows alpine as
# The RUN instruction uses unsupported running parameters.
RUN --security=insecure cat /proc/self/status | grep CapEff
# No destination path is specified in the ADD instruction.
ADD https://mirrors.edge.kernel.org/pub/linux/kernel/Historic/linux-0.01.tar.gz
# The COPY instruction does not support copying of remote files.
COPY https://mirrors.edge.kernel.org/pub/linux/kernel/Historic/linux-0.01.tar.gz linux-0.01.tag.gz
# The source file path that is specified in the COPY/ADD instruction does not exist in the building path.
COPY <Path that does not exist> /somedir/
# The name of the instruction is invalid.
CPY /foo /bar

次のコードは、前述のDockerfileの構文検出結果を提供します。

[parse stage begin.]
[Error] Unsupported target architecture at line 2: windows.
[Error] Lack of stage name at line 2.
[Error] Unsupported security mode at line 4: insecure.
[Error] Lack of dest at line 6.
[Error] COPY does not support remote links. Please use the ADD instruction at line 8: https://mirrors.edge.kernel.org/pub/linux/kernel/Historic/linux-0.01.tar.gz.
[Error] Source path is not exist at line 10: <Path that does not exist>.
[Error] Unknown instruction at line 12: CPY.
[Warning] No tag specified at line 2: from ["--platform=windows"] "alpine" "as".
[parse successfully, takes 0s.]

例 2

Dockerfileはベストプラクティスのルールに準拠していません。

# No image tag is specified.
FROM alpine AS a
# The cache of the software package is not cleared after the software is installed.
RUN apk add gcc
# No image tag is specified. An existing stage name is used.
from ubuntu as a
# The cache of the software package is not cleared after the software is installed. No --no-install-recommends instruction is used to prevent unnecessary software packages from being downloaded.
RUN apt-get install -y gcc

次のコードは、前述のDockerfileの構文検出結果を提供します。

[parse stage begin.]
[Warning] [Rule1003]When installing software with apt-get, it is recommended to include the --no-install-recommends parameter at line 8: RUN apt-get install -y gcc .
[Warning] No tag specified at line 2: FROM alpine AS a .
[Warning] No tag specified at line 6: from ubuntu as a .
[Warning] [Rule1001]Using a base image with a specific tag instead of the latest image.
[Error] Duplicate stage names with line 2: a at line 6: from ubuntu as a .
[Error] [Rule1014]Do not use duplicate stage names.
[parse successfully, takes 0s.]

検出ルール

ベストプラクティスのルール

FROM alpine:3.17 as complie
COPY <source code> code/
RUN make
FROM alpine:3.17
COPY --from=compile /code/bin bin/