Dockerネットワークの確認は、一覧から対象を見つけ、inspectで詳細を読む順番にすると整理できます。名前が同じに見える環境でも、実際に接続しているDocker daemonやコンテナが異なる可能性があるため、観測した対象も残します。
この記事では、既存の構成を変更せずに調査材料を集める考え方を示します。コマンドは未実行の説明例です。
一覧で対象を特定する
まずネットワークの一覧を表示します。
docker network ls
公式のnetwork lsで示されるID・名前・driverなどを読み、調査したいアプリが使うネットワークを特定します。ホストやDocker contextも作業記録に添え、別環境の結果を混ぜないようにします。
一覧に名前があるだけでは、対象コンテナが参加していることまで確認できません。詳細の確認へ進みます。
inspectで詳細情報を読む
docker network inspect sample-app-net
network inspectは、一つ以上のネットワークの詳細を返すコマンドで、既定ではJSON形式です。仮の名前を実環境の対象へ置き換えて確認します。
見る項目は、調べたい問題に合わせて選びます。たとえばdriver、IPアドレス管理の設定、接続コンテナの情報を、期待する構成と対応させます。出力項目や内容はdriverや環境で異なるため、一つの出力例をすべての構成の正解にしません。
コンテナ側の情報とも対応づける
| 調査したいこと | ネットワーク側で読む材料 | 追加で確かめること |
|---|---|---|
| 参加先が違う | 接続コンテナのID | コンテナの設定と管理定義 |
| 名前で接続できない | ネットワークの種類と参加範囲 | 参照元からの名前解決 |
| ポートへ届かない | 対象ネットワークとアドレス | サービスの待受・公開設定 |
これは調査の対応表です。inspectの情報だけで、ファイアウォール・アプリ認証・業務処理まで正常と判定しないでください。
一時点の結果として保存する
コンテナの再作成や接続変更により、IDやアドレスが変わる場合があります。記録には取得日時、Docker環境、対象IDを添えます。別時刻の一覧と詳細をつなげるときは、同じ対象を見ているか確認します。
出力には内部の名前やアドレスなどが含まれます。支援依頼へ共有するときは必要な項目に絞り、公開してよい範囲へ整理します。
観測結果から次の調査を決める
一覧・詳細・コンテナの設定を同じ対象で対応づけると、問題が所属・名前解決・接続・アプリのどこにあるかを順に絞れます。結果を図にまとめる際はネットワーク構成図の作り方を参考にしてください。