はじめに
こんにちは。株式会社ジールの@yszdhです。
この記事では、Docker CLIでnginxコンテナを起動し、その結果をDocker Desktopで確認します。
CLIの操作結果がDocker Desktop上でどう見えるかに注目して進めます。
この記事でやることは次のとおりです。
- Docker Hubからnginxイメージを取得する
- nginxコンテナを起動する
- Docker Desktopでイメージとコンテナの状態を確認する
- ブラウザで
http://localhost:8080を開いて表示を確認する - コンテナを停止・削除する
※この記事では、Ubuntu環境のターミナルを開き、そこでDocker CLIを実行します。
環境設定につきましては以下の記事を参考にしてください
Docker Hub とは？
Docker Hub は、Docker イメージを検索・ダウンロード・公開できるサービスです。
Docker CLI のdocker pullコマンドは、この Docker Hub からイメージを取得します。
この記事では、Docker Hubに公開されているnginxの公式イメージを使います。
公式イメージは、Docker公式やプロジェクトの管理者によって提供されているため、学習用途でも扱いやすいです。
全体の流れ
- UbuntuターミナルからDockerが使えることを確認
-
nginxイメージを取得 - Docker Desktop の Imagesで確認
- コンテナを起動
- Docker DesktopのContainersで確認
-
docker psで状態を確認 - ブラウザで動作確認
- コンテナを停止・削除
下記記事の手順を参考にしています
Step 1: UbuntuターミナルからDockerが使えることを確認
まず、Docker CLI が使えることと、Docker Engineに接続できることを確認します。
docker version
バージョン情報が表示されれば OK です。
Client: Docker Engine - Community
Version: 29.5.0
...
Server: Docker Engine - Community
Engine:
Version: 29.5.0
...
Step 2: Docker Hubからnginxイメージを取得する
まず、nginxイメージをDocker Hubから取得します。
docker pull nginx
実行すると、次のように表示されます。
Using default tag: latest
latest: Pulling from library/nginx
Status: Downloaded newer image for nginx:latest
docker.io/library/nginx:latest
latestはイメージのタグです。
docker pull nginxのようにタグを省略した場合、nginx:latestを指定したものとして扱われます。
Docker Desktop での見え方
docker pull nginx を実行したあと、Docker Desktop の Imagesタブを開くと、nginxイメージが表示されます。
Step 3: nginxコンテナを起動する
取得したnginxイメージをもとに、コンテナを新しく作成して起動します。
docker runは、単に起動するだけではなく、イメージからコンテナの実体を作るコマンドです。
ここでは、コンテナ内でnginxが待ち受ける80番ポートを、ホスト側の8080番ポートに公開します。
これにより、ブラウザからhttp://localhost:8080 へアクセスすると、コンテナ内のnginxに到達できます。
docker run -d -p 8080:80 --name test-nginx nginx
コマンドの意味
| 部分 | 意味 |
|---|---|
docker run |
イメージから新しいコンテナを作成して起動する |
-d |
バックグラウンドで起動する |
-p 8080:80 |
ホストの 8080 番ポートを、コンテナの 80 番ポートに接続する |
--name test-nginx |
コンテナに名前をつける |
nginx |
使用するイメージ名 |
-dについて
--detachの略であり、コンテナをバックグラウンドで起動するオプションです。
バックグラウンドで実行すると、docker run の実行後もターミナルが占有されず、続けて docker ps で状態を確認したり、ブラウザで動作確認をしたりできます。
反対に -d を付けない場合、コンテナのログがターミナルに表示され続け、端末がそのコンテナの操作に使われる状態になります。
今回のように、起動後に別の操作を続けたい場合は -d を付けるのが適しています。
Docker Desktop での見え方
docker run を実行したあと、Docker DesktopのContainersタブを開くと、test-nginx というコンテナが表示されます。
ステータスが Running になっていれば起動成功です。
ポートマッピングのイメージ
http://localhost:8080 → コンテナ内の nginx（80番ポート）
左側の 8080 は、ブラウザからアクセスするホスト側のポートです。
右側の 80 は、nginx が待ち受けているコンテナ側のポートです。
左側の番号は自由に変えられます。たとえば -p 3000:80 にすると、http://localhost:3000 でアクセスできます。
Step 4: docker ps で起動状態を確認する
コンテナが起動しているかを CLI で確認します。
docker ps
次のように test-nginx が表示されれば起動中です。
出力例：
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
xxxxxxxxxxxx nginx "/docker-entrypoint.…" 1 minute ago Up 1 minute 0.0.0.0:8080->80/tcp test-nginx
PORTS列に0.0.0.0:8080->80/tcp、NAMES列にtest-nginxと表示されていれば、
ホストの8080番ポートがコンテナの80番ポートに割り当てられていることを確認できます
Step 5: ブラウザで動作確認する
ブラウザで http://localhost:8080 を開きます。
Welcome to nginx! と表示されれば成功です。
この表示が出るということは、
Docker Hubから取得したnginx イメージが、コンテナとして起動し、ポート経由で外部からアクセスできているということです。
Step 6: コンテナを停止・削除する
使い終わったらコンテナを停止して削除します。
docker stop test-nginx
docker rm test-nginx
Docker Desktop での見え方
docker stopを実行すると、Docker DesktopのContainersタブでステータスがRunningから停止状態に変わります。
docker rmを実行すると、一覧からコンテナが消えます。
イメージも削除する場合
不要であれば、下記でイメージも削除も可能です。
rmiはremove imageの略
docker rmi nginx
まとめ
この記事では、Docker CLI で nginx コンテナを起動し、その結果を Docker Desktop で確認しました。
-
docker pullで Docker Hub からイメージを取得できる -
docker runでコンテナを起動できる - Docker Desktop では Images タブと Containers タブに反映される
- ブラウザで
http://localhost:8080にアクセスすると動作確認できる
pullするとイメージが増え、runするとコンテナが作成・起動し、stopで停止、rmで削除、という対応関係が理解できれば良いと思います。
参考
本記事を作成するうえで、以下の資料を参考にさせていただきました。
株式会社ジールでは、「ITリテラシーがない」「初期費用がかけられない」「親切・丁寧な支援がほしい」「ノーコード・ローコードがよい」「運用・保守の手間をかけられない」などのお客様の声を受けて、オールインワン型データ活用プラットフォーム「ZEUSCloud」を月額利用料にてご提供しております。
ご興味がある方は是非下記のリンクをご覧ください：