新しく登場するDockerfileの命令

RUNは、Dockerイメージを作成(ビルド)する段階で実行したいコマンドを指定するための命令です。

1. RUN

RUNは、Dockerイメージを作成(ビルド)する段階で実行したいコマンドを指定するための命令です。

RUN touch test.txt

この記述は、イメージを作成する途中で touch test.txt というコマンドを実行し、test.txt という空のファイルを作成することを意味しています。

その他にも、アプリケーションに必要なツールをインストールしたり、フォルダ構成を整えたりする際によく使用されます。

1.1 CMDとの違い

RUNとCMDはどちらもコマンドを実行する命令ですが、その実行されるタイミングが明確に異なります。

RUNは「イメージを作る時(ビルド時)」に実行されます。一方でCMDは「コンテナが動く時(起動時)」に実行されます。

つまり、コンテナを実行する前処理として事前に実行されるのがRUNで、実際にコンテナを起動するときに実行されるのがCMDです。

また、RUNは実行したい処理の数だけ何度でも記述して積み重ねることができますが、CMDは「起動時に実行するデフォルトのコマンド」という性質上、原則としてDockerfileの最後に1つだけ記述するという点も大きな違いです。

2. WORKDIR

WORKDIRは、コンテナ内でコマンドを実行する際の「作業場所(カレントディレクトリ)」を指定するための命令です。Linuxコマンドの cd(ディレクトリ移動)と同じような役割を果たします。

WORKDIR /app

この記述を行うと、これ以降に記述された RUN、COPY、CMD などの命令は、すべてここで指定されたディレクトリ(例:/app)を起点として実行されるようになります。

この命令を使用することで、Dockerfileの記述がシンプルになるというメリットがあります。例えば COPY . . のように記述した際、コピー先が自動的に WORKDIR で指定した場所になるため、毎回 /app/index.html のように長いパスを書く必要がなくなります。

また、指定したディレクトリがコンテナ内に存在しない場合、Dockerが自動的にフォルダを作成してくれるため、事前に mkdir コマンドなどでフォルダを用意しておく必要もありません。

WORKDIR /app
COPY . .

上記のような記述の場合、ホスト側のすべてのファイルは、コンテナ内の /app ディレクトリの中にコピーされることになります。

3. EXPOSE

EXPOSEは、コンテナが実行時に「どのポート番号で通信を待ち受けるか」をDockerに知らせるための命令です。

EXPOSE 8080

この記述は、このコンテナ内のアプリケーションが8080番ポートを使用することを宣言しています。 これにより、Dockerfileを読む人や、このイメージを使用するユーザに対して「このコンテナを使うときは、8080番ポートを開けてくださいね」という意図を伝える(ドキュメント化する)役割があります。

ただし、非常に重要な注意点があります。EXPOSEと書いただけでは、実際に自分のPC(ホスト)からアクセスできるようにはなりません。 あくまで「ポート番号の宣言」としての意味合いが強いため、実際にアクセス可能にするには、コンテナ起動時に -p オプションを使ってポートを繋ぐ必要があります。

なぜ前回のハンズオン(Nginx)では書かなかったのか? 前回のハンズオンで作成したDockerfileには EXPOSE を記述しませんでしたが、それでも正常に動作しました。これには理由があります。

それは、ベースイメージとして使用した nginx:alpine の中に、すでに EXPOSE 80 が記述されていたからです。

Dockerでは、FROM で指定したベースイメージの設定の多くを引き継ぐことができます。Nginxの公式イメージ側ですでに「80番ポートを使います」という宣言がなされていたため、私たちが改めて書く必要はなかったのです。

自分でゼロからアプリケーションを作る場合(GoやNode.jsなどでアプリケーションを開発する場合など)は、この EXPOSE を記述して、どのポートを使うかを明示するのがベストプラクティスとなります。

4. まとめ(命令一覧)

最後に、今回登場したDockerfileの新しい記載方法を下記表にまとめておきます。

命令 説明
RUN <コマンド> イメージビルド時にコマンドを実行
WORKDIR <パス> 作業ディレクトリを指定
EXPOSE <ポート番号> コンテナが使用するポートを宣言