シンプルなDockerfileの実行

シンプルなDockerfileを作成し、イメージの作成およびコンテナの起動を行うハンズオンを実施します。

本章では、シンプルなHTMLファイルを作成し、それをNginxのサーバで動かすためのDockerfileを作成し、コンテナとして実行していきます。

1. Visual Studio Codeのインストール

Dockerfileを記載するために、テキストエディタが必要となります。今回のハンズオンでは、Visual Studio Codeを用いて、Dockerfileを作成していきます。

Visual Studio Codeがまだインストールされていない場合、下記のサイトよりインストールをお願いします。

Visual Studio Code

2. Dockerfileの用意

基本命令を使った実際のDockerfileを見ていきます。

まず、任意の場所に作業用のフォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成したフォルダを開きます。

任意のフォルダ  ← このフォルダを作成

Dockerfileを作成します。Visual Studio Codeのエクスプローラーでフォルダを右クリックし、「新しいファイル」を選択してDockerfileという名前で作成してください。

任意のフォルダ
└── Dockerfile  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。

FROM nginx:alpine

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

CMD ["nginx", "-g", "daemon off;"]

このDockerfileは、ローカル環境にあるindex.htmlを用いて、NginxでWebサーバを起動し、Webサイトとして表示させるためのものです。

FROM nginx:alpine

まずはこの部分で、ベースイメージとしてnginx:alpineというイメージを使用します。これは、alpineという軽量なOSに、サーバソフトウェアであるNginxを事前にインストールしたベースイメージです。

📝 alpineとは
alpineは、最低限の機能に抑えたシンプルなLinux OSで、コンテナの実行によく使われるOSです。OSは用途に応じて軽量に実行できることが理想なため、軽量OSであるalpineと相性が良いです。
COPY index.html /usr/share/nginx/html/index.html

これは、ローカル環境にあるindex.htmlというファイルを、/usr/share/nginx/html/index.htmlという名前でコンテナの中にコピーするコマンドです。

なお、/usr/share/nginx/html/index.htmlは、Nginxにおいて「デフォルトで表示されるHTMLファイル」を表すファイルです。

CMD ["nginx", "-g", "daemon off;"]

この記述は、コンテナが立ち上がった瞬間に nginx -g daemon off; というWebサーバのプログラムを実行することを意味しています。

ここで使用している -g は、Nginxの設定ファイルに記述するような設定内容を、コマンドラインから直接渡すためのオプションです。今回はこれを使ってdaemon off;という設定を直接効かせ、Dockerコンテナがすぐに終了してしまわないように制御しています。

このあたりはNginxの仕様となるため、今回は深く把握する必要はありません。「Nginxで起動したサーバがすぐに終了しないようにするために必要なもの」という程度の理解で構いません。

3. index.htmlの用意

続いて、Dockerの中で使用するindex.htmlファイルを用意します。Visual Studio Codeのエクスプローラーでフォルダを右クリックし、「新しいファイル」を選択してindex.htmlという名前で作成してください。

任意のフォルダ
├── Dockerfile
└── index.html  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Docker Hands-on</title>
</head>
<body>
    <h1>hello Docker!</h1>
</body>
</html>

4. イメージの作成

Visual Studio Codeのメニューから「ターミナル」→「新しいターミナル」を選択すると、下の方にターミナルが表示されます。ここでコマンドを実行していきます。

DockerfileからDockerイメージを作成(ビルド)します。

docker image build --tag my-image .

コマンドの最後の .(ドット)は、「現在のディレクトリにあるDockerfileを使用する」という意味の重要な記述です。--tag でイメージに my-image という名前を付けています。

作成されたイメージを確認します。

docker image ls

リストに my-image が表示されていれば作成成功です。

REPOSITORY     TAG       IMAGE ID       CREATED          SIZE
my-image       latest    42f30c30f2b0   10 seconds ago   61.2MB
⚠️ 「COPY failed: file not found」エラーが出る場合
Dockerfileと同じディレクトリにindex.htmlファイルが存在しないか、ファイル名が間違っています。lsコマンドでファイルが存在することを確認し、ファイル名のスペルミス(大文字小文字を含む)がないか確認してください。
⚠️ 「no such file or directory」エラーが出る場合
コマンドを実行しているディレクトリが正しくない可能性があります。cdコマンドでDockerfileがあるディレクトリに移動してから、再度docker image buildを実行してください。末尾の.(ドット)を忘れないように注意してください。

5. コンテナの起動

作成したイメージからコンテナを起動します。

docker container run -d -p 8080:80 --name first-container my-image
オプション 値 設定の基準
-d - ターミナルを占有せずにバックグラウンドで実行するため
-p 8080:80 PCの8080番ポートへのアクセスをコンテナの80番ポートへ転送するため
--name first-container コンテナを識別しやすい名前で管理するため

コンテナが起動しているか確認します。

docker container ls

以下のように、first-containerが表示され、STATUSが Up になっていれば起動しています。

CONTAINER ID   IMAGE      COMMAND                  CREATED          STATUS          PORTS                  NAMES
9fde109a11e5   my-image   "/docker-entrypoint.…"   39 seconds ago   Up 38 seconds   0.0.0.0:8080->80/tcp   first-container
⚠️ 「port is already allocated」エラーが出る場合
指定したポート(8080番)が既に他のアプリケーションやコンテナで使用されています。docker container lsで既存のコンテナを確認し、不要であれば停止・削除してください。または、-p 8888:80のように別のポートを指定して起動し直してください。

6. 動作確認

ブラウザを開き、以下のURLにアクセスしてください。

http://localhost:8080

「Hello Docker!」というメッセージが表示されていれば、動作確認は成功です。

⚠️ ブラウザでアクセスできない場合
(1) コンテナが正常に起動しているかdocker container lsで確認してください。STATUSがUpになっていることを確認します。
(2) 別のアプリケーションが8080番ポートを使用している可能性があります。その場合は-p 8888:80のように別のポートを指定して起動し直してください。

7. 不要リソースの削除

ハンズオンが終わったら、作成したリソースを削除(お片付け)します。

7.1 コンテナの停止

まずは動いているコンテナを停止します。

docker container stop first-container

停止したことを確認します。

docker container ls -a

ステータスがExitedとなっていれば、無事に停止しています(プロセスが終了しています)。

CONTAINER ID   IMAGE      COMMAND                  CREATED         STATUS                     PORTS     NAMES
9fde109a11e5   my-image   "/docker-entrypoint.…"   5 minutes ago   Exited (0) 6 seconds ago             first-container

7.2 コンテナの削除

停止したコンテナを完全に削除します。

docker container rm first-container

コンテナの一覧に表示されなくなれば、無事に削除されています。

docker container ls -a

7.3 イメージの削除

最後に、作成したイメージも削除します。

docker image rm my-image

イメージの一覧に表示されなくなれば、無事削除されています。

docker image ls