ハンズオン:コンテナ間通信を体験しよう

ここでは、2つのコンテナを同じネットワークに接続し、コンテナ名を使って通信できることを確認します。

今回のハンズオンはまず、独自のDockerネットワークを作成します。次に、そのネットワークに接続した状態で、Webサーバ用のコンテナ(nginx)と、通信テスト用のコンテナ(alpine)の2つを起動します。そして、テスト用コンテナからWebサーバコンテナに対して、コンテナ名を使ってリクエストを送信し、通信できることを確認します。

1. ネットワークの作成

以下のコマンドで、Docker がインストールされていることを確認します。

docker --version

以下のように Docker のバージョンが表示されれば、インストールは確認できています。

Docker version 27.x.x, build xxxxxxx

バージョンが表示されない場合は、Docker Desktopのインストール を先に実施してください。

インストールが確認できたら、ハンズオン用のネットワークを作成します。

docker network create my-network

ネットワークが作成されたことを確認するために、一覧を表示してみましょう。

docker network ls

以下のように、my-networkが追加されていることが確認できます。

NETWORK ID     NAME         DRIVER    SCOPE
a1b2c3d4e5f6   bridge       bridge    local
f6e5d4c3b2a1   host         host      local
xxxxxxxxxxxx   my-network   bridge    local
1a2b3c4d5e6f   none         null      local

2. コンテナの起動

テスト用に2つのコンテナを起動します。1つ目はnginxのWebサーバ、2つ目は通信テスト用のalpineコンテナです。

どちらのコンテナも--networkオプションでmy-networkに所属させます。これにより、同じネットワーク内のコンテナ同士がコンテナ名で通信できるようになります。

なお、nginxとalpineはDocker Hubで公開されている公式イメージです。ローカルに存在しない場合は、自動的にDocker Hubからダウンロードされます。

docker container run -d --name web-container --network my-network nginx
オプション 値 設定の基準
-d - Webサーバをバックグラウンドで常時起動させるため
--name web-container 通信先としてコンテナ名で指定できるようにするため
--network my-network 作成したネットワークに接続し、コンテナ間通信を可能にするため
docker container run -d --name client-container --network my-network alpine sleep infinity
オプション 値 設定の基準
-d - バックグラウンドでコンテナを起動するため
--name client-container コンテナを識別しやすくするため
--network my-network web-containerコンテナと同じネットワークに接続し、通信できるようにするため
💡 ポイント
alpineイメージは、実行するコマンドを指定しないとすぐに終了してしまいます。-dオプションでバックグラウンド起動しても、実行するプロセスがなければコンテナは停止します。

sleep infinityを指定することで、コンテナ内で無限に待機するプロセスが動き続け、コンテナを起動状態に維持できます。これにより、後からdocker container execでコンテナに接続できるようになります。

3. ネットワークの詳細確認

2つのコンテナがmy-networkに接続されていることを確認しましょう。

docker network inspect my-network

出力結果のContainersセクションに、web-containerとclient-containerが表示されていれば、正しくネットワークに接続されています。

"Containers": {
    "xxxx": {
        "Name": "web-container",
        ...
    },
    "yyyy": {
        "Name": "client-container",
        ...
    }
}

4. コンテナへの接続

起動したalpineコンテナに接続し、シェルを起動します。

docker container exec -it client-container sh
オプション 値 設定の基準
-it - コンテナ内で対話的にコマンドを実行するため

このコマンドを実行すると、alpineコンテナのシェルに入ります。

5. コンテナ名での通信確認

alpineコンテナのシェル内で、以下のコマンドを実行して、web-containerコンテナに対してリクエストを送信します。

wget -qO- http://web-container

web-containerというコンテナ名だけで通信先を指定していますが、DockerのDNS機能により自動的にIPアドレスが解決され、nginxのデフォルトページが表示されます。

<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
...

このように、同じネットワーク内であれば、コンテナ名を使って簡単に通信できることが確認できました。

シェルを終了するには、exitと入力します。

6. 不要リソースの削除

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

まず、起動中のコンテナを停止し、削除します。

docker container stop web-container client-container
docker container rm web-container client-container

次に、docker network rmコマンドで作成したネットワークを削除します。

docker network rm my-network

最後に、ネットワークが削除されたことを確認します。

docker network ls

my-networkが一覧から消えていれば、削除は完了です。

NETWORK ID     NAME      DRIVER    SCOPE
a1b2c3d4e5f6   bridge    bridge    local
f6e5d4c3b2a1   host      host      local
1a2b3c4d5e6f   none      null      local