ハンズオン:Dockerの基本サイクルの体験

ここでは、Dockerの導入から、最も基本的な「Hello World」コンテナの実行方法をハンズオン形式で解説します。実際に操作してみながら、Dockerの基本操作を理解していきましょう。

1. イメージの取得 (pull)

コンテナを作成するための「設計図」であるイメージを、Docker Hubから手元のPCにダウンロードします。今回は hello-world という練習用の軽量イメージを使用します。これは、Docker公式が用意している、練習用に最適な、シンプルな文字列を出力するためのイメージです。

これから実行するコマンドは、Windowsであればコマンドプロンプト、Macであればターミナルを開き、そこで実行していきます。

docker image pull hello-world

成功すると、以下のような正常終了を表すメッセージが表示されます。

latest: Pulling from library/hello-world
198f93fd5094: Pull complete
Digest: sha256:d4aaab6242e0cace87e2ec17a2ed3d779d18fbfd03042ea58f2995626396a274
Status: Downloaded newer image for hello-world:latest
docker.io/library/hello-world:latest
⚠️ 「Cannot connect to the Docker daemon」エラーが出る場合
このエラーは、Docker Desktopが起動していない場合に発生します。以下の手順でDocker Desktopを起動してください。

Windowsの場合
スタートメニューから「Docker Desktop」を検索して起動します。タスクバー右下の通知領域にDockerのアイコン(クジラのマーク)が表示され、「Docker Desktop is running」と表示されれば起動完了です。

Macの場合
Launchpadまたはアプリケーションフォルダから「Docker」を起動します。メニューバーにDockerのアイコン(クジラのマーク)が表示され、「Docker Desktop is running」と表示されれば起動完了です。

起動完了後、再度コマンドを実行してください。

2. イメージの確認 (ls)

ダウンロードが正常に完了したか確認します。PC内に保存されているイメージの一覧を表示します。

docker image ls

REPOSITORY の列に hello-world が表示されていれば、準備完了です。

REPOSITORY    TAG       IMAGE ID       CREATED        SIZE
hello-world   latest    ca9905c726f0   5 months ago   5.2kB

3. コンテナの起動 (run)

取得したイメージをもとにして、コンテナを作成・起動します。

docker container run --name my-container hello-world

画面に「Hello from Docker!」というメッセージが表示されれば成功です。これは、コンテナが正しく起動し、メッセージを表示する処理を実行したことを意味します。

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (arm64v8)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

4. コンテナの状態確認 (ls / ls --all)

現在動いているコンテナを確認してみましょう。

docker container ls

おそらく、何も表示されないはずです(またはヘッダー行のみ)。 これは、hello-world コンテナが「メッセージを表示する」という役目を終えて、すでに停止しているためです。

💡 ポイント
「コンテナが勝手に止まってしまった」と驚くかもしれませんが、これは正常な動作です。コンテナは「実行すべき処理」が完了すると自動的に終了します。Webサーバのように常に待ち受ける必要があるコンテナは起動し続けますが、今回のhello-worldのような「メッセージを表示して終わり」のコンテナは、処理が終わると停止します。

停止しているコンテナも含めて確認するには、--all(または -a)オプションを使用します。

docker container ls -a

こちらを実行すると、先ほどのコンテナが表示され、STATUSが Exited(終了)になっていることが確認できます。

CONTAINER ID   IMAGE         COMMAND    CREATED              STATUS                          PORTS     NAMES
b04638fff44a   hello-world   "/hello"   About a minute ago   Exited (0) About a minute ago             my-container

5. 不要リソースの削除

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

5.1 コンテナの削除

役割を終えた不要なコンテナを削除します。以下のコマンドで、コンテナの削除を行います。

docker container rm my-container
⚠️ 「unable to remove container ... is running」エラーが出る場合
コンテナがまだ起動中のため削除できません。docker container stop my-containerで先にコンテナを停止してから、削除コマンドを実行してください。
ただし、本章で使用するhello-worldのイメージは、起動後にすぐに停止されるため、通常はこのエラーは発生しません。

削除できたか確認してみましょう。

docker container ls -a

一覧から消えていれば、コンテナの削除は完了です。

5.2 イメージの削除

最後に、練習に使った hello-world のイメージ(設計図)自体もPCから削除します。

docker image rm hello-world

完全に削除されたか確認します。

docker image ls

一覧に hello-world が表示されなくなっていれば、すべての手順は完了です。