Airflow ウェブサーバーに関する問題のトラブルシューティング

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

このページでは、Airflow ウェブサーバーの一般的な問題に関する情報とトラブルシューティングの手順について説明します。

Airflow ウェブサーバーは、Airflow の DAG とタスクを管理するためのユーザー インターフェースを提供する Airflow コンポーネントです。このページでは、環境の Airflow ウェブサーバーにアクセスする際のさまざまな問題や、Airflow ログに表示されるウェブサーバー関連の警告に関するトラブルシューティングの手順について説明します。

ネットワーク アクセス制御が有効になっている場合に Airflow UI にアクセスできない

症状: ウェブサーバーのアクセス制御を構成した後、Airflow UI にアクセスできなくなります。通常、この状況で表示されるエラーコードは 403 です。

問題に関する情報: Cloud Composer はウェブサーバーのネットワーク アクセス制御をサポートしています。これにより、ウェブサーバーに接続できる IP 範囲を指定できます。

Airflow UI へのアクセスで問題が発生すると、通常はエラー 403 が発生します。エラーがウェブサーバーのネットワーク アクセス制御に関連しているかどうかを確認するには、次の操作を行います。

  1. 環境のリストで、ご利用の環境の名前をクリックします。 [環境の詳細] ページが開きます。
  2. [環境の設定] タブに移動します。
  3. [ウェブサーバーのアクセス制御] 項目が [すべての IP アドレスがアクセス可能です(デフォルト)] に設定されていることを確認します。
  4. [すべての IP アドレスがアクセスできる(デフォルト)] とは異なる値が構成されている場合、ネットワーク アクセス制御が有効になり、Airflow UI の公開設定は、指定された IPv4 と IPv6 のアドレス範囲に制限されます。この場合、問題がウェブサーバーのネットワーク アクセス制御に関係している可能性があります。

ほとんどの場合、問題の原因は、指定した目的の IP と、Airflow UI に接続するために実際に解決された IP の不一致です。問題を解決するには、次の手順を行います。

  1. 環境のリストで、ご利用の環境の名前をクリックします。[環境の詳細] ページが開きます。

  2. [環境の設定] タブに移動します。

  3. [ウェブサーバーのアクセス制御] の項目を見つけて、[編集] をクリックします。

  4. [ウェブサーバーのネットワーク アクセス制御] ダイアログで、[すべての IP アドレスからのアクセスを許可する] を選択します。

  5. Airflow UI に複数回アクセスし、問題なく動作することを確認します。

    • 問題が起きない場合は、次のステップに進みます。

    • この時点で問題が発生した場合は、IAM 権限の構成に関する問題がある可能性があります。Cloud Composer の IAM 権限の詳細については、アクセス制御をご覧ください。

  6. [ウェブサーバーのネットワーク アクセス制御] ダイアログで、[特定の IP アドレスからのアクセスのみを許可する] を選択します。

  7. 0.0.0.0/0 IP 範囲を追加し、Airflow UI に複数回アクセスして、問題なく動作することを確認します。

    • 問題が発生しない場合は、接続している IP が IPv4 アドレスです。

    • この時点で問題が発生した場合は、接続している IP が IPv6 アドレスであることを意味します。

  8. 0.0.0.0/0 IP 範囲を削除し、::/0 IP 範囲を追加します。

    • 問題が発生しない場合は、接続している IP が IPv6 アドレスです。

    • この時点で問題が発生した場合は、接続している IP が IPv4 アドレスであることを意味します。

  9. これで、解決されたアドレスが IPv4 か IPv6 かを特定できました。

  10. アドレスの種類に応じて、::/0 または 0.0.0.0/0 の範囲をより具体的なものに絞り込み、アクセスが停止する最も広い範囲を確認します。

    • IP アドレスを想定しているアドレスを含むワイド サブネット マスク(192.0.2.0/8 など)で開始できます。

    • IP アドレスを確認するには、ページにアクセスしたときに外部 IP アドレスを提供するサードパーティ サービスを使用します。このようなサービスは、「私の IP アドレスは何ですか」という検索クエリで検索できます。

次のステップ