Airflow Web 服务器问题排查

Cloud Composer 1 | Cloud Composer 2

本页介绍了常见 Airflow Web 服务器问题的问题排查步骤和信息。

Airflow Web 服务器是一个 Airflow 组件，提供用于管理 Airflow DAG 和任务的界面。本页面介绍了有关访问您环境中的 Airflow Web 服务器时遇到的各种问题或 Airflow 日志中与 Web 服务器相关的警告的问题排查步骤。

启用网络访问权限控制后无法访问 Airflow 界面

症状：配置 Web 服务器访问权限控制后，无法访问 Airflow 界面。在这种情况下，通常显示的错误代码为 403。

问题相关信息：Cloud Composer 支持 Web 服务器网络访问权限控制，可让您指定允许连接到 Web 服务器的 IP 地址范围。

访问 Airflow 界面时出现问题通常会导致错误 403。如需检查错误是否与 Web 服务器网络访问权限控制相关，请执行以下操作：

  1. 在环境列表中，点击您的环境的名称。 环境详情页面会打开。
  2. 转到环境配置标签页。
  3. 检查 Web 服务器访问权限控制项是否已设置为所有 IP 地址都有访问权限（默认）。
  4. 如果配置的值不是所有 IP 地址都有访问权限（默认），则系统会启用网络访问权限控制，并将 Airflow 界面的可见性限制为提供的 IPv4 和 IPv6 地址范围。在这种情况下，问题可能与 Web 服务器网络访问权限控制有关。

在大多数情况下，此问题的原因是您指定的预期 IP 与为连接到 Airflow 界面而实际解决的 IP 不匹配。若要排查问题，请执行以下操作：

  1. 在环境列表中，点击您的环境名称。环境详情页面会打开。

  2. 转到环境配置标签页。

  3. 找到 Web 服务器访问权限控制项，然后点击修改。

  4. 在 Web 服务器网络访问权限控制对话框中，选择允许来自所有 IP 地址的访问。

  5. 多次访问 Airflow 界面，并验证其是否正常运行：

    • 如果未遇到问题，请继续执行下一步。

    • 如果此时遇到问题，则表示该问题可能与 IAM 权限配置有关。如需详细了解 Cloud Composer 的 IAM 权限，请参阅访问权限控制。

  6. 在 Web 服务器网络访问权限控制对话框中，选择仅允许从特定 IP 地址访问。

  7. 添加 0.0.0.0/0 IP 范围，然后多次访问 Airflow 界面，并验证其能否正常运行：

    • 如果您未遇到问题，则用于连接的 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 范围缩小到更具体的范围，以便在访问权限停止时验证最宽泛的范围：

    • 您可以从宽子网掩码（例如 192.0.2.0/8）开始，该掩码包含您认为是 IP 地址的地址。

    • 如需确定您的 IP 地址，您可以使用在您访问其页面时提供外部 IP 地址的第三方服务。您可以按“我的 IP 地址是什么”搜索查询来搜索此类服务。

后续步骤