Dockerfileの基本文法
基本的なDockerfileの文法を説明します。
1. FROM
FROMは、Dockerfileの先頭に記載するもので、新しく作成するイメージの土台(ベース)となるイメージを指定するためのものです。
FROM nginx
この記述は、nginxという既存のイメージをベースにして、そこから新しいイメージの作成を始めることを意味しています。
また、イメージ名の後に「タグ」をつけることで、使用するバージョンやOSの種類を細かく指定することもできます。
FROM nginx:alpine
コロン(:)の後ろにあるalpineがタグにあたります。このように記述することで、「nginxイメージの中でも、軽量なalpine版を使いたい」といった具体的な指定が可能になり、意図しないバージョンの変更を防ぐことができます。なお、タグを省略した場合は、自動的に最新版(latest)が使用されます。
FROM命令には他にもマルチステージビルドなどで使用する機能がありますが、今後のハンズオンで必要になった段階で説明します。
実際にどのようなベースイメージが利用可能かは、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 ["コマンド", "引数"] |
コンテナ起動時に実行するコマンドを指定 |