Résoudre les problèmes de création d'environnement

Cette page fournit des informations de dépannage pour les problèmes que vous pouvez rencontrer lors de la création d'environnements Cloud Composer.

Pour en savoir plus sur la mise à jour et la mise à niveau des environnements, consultez la page Dépannage des mises à jour et des mises à niveau d'environnement.

Lorsque les environnements Cloud Composer sont créés, la majorité des problèmes se produisent pour les raisons suivantes :

  • Problèmes d'autorisation de compte de service.

  • Informations incorrectes de pare-feu, de DNS ou de routage.

  • Problèmes réseau. Par exemple, une configuration VPC non valide, des conflits d'adresses IP ou des plages d'adresses IP réseau trop restrictives

  • Problèmes liés aux quotas

  • Règles d'administration incompatibles

Autorisations insuffisantes pour créer un environnement

Si Cloud Composer ne peut pas créer d'environnement car votre compte ne dispose pas des autorisations nécessaires, les messages d'erreur suivants s'affichent :

ERROR: (gcloud.composer.environments.create) PERMISSION_DENIED: The caller
does not have permission

ou

ERROR: (gcloud.composer.environments.create) PERMISSION_DENIED: User not
authorized to act as service account <service-account-name>.
The user must be granted iam.serviceAccounts.actAs permission, included in
Owner, Editor, Service Account User role. See https://cloud.google.com/iam/docs
/understanding-service-accounts for additional details.

Solution : Attribuez des rôles à votre compte et au compte de service de votre environnement, comme décrit dans la section Contrôle des accès.

Le compte de service de l'environnement ne dispose pas des autorisations nécessaires

Lors de la création d'un environnement Cloud Composer, vous spécifiez un compte de service qui exécute les nœuds GKE de l'environnement. Si ce compte de service ne dispose pas des autorisations nécessaires pour l'opération demandée, Cloud Composer génère l'erreur suivante :

Errors in: [Web server]; Error messages:
  Creation of airflow web server version failed. This may be an intermittent
  issue of the App Engine service. You may retry the operation later.
{"ResourceType":"appengine.v1.version","ResourceErrorCode":"504","ResourceError
Message":"Your deployment has failed to become healthy in the allotted time
and therefore was rolled back. If you believe this was an error, try adjusting
the 'app_start_timeout_sec' setting in the 'readiness_check' section."}

Solution : Attribuez des rôles à votre compte et au compte de service de votre environnement, comme décrit dans la section Contrôle des accès.

Un réseau VPC sélectionné pour l'environnement n'existe pas

Vous pouvez spécifier un réseau VPC et un sous-réseau pour votre environnement Cloud Composer lorsque vous le créez. Si vous ne spécifiez pas de réseau VPC, le service Cloud Composer sélectionne le VPC default et le sous-réseau default pour la région et la zone de l'environnement.

Si le réseau et le sous-réseau VPC spécifiés n'existent pas, Cloud Composer génère l'erreur suivante :

Errors in: [GKE cluster]; Error messages:
        {"ResourceType":"gcp-types/container-v1:projects.locations.clusters","R
        esourceErrorCode":"400","ResourceErrorMessage":{"code":400,"message":"P
        roject \"<your composer project>\" has no network named \"non-existing-
        vpc\".","status":"INVALID_ARGUMENT","statusMessage":"Bad
        Request","requestPath":"https://container.googleapis.com/
        v1/projects/<your composer
        project>/locations/<zone>/clusters","httpMethod":"POST"}}

Solution : avant de créer un environnement, assurez-vous que le réseau VPC et le sous-réseau de votre nouvel environnement existent.

Problèmes de quota rencontrés lors de la création d'environnements dans des réseaux à grande échelle

Lorsque vous créez des environnements Cloud Composer dans des réseaux à grande échelle, vous pouvez rencontrer les limites de quota suivantes :

  • Le nombre maximal d'appairages VPC par réseau VPC unique est atteint.
  • Le nombre maximal de plages d'adresses IP de sous-réseau principales et secondaires est atteint.
  • Le nombre maximal de règles de transfert du groupe d'appairage pour l'équilibrage de charge TCP/UDP interne est atteint.

Solution : appliquez l'approche recommandée pour Cloud Composer dans des réseaux à grande échelle.

Règles d'administration incompatibles

Les règles suivantes doivent être configurées de manière appropriée pour que les environnements Cloud Composer puissent être créés avec succès.

Règle d'administration Cloud Composer 1 Cloud Composer 2
compute.disableSerialPortLogging Désactivé pour les versions antérieures à 1.13.0. Sinon, n'importe quelle valeur. Doit être désactivé
compute.requireOsLogin Doit être désactivé Doit être désactivé
compute.vmCanIpForward Doit être autorisé (obligatoire pour les clusters GKE appartenant à Cloud Composer) lorsque le mode VPC natif (utilisation d'une adresse IP d'alias) n'est pas configuré Toutes les valeurs sont autorisées
compute.vmExternalIpAccess Doit être autorisé pour les environnements d'adresse IP publique Doit être autorisé pour les environnements d'adresse IP publique
compute.requireShieldedVm Doit être défini sur False Toutes les valeurs sont autorisées

Pour en savoir plus, consultez la page Problèmes connus dans Composer et Contraintes liées aux règles d'administration.

Messages d'erreur 400 : échec de déploiement du serveur Web Airflow.

Cette erreur peut être due à un échec de la création du cluster GKE d'un environnement d'adresse IP privée en raison du chevauchement des plages d'adresses IP.

Solution : recherchez les erreurs potentielles dans les journaux du cluster de votre environnement et résolvez le problème en fonction du message d'erreur GKE.

Étape suivante