Dockerfileの書き方入門｜自分のアプリをイメージ化する基礎と注意点

この記事のポイント

・FROM・RUN・COPY・CMD の4命令を押さえれば最初のDockerfileは書ける
・RUN命令は&&でつなぎ1レイヤーにまとめるとイメージが小さくなる
・.dockerignore でビルドコンテキストを絞るのが速度改善の第一歩
・エラーの9割は「ファイルパスの指定ミス」か「キャッシュの古さ」が原因

# 命令 引数
INSTRUCTION arguments

FROM ubuntu:24.04
# または
FROM python:3.12-slim
# または
FROM node:20-alpine

# NG：RUNを3行に分けると3つのレイヤーができる
RUN apt-get update
RUN apt-get install -y python3
RUN apt-get clean

# OK：&&でつなぎ1つのRUNにまとめる（レイヤーを削減）
RUN apt-get update \
    && apt-get install -y python3 \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

# ローカルの app.py をイメージ内の /app/app.py にコピー
COPY app.py /app/app.py

# カレントディレクトリ全体を /app にコピー
COPY . /app/

WORKDIR /app
# 以降の COPY や RUN は /app を起点に実行される
COPY . .
RUN pip install -r requirements.txt

ENV APP_ENV=production
ENV PORT=8080

EXPOSE 8080

# exec 形式（推奨）
CMD ["python3", "app.py"]

# shell 形式（シェル展開が必要な場合のみ）
CMD python3 app.py

myapp/
├── Dockerfile
├── .dockerignore
├── requirements.txt
└── app.py

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello from Docker!'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080)

flask==3.0.3

# ベースイメージ：Python 3.12 スリム版（Debian Bookworm ベース）
FROM python:3.12-slim

# 作業ディレクトリを /app に設定
WORKDIR /app

# 依存ライブラリをインストール（キャッシュ活用のため先にコピー）
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# アプリのソースコードをコピー
COPY app.py .

# コンテナが使用するポートを宣言
EXPOSE 8080

# コンテナ起動時のコマンド
CMD ["python3", "app.py"]

__pycache__
*.pyc
*.pyo
.git
.env
*.log

# イメージをビルド（-t でタグ名を付ける、最後の . がビルドコンテキスト）
docker build -t myapp:1.0 .

# 実行確認（-p でホストのポートとコンテナのポートをマッピング）
docker run --rm -p 8080:8080 myapp:1.0

[+] Building 12.3s (9/9) FINISHED
 => [internal] load build definition from Dockerfile
 => [internal] load .dockerignore
 => [internal] load metadata for docker.io/library/python:3.12-slim
 => [1/4] FROM docker.io/library/python:3.12-slim
 => [2/4] WORKDIR /app
 => [3/4] COPY requirements.txt .
 => [4/4] RUN pip install --no-cache-dir -r requirements.txt
 => exporting to image
 => => writing image sha256:a3f7...
 => => naming to docker.io/library/myapp:1.0

# NG：クリーンアップしても前のレイヤーにキャッシュが残る
RUN apt-get update && apt-get install -y curl
RUN apt-get clean && rm -rf /var/lib/apt/lists/*

# OK：同一 RUN 命令内でインストール＆クリーンアップ
RUN apt-get update \
    && apt-get install -y curl \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

# 推奨順序：依存ファイルを先にコピーして pip install
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 依存が変わらない限り上記はキャッシュが使われる
# ソースコードは最後にコピー
COPY app.py .

# 専用ユーザーを作成してアプリを実行
RUN useradd -m appuser
USER appuser
CMD ["python3", "app.py"]

# ステージ1：ビルド
FROM golang:1.22 AS builder
WORKDIR /src
COPY . .
RUN go build -o app .

# ステージ2：実行（最小イメージ）
FROM gcr.io/distroless/base-debian12
COPY --from=builder /src/app /app
CMD ["/app"]

# エラーメッセージ例
COPY failed: file not found in build context or excluded by .dockerignore: stat requirements.txt

# Dockerfile があるディレクトリで実行する（最後の . = ビルドコンテキスト）
cd myapp/
docker build -t myapp:1.0 .

# エラーメッセージ例
#6 4.321 E: Unable to locate package xxx

# キャッシュを無効化してビルド
docker build --no-cache -t myapp:1.0 .

# -p ホストポート:コンテナポート を正しく指定する
docker run --rm -p 8080:8080 myapp:1.0

# アプリ側も 0.0.0.0 でリッスンさせる（Flask の例）
app.run(host='0.0.0.0', port=8080)

# 起動中のコンテナへ入る
docker exec -it <コンテナID> /bin/bash

# コンテナ内でポートリッスン状態を確認
ss -tlnp

# COPY と同時に所有者を指定する（Docker 17.09+）
COPY --chown=appuser:appuser . /app/