はじめてのコンテナを、
起動して観察する

手順に迷ったときや、用語の意味を確かめたいときに開きましょう。

※ Docker社の公式ドキュメント（英語）です。リンク切れの場合は、ページタイトルで検索してください。

「取得する」→「起動する」→「観察する」→「片付ける」という、コンテナ操作の基本サイクルを体験します。

以下の要件を満たし、コンテナの基本操作を体験してください。

「Docker Desktopを準備する」→「イメージを取得して起動する」→「状態を観察する」→「停止・削除する」という順番で進めます。

1. フェーズ1 — Docker Desktopを準備する

2. Docker Desktopをインストールし、起動する

   お使いのパソコンにDocker Desktopをインストールし、起動します。起動が完了したら、ターミナル（PowerShellなど）を開き、次のコマンドでバージョンが表示されることを確認します。

   docker --version

3. フェーズ2 — イメージを取得して起動する

4. 公開イメージ（nginx）を取得する

   次のコマンドで、Webサーバーの公開イメージを取得します。

   docker pull nginx

5. コンテナを起動する

   取得したイメージから、名前を付けてコンテナを起動します。パソコンの8080番ポートを、コンテナの80番ポートにつなぎます。

   docker run --name my-first-nginx -d -p 8080:80 nginx

   ブラウザで http://localhost:8080 を開き、「Welcome to nginx!」のページが表示されることを確認します。

6. フェーズ3 — 状態を観察する

7. 起動中のコンテナを確認する

   docker ps

   一覧に my-first-nginx が表示され、ステータスが起動中になっていることを確認します。

8. ログを確認する

   docker logs my-first-nginx

   ブラウザでアクセスした際のリクエストの記録が、ログに残っていることを確認します。

   ブラウザをもう一度開いてみる

   ログを確認した後にブラウザで再度アクセスし、もう一度 docker logs を実行すると、新しい行が追加されていることが分かります。

9. フェーズ4 — 停止・削除する

10. コンテナを停止し、削除する

    docker stop my-first-nginx
    docker rm my-first-nginx

    停止と削除を分けて実行している点に注目してください。停止だけでは、コンテナは一覧（docker ps -a）に残ったままです。

    これがゴール

    docker ps -a を実行し、my-first-nginx が一覧から消えていることを確認できたら、このハンズオンの目的は達成です。

初学者がよく引っかかる箇所を先回りでまとめました。答えそのものは載せていませんが、「どこを見直すか」の手がかりとして使ってください。

要件の再確認ではなく、画面・ターミナルのどこを見れば達成を確認できるかをまとめました。次を順に確かめましょう。

• docker --version でバージョン番号が表示される。
• ブラウザで http://localhost:8080 を開くと、nginxの既定ページが表示される。
• docker ps の一覧に、起動中のコンテナ名が表示される。
• docker logs の出力に、ブラウザからのアクセス記録が表示される。
• docker rm 実行後、docker ps -a の一覧からコンテナが消えている。

手を動かすことに加えて、次の問いに自分の言葉で答えられるようにしておくと、理解がより深まります。

1. 同じイメージから、もう1つコンテナを同時に起動しようとすると、何が起きるでしょうか。
   ヒント

   コンテナ名やポート番号を今回と同じ値のまま指定した場合、何と何が重複してしまうか考えてみましょう。
2. コンテナの「停止」と「削除」を、わざわざ別の操作にしているのはなぜでしょうか。
   ヒント

   一時的に止めておいて後で同じ状態から再開したい場合と、完全に消してしまいたい場合、それぞれの場面を想像してみましょう。
3. 「同じイメージなら、どのパソコンでも同じように動く」と言われるのはなぜでしょうか。
   ヒント

   イメージの中に何が含まれているか（アプリケーション本体だけか、それ以外も含むか）という観点で考えてみましょう。

本編の中で削除し忘れたものがあれば、ここで確認します。

1. コンテナを削除する：本編のフェーズ4で削除済みの場合は不要です。docker ps -a で残っていないか確認してください。
2. 不要であればイメージも削除する：今後使わない場合は、docker rmi nginx で取得したイメージを削除できます。
3. Docker Desktopについて：次のハンズオンでも使うため、終了せずそのままにしておいて構いません。