Dockerfileの基本的な書き方

やりたかったこと

Node.jsのアプリをDockerコンテナで動かそうとした。最初は docker run node:18 でコンテナを起動してアプリを手動で入れていたが、毎回同じ手順を繰り返すのが面倒になってきた。Dockerfileを書けば同じ環境を一発で再現できると聞いて試してみた。

最初、こんな書き方をした。

FROM node:22
COPY . .
RUN npm install
CMD ["node", "server.js"]

ビルドは通ったが、毎回 npm install のキャッシュが効かずに全パッケージをダウンロードし直していた。2分近くかかっていて、コードを1行直すたびに待ち続けた。

次に node_modules もまるごとCOPYしてビルドしていたが、ホストとコンテナでCPUアーキテクチャが違うせいでバイナリが壊れて起動エラーになった。

Error: /app/node_modules/bcrypt/lib/binding/napi-v3/bcrypt_lib.node: invalid ELF header

.dockerignore を知らなかったのが原因だった。

package*.json だけを先にCOPYして npm ci を実行する。こうするとpackage.jsonが変わらない限りこのレイヤーのキャッシュが使い回されてビルドが速くなった。

FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["node", "server.js"]

.dockerignore も必ず作る。これがないとホスト側の node_modules がコンテナにコピーされてイメージが数GB単位で膨れ上がる。

node_modules
dist
.env
.git
*.log

ビルドして起動するコマンド:

docker build -t myapp .
docker run -d -p 3000:3000 myapp

これで起動した。

COPY package*.json ./ を COPY . . より先に書かないとキャッシュが全く効かない。ちょっとしたコード修正のたびに npm ci が走って3分待ちになった
.dockerignore なしでビルドすると node_modules（700MB超）がイメージに入る。 docker images で確認したら1.8GBになっていて驚いた
RUN npm install より RUN npm ci のほうがCI/CDでは安定する。package-lock.json がないと npm ci はエラーになるのでlockファイルは必ずコミットしておく
WORKDIR /app を省略すると / 直下にファイルが散らばってあとで管理しにくくなった
CMD と ENTRYPOINT の違いで1時間ハマった。CMD は上書き可能、ENTRYPOINT は固定と覚えた