コンテナを再ビルドした後、リバースプロキシが502を返すのはなぜですか?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

コンテナの再ビルド後、リバースプロキシが再ビルドされたアップストリームへの有効な接続を確立できなくなると、502を返します。

再ビルドによってコンテナが置き換わる、アドレスが新たに割り当てられる、Dockerネットワークから切断または改名される、公開ポートが変わる、不完全な設定が復元される、あるいはアプリケーションの準備が整う前にプロキシが起動することがあります。適切な原因特定はプロキシのエラーログから始め、エラーが一時的に消えるまで両サービスを再起動するのではなく、プロキシからコンテナまで正確なアップストリームアドレスをたどって行います。

502の原因がアップストリームへの接続失敗であることを確認する

該当ドメインに一度リクエストを送り、タイムスタンプ、プロキシのステータス、アップストリームのアドレス、エラーメッセージ全文を記録します。接続拒否、ホスト名解決失敗、タイムアウト、接続リセット、TLSハンドシェイク失敗、無効な応答を区別します。

502は、プロキシが有効なアップストリーム応答を受け取れなかったことを意味します。ただし、エラーの詳細から、接続先が存在しないのか、到達できないのか、リッスンしていないのか、誤ったプロトコルを使用しているのかを判断できます。最新のNGINXトラブルシューティングガイドによると、コンテナを再ビルドすると、名前解決または設定が更新されるまで、プロキシが古いバックエンドアドレスを使い続けることがあります。

ログに記録されたアップストリーム名、アドレス、ポート、プロトコルを使い、プロキシホストまたはプロキシコンテナからアプリケーションに直接リクエストを送ります。同じ問題で直接リクエストも失敗する場合は、パブリックDNSや証明書を変更せず、プロキシとコンテナ間の調査を続けます。

再ビルド前後のアップストリーム接続先を比較する

再ビルド後のコンテナ名、サービス名、内部IP、公開ポート、マッピングされたポート、ネットワークエイリアス、ネットワーク接続を確認します。プロキシ設定および最後に正常だった接続先と比較します。

nginx-proxyの問題報告では、再ビルドによってアプリケーションコンテナのIPが変わった一方、プロキシが到達不能なコンテナのアップストリームへリクエストを送り続けた事例が説明されています。パブリックドメインは正しいままで、プライベートなアップストリームの識別情報だけが変わっていました。

コンテナIPではなく、安定したComposeサービス名またはネットワークエイリアスを使用します。IPを意図的に固定している場合は、再ビルドされたサービスに実際にそのIPが割り当てられたことと、他のコンテナがそのアドレスを使用していないことを確認します。

プロキシとアプリケーションが引き続きDockerネットワークを共有していることを確認する

プロキシとアプリケーションが接続されているネットワークを一覧にし、少なくとも1つのユーザー定義ネットワークを共有していることを確認します。ホストポートを公開しても、別の分離されたDockerネットワークからコンテナ名にアクセスできるようになるわけではありません。

Dockerネットワークに関する事例では、依存サービスを適切なネットワークに移動したところ502エラーがすぐに解消しました。これは、すべてのコンテナが実行中でも上流への経路に到達できない場合があることを示しています。

サービス同士の関係を再ビルド後も維持できるよう、単発のコマンドではなくComposeを使って接続してください。スタックを再作成した後、プロキシコンテナ内からDNS解決と上流ポートへの接続をテストします。

内部リッスンポートとバインドアドレスを確認する

アプリケーションがプロキシの使用するポートをリッスンし、コンテナネットワークから到達可能なアドレスにバインドされていることを確認してください。ホストに公開されたポートと、コンテナ内部のリッスンポートを混同しないでください。

アプリがループバック以外のアドレスでバインドして初めて、プロキシは接続できます。独自のコンテナ内で127.0.0.1をリッスンしているサービスは、ローカルのヘルスチェックコマンドが成功しても、プロキシからは利用できません。

アプリケーションのログ、ソケット一覧、プロキシコンテナからの直接リクエストを1件確認してください。ポートへの接続が拒否される場合は、再試行を追加したり、プロキシのタイムアウトを延長したりする前に、アプリのリスナーまたは設定を修正してください。

コンテナの起動ではなく、アプリケーションの準備完了を待つ

コンテナを再ビルドすると、コンテナ自体は実行中でも、マイグレーション、データベースの復旧、キャッシュのウォームアップ、設定の生成などが完了するまで、アプリケーションがリクエストを受け付けないことがあります。最初に502が発生した時刻を、ヘルスチェックと起動ログの時刻と比較してください。

Gristのトラブルシューティングに関する議論では、Dockerのアーキテクチャ、環境設定、上流サービスの準備状況が重なり、再ビルド後もコンテナ側で502エラーが発生し続けるケースが紹介されています。

意味のあるヘルスチェックを追加し、単にプロセスが存在するだけでなく、クライアントが必要とする処理ができるまでプロキシまたは依存サービスを待機させてください。再試行回数には上限を設け、永久に失敗しているアプリが単に起動に時間がかかっているように見えないようにします。

プロキシの名前解決を更新し、安定した経路を再構築する

サービス名、ネットワーク、ポート、ヘルス状態が正しいことを確認してから、プロキシを再読み込みするか、再作成してください。プロキシが起動時にしか名前を解決しない場合は、サポートされている実行時の名前解決を設定するか、予測可能な再起動順序を設定してください。

ZimaSpaceで障害のあるコンテナ依存関係を切り分ける手順を確認してください。上流コンテナが正常な状態を維持せず、繰り返し終了する場合に役立つ診断方法です。

プロキシが再ビルド後にサービス名を解決し、目的の内部ポートに接続でき、起動完了まで待機し、手動でIPを変更せずにドメインを提供できて初めて、修復は完了です。検証後は、一時的な直接IPの接続先と、文書化されていないネットワーク接続を削除してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.