Docker BuildKitで高速ビルド！初心者でもわかるキャッシュ活用術

DOCKER_BUILDKIT=1 docker build -t myapp:latest .

# ~/.bashrc または ~/.zshrc に追加
export DOCKER_BUILDKIT=1

# 環境変数をPowerShellで設定
[System.Environment]::SetEnvironmentVariable('DOCKER_BUILDKIT', '1', 'User')

{
  "features": {
    "buildkit": true
  }
}

docker build -t myapp:latest .

# 進行状況の詳細表示
docker build --progress=plain -t myapp:latest .

# 最終的な出力のみ表示
docker build --progress=auto -t myapp:latest .

# ビルド履歴の確認
docker buildx ls

# キャッシュの確認
docker buildx du

# ビルドキャッシュをクリア
docker buildx prune

# すべてのビルドキャッシュを削除
docker buildx prune -a

FROM node:20

# アプリケーション全体をコピー（変更のたびに全体が再ビルドされる）
COPY . /app
WORKDIR /app

# 依存関係のインストール（毎回実行される）
RUN npm install

# アプリケーションの起動
CMD ["npm", "start"]

FROM node:20

WORKDIR /app

# package.jsonとpackage-lock.jsonのみを先にコピー
COPY package*.json ./

# 依存関係のインストール（package.jsonが変更されない限りキャッシュされる）
RUN npm install

# アプリケーションコードをコピー
COPY . .

# アプリケーションの起動
CMD ["npm", "start"]

FROM python:3.14

WORKDIR /app

# 1. システムパッケージ（ほとんど変更しない）
RUN apt-get update && apt-get install -y \
    build-essential \
    && rm -rf /var/lib/apt/lists/*

# 2. Pythonの依存関係（時々変更する）
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 3. アプリケーションコード（頻繁に変更する）
COPY . .

CMD ["python", "app.py"]

# .dockerignore
node_modules
npm-debug.log
.git
.env
*.md
tests/

# ステージ1: ビルド環境
FROM node:20 AS builder

WORKDIR /app

# 依存関係のインストール
COPY package*.json ./
RUN npm ci

# アプリケーションのビルド
COPY . .
RUN npm run build

# ステージ2: 本番環境
FROM node:20-alpine

WORKDIR /app

# 本番用の依存関係のみインストール
COPY package*.json ./
RUN npm ci --production

# ビルド済みファイルをコピー
COPY --from=builder /app/dist ./dist

# ユーザーを作成して権限を最小化
RUN addgroup -g 1001 -S nodejs && \
    adduser -S nodejs -u 1001
USER nodejs

EXPOSE 3000

CMD ["node", "dist/index.js"]

# ステージ1: ビルド
FROM golang:1.25 AS builder

WORKDIR /app

# Go modulesの依存関係をキャッシュ
COPY go.mod go.sum ./
RUN go mod download

# ソースコードをコピーしてビルド
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o main .

# ステージ2: 最小限の実行環境
FROM alpine:latest

# セキュリティアップデート
RUN apk --no-cache add ca-certificates

WORKDIR /root/

# ビルドしたバイナリのみをコピー
COPY --from=builder /app/main .

CMD ["./main"]

# syntax=docker/dockerfile:1.4

FROM node:20 AS deps
WORKDIR /app
COPY package*.json ./
RUN --mount=type=cache,target=/root/.npm \
    npm ci

FROM node:20 AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build

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

# syntax=docker/dockerfile:1.4

FROM node:20

WORKDIR /app

# プライベートパッケージのインストール時にNPMトークンを使用
RUN --mount=type=secret,id=npmtoken \
    echo "//registry.npmjs.org/:_authToken=$(cat /run/secrets/npmtoken)" > ~/.npmrc && \
    npm install @private/package && \
    rm ~/.npmrc

COPY . .

CMD ["npm", "start"]

docker build --secret id=npmtoken,src=.npmtoken -t myapp .

# syntax=docker/dockerfile:1.4

FROM python:3.14

WORKDIR /app

# SSHキーを使ってプライベートリポジトリをクローン
RUN --mount=type=ssh \
    git clone git@github.com:private/repo.git

COPY requirements.txt .
RUN pip install -r requirements.txt

CMD ["python", "app.py"]

docker build --ssh default -t myapp .

# syntax=docker/dockerfile:1.4

FROM python:3.14

WORKDIR /app

COPY requirements.txt .

# pipのキャッシュをビルド間で共有
RUN --mount=type=cache,target=/root/.cache/pip \
    pip install -r requirements.txt

COPY . .

CMD ["python", "app.py"]

# syntax=docker/dockerfile:1.4

FROM node:20 AS base
WORKDIR /app
COPY package*.json ./
RUN npm ci

# 開発環境用
FROM base AS development
COPY . .
RUN npm run build:dev
CMD ["npm", "run", "dev"]

# 本番環境用
FROM base AS production
COPY . .
RUN npm run build:prod
CMD ["npm", "start"]

# 開発環境用
docker build --target development -t myapp:dev .

# 本番環境用
docker build --target production -t myapp:prod .

# キャッシュをクリアして再ビルド
docker buildx prune -a
docker build --no-cache -t myapp .

# 詳細なログを出力
docker build --progress=plain -t myapp . 2>&1 | tee build.log

# Docker Desktopのリソース設定を確認・調整

# QEMUエミュレータのインストール
docker run --privileged --rm tonistiigi/binfmt --install all

# ビルダーの作成と使用
docker buildx create --use --name multiplatform
docker buildx build --platform linux/amd64,linux/arm64 -t myapp .

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

# 変更頻度の低い順に配置
FROM base

# システムパッケージ
RUN apt-get update && apt-get install -y package

# 依存関係
COPY requirements.txt .
RUN pip install -r requirements.txt

# アプリケーションコード
COPY . .

# syntax=docker/dockerfile:1.4
FROM node:20
# ...

time docker build -t myapp .

# GitHub Actionsの例
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v2
      
      - name: Build and push
        uses: docker/build-push-action@v4
        with:
          context: .
          push: true
          tags: myapp:latest
          cache-from: type=gha
          cache-to: type=gha,mode=max

# 初回ビルド（キャッシュなし）
time docker build --no-cache -t myapp:test1 .

# 2回目のビルド（キャッシュあり、変更なし）
time docker build -t myapp:test2 .

# 3回目のビルド（ソースコードのみ変更）
echo "// change" >> src/index.js
time docker build -t myapp:test3 .