Dockerfileの基本文法

基本的なDockerfileの文法を説明します。

1. FROM

FROMは、Dockerfileの先頭に記載するもので、新しく作成するイメージの土台(ベース)となるイメージを指定するためのものです。

FROM nginx

この記述は、nginxという既存のイメージをベースにして、そこから新しいイメージの作成を始めることを意味しています。

また、イメージ名の後に「タグ」をつけることで、使用するバージョンやOSの種類を細かく指定することもできます。

FROM nginx:alpine

コロン(:)の後ろにあるalpineがタグにあたります。このように記述することで、「nginxイメージの中でも、軽量なalpine版を使いたい」といった具体的な指定が可能になり、意図しないバージョンの変更を防ぐことができます。なお、タグを省略した場合は、自動的に最新版(latest)が使用されます。

FROM命令には他にもマルチステージビルドなどで使用する機能がありますが、今後のハンズオンで必要になった段階で説明します。

実際にどのようなベースイメージが利用可能かは、Docker Hubの公式サイトから確認することができます。 ただし、公開されているイメージは膨大であり、すべてのベースイメージを事前に把握しておくことは困難です。そのため、まずはハンズオンなどを通じて「自分がよく使う代表的なベースイメージ」をいくつか押さえておき、新しい環境が必要になったタイミングで随時調べていく、というスタンスで進めていけば問題ありません。

Docker Hub

良く使われるベースイメージの一覧を以下に記載しておきます。

イメージ名 説明 主な用途
alpine 軽量Linux(約5MB) 最小構成のコンテナ、軽量化が必要な場面
ubuntu 汎用Linux 開発環境、多くのパッケージが必要な場面
debian 安定性重視のLinux 本番環境、長期運用
node Node.js実行環境 JavaScriptアプリケーション
python Python実行環境 Pythonアプリケーション、機械学習
golang Go言語実行環境 Goアプリケーション
nginx Webサーバ 静的サイト配信、リバースプロキシ
httpd Apache Webサーバ Webサイト配信
postgres PostgreSQLデータベース リレーショナルDB
mysql MySQLデータベース リレーショナルDB
redis インメモリデータストア キャッシュ、セッション管理

多くのイメージにはalpineタグ(例:node:alpine、python:alpine)が用意されており、軽量版として利用できます。

2. COPY

COPYは、自分のPC(ホスト)にあるファイルやフォルダを、コンテナの中に配置するための命令です。

COPY index.html /usr/share/nginx/html/

この記述は、PC上の同じフォルダにあるindex.htmlというファイルを、コンテナ内の/usr/share/nginx/html/というディレクトリの中にコピーすることを意味しています。Webサーバに表示させたいHTMLファイルや、アプリケーションのソースコードをコンテナに取り込む際によく使用されます。

また、特定のファイルだけでなく、フォルダ内のすべてのファイルをまとめてコピーすることも可能です。

COPY . .

この記述は、「現在のディレクトリにあるすべてのファイル(一つ目のドット)」を、「コンテナ内の作業ディレクトリ(二つ目のドット)」にコピーする、という指定になります。開発したソースコード一式をコンテナに持ち込む際などに頻繁に使用される書き方です。

3. CMD

CMDは、コンテナが起動したタイミングで実行される「デフォルトのコマンド」を指定するための命令です。

CMD ["echo", "Hello, Docker!"]

この記述は、コンテナが立ち上がった瞬間に echo という「文字を出力するコマンド」を実行することを意味しています。

コマンドや引数(ひきすう)はカンマ区切りで指定しますが、実際に実行されるコマンドは echo "Hello, Docker!" となります。

このように、CMD命令を使うことで、コンテナ起動時に「何をさせたいか」を定義することができます。Webサーバであればサーバの起動コマンドを、バッチ処理であればその実行コマンドを記述します。

良く使われるCMDの記載例をいくつか提示します。

用途 CMD 説明
Nginx CMD ["nginx", "-g", "daemon off;"] Webサーバをフォアグラウンドで起動
Node.js CMD ["node", "app.js"] Node.jsアプリケーションを起動
Python CMD ["python", "app.py"] Pythonスクリプトを実行
Go CMD ["./main"] Goのビルド済みバイナリを実行
Java CMD ["java", "-jar", "app.jar"] Javaアプリケーションを起動
npm CMD ["npm", "start"] package.jsonのstartスクリプトを実行
Shell CMD ["/bin/sh"] シェルを起動(デバッグ用)

4. まとめ(命令一覧)

今回使用したdockerfileの記載を下記にまとめておきます。

命令 説明
FROM <イメージ名> ベースイメージを指定
COPY <ホスト> <コンテナ> ファイルをコンテナにコピー
CMD ["コマンド", "引数"] コンテナ起動時に実行するコマンドを指定