COPY failed: file not found in build context

1
2
3
4
5
6
7
8

# NG: ファイルが存在しないパス
COPY app.js /app/

# ファイル構造:
# project/
# ├── Dockerfile
# └── src/
#     └── app.js  ← src/app.js が正しい

1
2

# NG: 親ディレクトリのファイルはコピーできない
COPY ../config.json /app/

1
2
3
4
5
6
7
8
9

# NG: 間違ったディレクトリでビルド
docker build -t myapp .

# ファイル構造:
# project/
# ├── docker/
# │   └── Dockerfile
# └── src/
#     └── app.js

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# プロジェクト構造:
# project/
# ├── Dockerfile
# └── src/
#     └── app.js

# OK: 正しい相対パス
COPY src/app.js /app/

# OK: ディレクトリごとコピー
COPY src/ /app/

1
2
3
4
5
6

# Dockerfileの場所を明示
docker build -f docker/Dockerfile -t myapp .

# または、プロジェクトルートからビルド
cd /path/to/project
docker build -t myapp .

1
2
3
4
5

# NG: 絶対パスはコンテキスト外
COPY /home/user/project/app.js /app/

# OK: コンテキストからの相対パス
COPY app.js /app/

1
2
3
4
5

# ビルドコンテキストに含まれるファイルを確認
tar -cvf - . | tar -tvf - | head -50

# .dockerignoreを考慮したファイル一覧
docker build --no-cache -t test . 2>&1 | grep "Sending build context"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# ビルドステージ
FROM node:18 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY src/ ./src/
RUN npm run build

# 実行ステージ
FROM node:18-slim
WORKDIR /app
# ビルドステージからコピー（コンテキストではなく前ステージから）
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules

1
2
3
4
5
6
7
8

# ファイルが存在しない場合に備える
# ワイルドカードで存在する場合のみコピー
COPY package*.json ./
COPY tsconfig*.json ./

# または、デフォルトファイルを用意
COPY config.json* ./
RUN if [ ! -f config.json ]; then echo '{}' > config.json; fi

1
2
3
4
5

# .dockerignoreの効果を確認
# 一時的に.dockerignoreを無効化
mv .dockerignore .dockerignore.bak
docker build -t test .
mv .dockerignore.bak .dockerignore

1
2
3
4
5
6
7

# docker-compose.yml
version: '3'
services:
  app:
    build:
      context: .           # ビルドコンテキスト
      dockerfile: docker/Dockerfile  # Dockerfileの場所

1
2
3

# docker/Dockerfile
# コンテキストは docker-compose.yml のある場所
COPY src/ /app/src/  # プロジェクトルートからの相対パス

1
2
3
4
5
6
7
8

# COPY: ローカルファイルのコピーのみ
COPY ./src /app/src

# ADD: URL からのダウンロードや tar の自動展開もサポート
ADD https://example.com/file.tar.gz /app/
ADD archive.tar.gz /app/  # 自動展開される

# 推奨: 単純なコピーには COPY を使用