Dockerのnetwork aliasは、接続したネットワーク内でコンテナを別の名前で参照するための指定です。コンテナ名そのものを変更する操作や、インターネット向けのDNS登録とは異なります。
この記事では、aliasの範囲と、接続名が解決できないときの確認を整理します。コマンドは未実行の説明例です。
別名はネットワークごとに考える
Dockerのnetwork connectは、--aliasをネットワーク単位の別名として説明しています。ユーザー定義bridgeでは、同じネットワークのコンテナを名前やaliasで解決できます。
仮にdb-test-01というコンテナへorders-dbという別名を付けるなら、利用側はコンテナの運用名ではなく役割の名前で参照できます。ただし、別ネットワークのコンテナからも同じように見えるとは限りません。
接続先と別名を対にして指定する
既存のコンテナをネットワークへ接続し、別名を付ける例です。
docker network connect --alias orders-db sample-app-net db-test-01
ネットワークとコンテナの名前は仮のものです。すでに接続されている構成への変更方法や、Composeで管理されている定義との関係を確認してから実環境へ適用します。
コンテナを複数ネットワークへ接続する場合は、どのネットワークでどの別名を使うかを記録します。名前だけの一覧では、接続元により結果が異なる理由が分からなくなります。
名前解決とサービス接続を分けて確認する
| 段階 | 確認したいこと |
|---|---|
| ネットワーク所属 | 利用側と接続先が意図したネットワークへ参加しているか |
| 名前解決 | その利用側からaliasを解決できるか |
| 接続 | 目的のポートでサービスが待ち受けているか |
| アプリ利用 | 認証・プロトコル・接続先設定が合うか |
名前が解決できることは、アプリケーションの処理成功まで保証しません。逆に接続失敗をすべてDNSの問題と決めつけず、段階を分けて調べます。
同じ別名の共有は接続先を曖昧にする
Composeの公式仕様では、一つのネットワーク上でaliasを複数のコンテナやサービスが共有でき、その場合にどのコンテナへ解決されるかは保証されないと説明されています。
特定の一台を示したい名前を複数へ付けると、利用者の意図と実際の接続先が一致しなくなる場合があります。複数台を使う構成なら、aliasだけに負荷分散や可用性の保証を期待せず、必要な仕組みを別に確認します。
名前を役割と範囲で管理する
別名・ネットワーク・参照元・接続先サービスを揃えて管理しましょう。構成を共有するときはネットワーク構成図へ範囲を記し、IPの一覧だけでは分からない名前の関係も残します。