Le 15 septembre 2026, tous les environnements Cloud Composer 1 et Cloud Composer 2 version 2.0.x atteindront leur fin de vie prévue et vous ne pourrez plus les utiliser. Nous vous recommandons de planifier la migration vers Cloud Composer 3.
Cette page fournit des étapes de dépannage et des informations sur les problèmes courants liés au serveur Web Airflow.
Le serveur Web Airflow est un composant Airflow qui fournit une interface utilisateur permettant de gérer les DAG et les tâches Airflow. Cette page décrit la procédure de dépannage pour résoudre divers problèmes d'accès au serveur Web Airflow de votre environnement ou pour les avertissements liés au serveur Web visibles dans les journaux Airflow.
Impossible d'accéder à l'UI Airflow lorsque les contrôles d'accès au réseau sont activés
Symptôme : Une fois les contrôles d'accès au serveur Web configurés, il n'est pas possible d'accéder à l'UI Airflow. Dans ce cas, le code d'erreur affiché est généralement 403.
Informations sur le problème : Cloud Composer est compatible avec les contrôles d'accès au réseau du serveur Web, qui vous permettent de spécifier les plages d'adresses IP autorisées à se connecter au serveur Web.
Les problèmes d'accès à l'interface utilisateur d'Airflow entraînent généralement une erreur 403. Pour vérifier si l'erreur est liée aux contrôles d'accès réseau du serveur Web, procédez comme suit :
Dans la liste des environnements, cliquez sur le nom de votre environnement.
La page Détails de l'environnement s'ouvre.
Accédez à l'onglet Configuration de l'environnement.
Vérifiez si l'élément Contrôle de l'accès au serveur Web est défini sur Toutes les adresses IP ont accès au serveur (valeur par défaut).
Si une valeur différente de Toutes les adresses IP ont accès (par défaut) est configurée, le contrôle des accès réseau est activé et la visibilité de l'interface utilisateur Airflow est limitée aux plages d'adresses IPv4 et IPv6 fournies. Dans ce cas, le problème peut être lié aux contrôles d'accès réseau du serveur Web.
Dans la plupart des cas, le problème est dû à une incompatibilité entre l'adresse IP prévue que vous avez spécifiée et l'adresse IP qui est réellement résolue pour se connecter à l'interface utilisateur Airflow. Pour résoudre le problème, procédez comme suit :
Dans la liste des environnements, cliquez sur le nom de votre environnement.
La page Détails de l'environnement s'ouvre.
Accédez à l'onglet Configuration de l'environnement.
Recherchez l'élément Contrôle de l'accès au serveur Web, puis cliquez sur Modifier.
Dans la boîte de dialogue Contrôle de l'accès réseau au serveur Web, sélectionnez Autoriser l'accès à partir de toutes les adresses IP.
Accédez à l'UI Airflow plusieurs fois et vérifiez qu'elle fonctionne sans problème :
Si vous ne rencontrez aucun problème, passez à l'étape suivante.
Si vous rencontrez un problème à ce stade, cela signifie qu'il est peut-être lié à la configuration de vos autorisations IAM. Pour en savoir plus sur les autorisations IAM pour Cloud Composer, consultez Contrôle des accès.
Dans la boîte de dialogue Contrôle de l'accès réseau au serveur Web, sélectionnez Autoriser l'accès uniquement depuis des adresses IP spécifiques.
Ajoutez la plage d'adresses IP 0.0.0.0/0, puis accédez plusieurs fois à l'interface utilisateur Airflow et vérifiez qu'elle fonctionne sans problème :
Si vous ne rencontrez aucun problème, l'adresse IP avec laquelle vous vous connectez est une adresse IPv4.
Si vous rencontrez un problème à ce stade, cela signifie que l'adresse IP avec laquelle vous vous connectez est une adresse IPv6.
Supprimez la plage d'adresses IP 0.0.0.0/0 et ajoutez la plage d'adresses IP ::/0.
Si vous ne rencontrez aucun problème, l'adresse IP avec laquelle vous vous connectez est une adresse IPv6.
Si vous rencontrez un problème à ce stade, cela signifie que l'adresse IP avec laquelle vous vous connectez est une adresse IPv4.
Vous avez maintenant déterminé si votre adresse résolue est IPv4 ou IPv6.
En fonction du type d'adresse, affinez les plages ::/0 ou 0.0.0.0/0 pour les rendre plus spécifiques, afin de vérifier la plage la plus large lorsque l'accès cesse de fonctionner :
Vous pouvez commencer par le masque de sous-réseau étendu (par exemple, 192.0.2.0/8) qui inclut l'adresse que vous supposez être votre adresse IP.
Pour déterminer votre adresse IP, vous pouvez utiliser un service tiers qui fournit votre adresse IP externe lorsque vous consultez sa page. Vous pouvez rechercher ces services à l'aide de la requête de recherche "quelle est mon adresse IP").
Les valeurs de configuration ne s'affichent pas sur la page de configuration
Certains paramètres de configuration Airflow sont masqués sur la page de configuration pour empêcher l'accès à des informations potentiellement sensibles. Par exemple, les identifiants permettant d'accéder à la base de données Airflow ne sont pas affichés.
Pour afficher les champs masqués, remplacez l'option de configuration Airflow suivante. Nous vous recommandons de rétablir les modifications une fois que vous avez obtenu les valeurs requises.
Section
Clé
Valeur
Remarques
webserver
expose_config
True
La valeur par défaut est non-sensitive-only. Définissez la valeur sur False pour masquer tous les paramètres de configuration.
Le DAG entraîne le plantage du serveur Web Airflow ou lui fait renvoyer une erreur "502 gateway timeout"
Des défaillances du serveur Web peuvent survenir pour plusieurs raisons. Consultez les journaux airflow-webserver dans Cloud Logging pour déterminer la cause de l'erreur 502 gateway timeout.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (UTC)."],[[["\u003cp\u003eThis document provides troubleshooting steps for common issues related to the Airflow web server, a key component for managing Airflow DAGs and tasks within Cloud Composer environments.\u003c/p\u003e\n"],["\u003cp\u003eA common problem is the inability to access the Airflow UI, often indicated by a 403 error, which typically stems from misconfigurations in web server network access controls.\u003c/p\u003e\n"],["\u003cp\u003eCloud Composer supports the ability to limit Airflow UI access to specific IP ranges, and problems may arise due to mismatches between the intended IP and the actual resolved IP address.\u003c/p\u003e\n"],["\u003cp\u003eTo diagnose IP related issues, users can temporarily allow access from all IP addresses, and then add either \u003ccode\u003e0.0.0.0/0\u003c/code\u003e or \u003ccode\u003e::/0\u003c/code\u003e IP ranges to determine if the connecting IP is IPv4 or IPv6.\u003c/p\u003e\n"],["\u003cp\u003eUsers can utilize a third-party service to determine the connecting IP address to allow them to narrow down the subnet masks for access, allowing for a more secure and controlled access.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\n[Cloud Composer 3](/composer/docs/composer-3/troubleshooting-web-server \"View this page for Cloud Composer 3\") \\| **Cloud Composer 2** \\| [Cloud Composer 1](/composer/docs/composer-1/troubleshooting-web-server \"View this page for Cloud Composer 1\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis page provides troubleshooting steps and information for common Airflow\nweb server issues.\n\nThe Airflow web server is an Airflow component that provides a user interface\nfor managing Airflow DAGs and tasks. This page describes troubleshooting steps\nfor various issues with accessing the Airflow web server of your environment or\nfor web server-related warnings visible in Airflow logs.\n\nCan't access Airflow UI when network access controls are enabled\n\n**Symptom**: After web server access controls are configured, it's not possible\nto access Airflow UI. Usually, the error code displayed in this situation is\n403.\n\n**Information about the issue** : Cloud Composer supports\n[web server network access controls](/composer/docs/composer-2/access-airflow-web-interface#network-access-controls),\nwhich lets you specify IP ranges that are allowed to connect to the web server.\n\nProblems with accessing Airflow UI usually result in error 403. To check if the\nerror is related to web server network access controls, do the following:\n\n1. In the list of environments, click the name of your environment. The **Environment details** page opens.\n2. Go to the **Environment configuration** tab.\n3. Check if the **Web server access control** item is set to **All IP addresses have access (default)**.\n4. If a value different than **All IP addresses have access (default)** is configured, then network access control is enabled and the visibility of the Airflow UI is limited to the provided IPv4 and IPv6 address ranges. In this case, the problem might be related to web server network access controls.\n\nIn most cases, the cause of the issue is the mismatch between the intended IP\nthat you specified and the IP that is actually resolved to connect to the\nAirflow UI. To troubleshoot the problem, do the following:\n\n1. In the list of environments, click the name of your environment.\n The **Environment details** page opens.\n\n2. Go to the **Environment configuration** tab.\n\n3. Find the **Web server access control** item and click **Edit**.\n\n4. In the **Web server network access control** dialog, select\n **Allow access from all IP addresses**.\n\n5. Access the Airflow UI multiple times and verify that it works without any\n issues:\n\n - If you don't experience problems, continue to the next step.\n\n - If you experience a problem at this point, it means that the issue might\n be related to your IAM permissions configuration. For\n more information about the IAM permissions for\n Cloud Composer, see [Access control](/composer/docs/composer-2/access-control).\n\n6. In the **Web server network access control** dialog, select\n **Allow access only from specific IP addresses**.\n\n7. Add the `0.0.0.0/0` IP range, then access the Airflow UI multiple times and\n verify that it works without issues:\n\n - If you don't experience problems, then the IP that you're connecting\n with is an IPv4 address.\n\n - If you experience a problem at this point, it means the IP you're\n connecting with is an IPv6 address.\n\n8. Delete the `0.0.0.0/0` IP range, and add the `::/0` IP range.\n\n - If you don't experience problems, then the IP that you're connecting\n with is an IPv6 address.\n\n - If you experience a problem at this point, it means the IP you're\n connecting with is an IPv4 address.\n\n9. Now you determined if your resolved address is IPv4 or IPv6.\n\n10. Depending on the address type, narrow down the `::/0` or `0.0.0.0/0` ranges\n to more specific ones, to verify the broadest range when the access stops\n working:\n\n - You can start with the wide subnet mask (such as `192.0.2.0/8`) that\n includes the address that you assume to be your IP address.\n\n - To determine your IP address, you can use a third-party service that\n provides your external IP address when you visit its page. You can\n search for such services by the \"what is my IP address\" search query).\n\nConfiguration values aren't displayed on the configuration page\n\nSome Airflow configuration parameters of Airflow are hidden on the\nconfiguration page to prevent access to potentially sensitive information. For\nexample, credentials to access the Airflow database are not displayed.\n| **Warning:** If you configure Airflow to display these parameters, then\n| **any Airflow user with `Admin` and `Op` permission will be able to access this\n| information.**\n| By default, Airflow assigns the `Op` role to new Airflow users.\n|\n| To prevent Airflow users with the `Op` role from accessing the configuration page:\n|\n| 1. Go to the **Security** \\\u003e **List Roles** configuration page in the Airflow UI.\n| 2. Revoke the **can read Configurations** and **menu access on Configurations** permissions from the `Op` role.\n\nTo display hidden fields, [override](/composer/docs/composer-2/override-airflow-configurations) the following Airflow\nconfiguration option. We recommend to revert the changes after you obtain the\nrequired values.\n\n| Section | Key | Value | Notes |\n|-------------|-----------------|--------|-------------------------------------------------------------------------------------------------|\n| `webserver` | `expose_config` | `True` | The default value is `non-sensitive-only`. Set to `False` to hide all configuration parameters. |\n\nDAG crashes the Airflow web server or causes it to return a '502 gateway timeout' error\n\nWeb server failures can occur for several different reasons. Check\nthe **airflow-webserver** logs in\n[Cloud Logging](/composer/docs/composer-2/view-logs#streaming) to determine the cause of the\n`502 gateway timeout` error.\n\nWhat's next\n\n- [Access Airflow UI](/composer/docs/composer-2/access-airflow-web-interface)\n- [Access control](/composer/docs/composer-2/access-control)"]]
