ハンズオン:コンテナ間通信を体験しよう
ここでは、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