docker buildコマンドの使い方完全ガイド｜Dockerfileからイメージを作成する

ひとことで言うと

# カレントディレクトリのDockerfileでイメージをビルド
docker build -t myapp:latest .

# 別ディレクトリのDockerfileを指定してビルド
docker build -t myapp:latest -f ./docker/Dockerfile .

やりたかったこと / 現象

Dockerfileを書いたのに、どうやってイメージを作ればいいかわからない。docker buildコマンドの使い方を知りたい、というケースは非常によくあります。

本記事ではdocker buildの基本から、タグ付け・キャッシュ制御・マルチステージビルドまで実践的な使い方を解説します。

環境

Docker Engine 24.x 以上
OS: Ubuntu 22.04 / macOS / Windows (WSL2)

解決策

基本的なビルド手順

まずシンプルなDockerfileを用意します。

# Dockerfile
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["node", "index.js"]

ビルドコマンドを実行します。

# カレントディレクトリ（.）をビルドコンテキストとしてビルド
docker build -t myapp:latest .

タグの付け方

# -t オプションで名前とタグを指定
docker build -t myapp:1.0.0 .

# 複数のタグを同時に付ける
docker build -t myapp:latest -t myapp:1.0.0 .

# レジストリ名を含む完全なタグ
docker build -t ghcr.io/yourname/myapp:latest .

Dockerfileのパスを指定する

# -f でDockerfileのパスを指定
docker build -t myapp:latest -f ./docker/Dockerfile .

# 別ディレクトリをビルドコンテキストにする
docker build -t myapp:latest -f Dockerfile /path/to/context

ビルド引数（ARG）を渡す

# Dockerfile内での定義
ARG NODE_ENV=production
ENV NODE_ENV=$NODE_ENV

# --build-arg でビルド時の変数を注入
docker build --build-arg NODE_ENV=development -t myapp:dev .

キャッシュを無効化してクリーンビルド

# --no-cache で全レイヤーを再ビルド
docker build --no-cache -t myapp:latest .

マルチステージビルドでイメージを軽量化

# Dockerfile（マルチステージ）
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/index.js"]

# 通常通りビルドするだけでOK（最終ステージのみイメージ化）
docker build -t myapp:slim .

# 特定のステージまでビルドする
docker build --target builder -t myapp:builder .

ビルド後にイメージを確認する

# ビルドしたイメージの一覧表示
docker images

# イメージの詳細情報
docker inspect myapp:latest

# イメージのサイズ確認
docker images myapp

よくあるエラーと対処

`COPY failed: file not found`

COPY failed: COPY instruction failed: failed to copy './src': 
no such file or directory

原因: ビルドコンテキスト外のファイルをCOPYしようとしている、またはファイルが存在しない。

対処:

# ビルドコンテキスト（.）の内容を確認
ls -la

# .dockerignoreで除外されていないか確認
cat .dockerignore

`failed to solve: failed to read dockerfile`

failed to solve with frontend dockerfile.v0: 
failed to read dockerfile: open Dockerfile: no such file or directory

原因: カレントディレクトリにDockerfileが存在しない。

対処:

# ファイルの存在確認
ls Dockerfile

# パスを明示的に指定
docker build -f ./path/to/Dockerfile -t myapp .

`error: pull access denied`

pull access denied for baseimage, repository does not exist 
or may require 'docker login'

原因: FROMで指定したベースイメージが存在しない、またはプライベートレジストリの認証が切れている。

対処:

# Docker Hubへログイン
docker login

# イメージ名のタイポを確認
docker pull node:20-alpine

`no space left on device`

原因: Dockerのビルドキャッシュやイメージがディスクを圧迫している。

対処:

# 不要なキャッシュを削除
docker builder prune

# 使っていないイメージ・コンテナを一括削除
docker system prune -a

よくある質問

Q: .（ドット）はビルドコマンドで何を意味しますか？ ビルドコンテキストのパスです。Dockerデーモンにこのディレクトリ以下のファイルを送信します。COPY命令やADD命令はこのコンテキスト内のファイルのみ参照できます。

Q: ビルドコンテキストが大きくてビルドが遅いときは？ .dockerignoreファイルを作成して不要なファイルを除外しましょう。node_modules・.git・distなどを除外するだけで大幅に高速化できます。

# .dockerignore
node_modules
.git
dist
*.log
.env

Q: タグを省略した場合はどうなりますか？ -tを省略するとタグが<none>になります。あとからdocker tagで付与できますが、最初から-tを付けるのがベストプラクティスです。

Q: マルチステージビルドを使うメリットは何ですか？ ビルド用ツールチェーン（コンパイラ、devDependencies など）を最終イメージに含めずに済むため、イメージサイズを大幅に削減できます。セキュリティ面でも不要なツールが入らないため有利です。

Q: docker buildとdocker buildx buildの違いは？ docker buildxはBuildKitベースの拡張ビルドコマンドで、マルチプラットフォームビルド（AMD64/ARM64など）やより高度なキャッシュ戦略が利用できます。通常用途ではdocker buildで十分です。

Q: ビルド中にキャッシュを活用するコツは？ 変更頻度の低いレイヤー（COPY package*.json→RUN npm install）を先に書き、変更頻度の高いソースコードのCOPYを後ろに置くことでキャッシュが効きやすくなります。