シンプルなDockerfileの実行
シンプルなDockerfileを作成し、イメージの作成およびコンテナの起動を行うハンズオンを実施します。
本章では、シンプルなHTMLファイルを作成し、それをNginxのサーバで動かすためのDockerfileを作成し、コンテナとして実行していきます。
1. Visual Studio Codeのインストール
Dockerfileを記載するために、テキストエディタが必要となります。今回のハンズオンでは、Visual Studio Codeを用いて、Dockerfileを作成していきます。
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にアクセスしてください。
「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