docker build

パッケージと実行環境

書き方

docker build -t <name>:<tag> [-f <Dockerfile>] <context>

Dockerfileからイメージを作ります。末尾の点はデーモンへ送るビルドコンテキストなので、フォルダーが大きいとビルドが遅くなり(.dockerignoreで削ります)、COPYはそのコンテキスト内のファイルしか見えません。

よく使うオプション

オプション	意味
-t <name>:<tag>	name the image; without it you only get an id
-f <file>	use a Dockerfile that is not ./Dockerfile
--no-cache	rebuild every layer
--build-arg KEY=value	pass an ARG into the build
--target <stage>	stop at one stage of a multi-stage file
--platform linux/amd64	build for another architecture
--progress=plain	full log output instead of the collapsed view

例

docker build -t myapp:1.0 .

builds from ./Dockerfile with the current folder as context

docker build -f docker/Dockerfile.dev -t myapp:dev .

another Dockerfile, same context

docker build --platform linux/amd64 -t myapp:1.0 .

an x86 image built on an Apple Silicon Mac

何をどこに入れるかが問題です。このプロジェクトの中か、マシン全体かを先に決めてください。

読み方

Q. docker build は何をしますか。

Q. どう打ちますか。

docker build -t <name>:<tag> [-f <Dockerfile>] <context> — 角括弧は省いてよい部分です。

Q. よく使うオプションはいくつですか。

ここにまとめたのは7個です。全部は man docker にあります。このコマンドはパッケージと実行環境の仲間です。