Cette page propose des stratégies de dépannage, ainsi que des solutions à certains messages d'erreur courants susceptibles de s'afficher lors de l'exécution d'une compilation.
Avez-vous consulté les journaux de compilation ?
Utilisez les journaux de compilation Logging ou Cloud Storage pour obtenir plus d'informations sur l'erreur de compilation. Les journaux écrits dans stdout ou stderr sont consultables à l'aide de la console Google Cloud et de gcloud CLI.
Les compilations manuelles échouent, car l'utilisateur n'a pas accès aux journaux de compilation
L'erreur suivante s'affiche lorsque vous tentez d'exécuter une compilation manuelle :
AccessDeniedAccess denied. [EMAIL_ADDRESS] does not have storage.objects.get access to the Google Cloud Storage object.
Cette erreur s'affiche, car Cloud Build exige que les utilisateurs qui exécutent des compilations manuelles et utilisent le bucket de journaux Cloud Storage par défaut disposent du rôle IAM de lecteur de projet en plus du rôle d'éditeur Cloud Build. Pour résoudre cette erreur, vous pouvez effectuer l'une des opérations suivantes :
Utilisez le bucket de journaux par défaut, puis attribuez le rôle Lecteur de projet et le rôle Éditeur Cloud Build à l'utilisateur qui exécute la compilation. Pour obtenir des instructions sur l'attribution de ce rôle, consultez la page Configurer l'accès aux ressources Cloud Build.
Créez votre propre bucket Cloud Storage pour stocker des journaux. Pour savoir comment procéder, consultez la section Stocker des journaux de compilation dans un bucket créé par l'utilisateur.
Échec des compilations en raison de l'absence de l'autorisation iam.serviceAccounts.actAs
L'erreur suivante s'affiche lorsque vous essayez de déployer un build à l'aide d'un service géré tel que Cloud Run ou App Engine :
Missing necessary permission iam.serviceAccounts.actAs for [USER] on the service account [SERVICE ACCOUNT]
Pour résoudre cette erreur, configurez le compte de service Cloud Build spécifié ou le compte de service Cloud Build par défaut pour emprunter l'identité du compte de service du service géré que vous utilisez pour votre compilation. Pour en savoir plus sur cette tâche, consultez Configurer l'emprunt d'identité d'un compte de service Cloud Build pour les services gérés.
Pour en savoir plus sur les comptes de service et les autorisations, consultez les rubriques suivantes :
- Configurer des comptes de service spécifiés par l'utilisateur
- Compte de service Cloud Build par défaut
- Présentation des rôles IAM
- Accorder des autorisations au compte de service Cloud Build par défaut
Erreur d'autorisation refusée lors du déploiement sur Cloud Run Functions
L'erreur suivante s'affiche lorsque vous essayez d'utiliser Cloud Run Functions :
ResponseError: status=[403], code=[Ok], message=[Permission 'cloudfunctions.functions.get' denied]
Pour résoudre cette erreur, attribuez le rôle "Développeur Cloud Run Functions" à votre compte de service de compilation.
Échec du déclencheur de compilation en raison d'une autorisation cloudbuild.builds.create manquante
Une erreur semblable à celle-ci s'affiche lorsque vous exécutez un déclencheur de compilation :
Failed to trigger build: Permission 'cloudbuild.builds.create' denied on resource 'projects/xxxxxxxx' (or it may not exist)
Les déclencheurs de compilation utilisent un compte de service pour créer une compilation. Cette erreur indique que le compte de service ne dispose pas de l'autorisation IAM cloudbuild.builds.create, qui est requise pour que le compte de service exécute un déclencheur de compilation. Vous pouvez résoudre cette erreur en accordant le rôle IAM Cloud Build Service Account à votre compte de service spécifié par l'utilisateur ou au compte de service par défaut.
Échec de l'envoi de la compilation en raison d'autorisations d'agent de service manquantes
Si l'agent de service Cloud Build est supprimé ou ne dispose pas des autorisations nécessaires, l'erreur suivante peut se produire lors de l'envoi d'une compilation.
Caller does not have required permission to use project $PROJECT_ID. Grant the caller the roles/serviceusage.serviceUsageConsumer role, or a custom role with the serviceusage.services.use permission, by visiting https://console.developers.google.com/iam-admin/iam/project?project=$PROJECT_ID and then retry. Propagation of the new permission may take a few minutes.
Dans ce scénario, l'appelant est l'agent de service Cloud Build. Pour résoudre ce problème d'autorisation, procédez comme suit :
Assurez-vous que l'agent de service Cloud Build existe. Vous pouvez afficher l'agent de service d'un projet en accédant à la page IAM de la console Google Cloud et en cochant la case Afficher les comptes de service gérés par Google. Si ce n'est pas le cas, vous pouvez le créer en exécutant la commande gcloud CLI suivante :
gcloud beta services identity create --service=cloudbuild.googleapis.com \ --project=PROJECT_IDEnsuite, attribuez le rôle IAM
roles/cloudbuild.serviceAgentà l'agent de service Cloud Build :gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudbuild." \ --role="roles/cloudbuild.serviceAgent"
Si vous souhaitez vérifier quelle identité IAM est potentiellement responsable du problème d'autorisation de l'agent de service, procédez comme suit :
Ouvrez l'explorateur de journaux dans la console Google Cloud :
Saisissez le texte suivant dans le champ "Requête" :
resource.type="project" log_name="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity" "service-PROJECT_NUMBER@gcp-sa-cloudbuild."Si vous voyez des entrées de journal après avoir utilisé cette requête, vérifiez si l'une d'elles supprime des autorisations de l'agent de service (
service-PROJECT_NUMBER@gcp-sa-cloudbuild.). Si c'est le cas, examinez le champprotoPayload.authenticationInfo.principalEmaildans ce journal pour déterminer l'identité IAM responsable de la suppression de l'autorisation ou du rôleroles/cloudbuild.serviceAgentcontenant l'autorisation indiquée dans le message d'erreur.
Le déclencheur échoue avec l'erreur Couldn't read commit
L'erreur suivante s'affiche lorsque vous exécutez un déclencheur de compilation :
Failed to trigger build: Couldn't read commit
Cloud Build renvoie ce message si vous essayez de déclencher une compilation à l'aide d'une branche qui n'existe pas. Vérifiez l'orthographe et la cohérence des noms de vos répertoires. Pour savoir comment configurer un déclencheur, consultez Créer et gérer des déclencheurs de compilation.
Impossible de créer le déclencheur Pub/Sub
L'erreur suivante s'affiche lorsque vous créez un déclencheur Pub/Sub :
Failed to create trigger: Request is prohibited by organization's policy
Cette erreur indique que l'API Pub/Sub est limitée dans votre projet. Les projets qui limitent l'API Pub/Sub limitent la possibilité de créer des abonnements push. Vous pouvez supprimer temporairement Pub/Sub des services restreints de votre périmètre, créer le déclencheur, puis restreindre à nouveau l'API Pub/Sub pour résoudre l'erreur.
Impossible d'extraire ou de récupérer des branches d'un dépôt privé en raison de l'erreur suivante : fatal: could not read Username
L'erreur suivante s'affiche lorsque vous essayez d'effectuer une opération git pull ou git fetch sur une branche distante à partir d'un dépôt privé :
fatal: could not read Username for '<REMOTE_URL>': No such device or address
Cette erreur est attendue sur les dépôts privés, car l'assistant d'identification Git est intentionnellement supprimé après le clonage initial du dépôt. Pour récupérer des branches distantes à partir d'un dépôt privé, configurez manuellement les identifiants d'autorisation (jetons d'API, clés SSH) en tant qu'étape de compilation. En savoir plus sur l'accès aux dépôts GitHub privés
Les compilations échouent en raison d'une autorisation SSH non valide
L'erreur suivante s'affiche lors de l'exécution d'une compilation :
Could not parse ssh: [default]: invalid empty ssh-agent socket, make sure SSH_AUTH_SOCK is set
Cette erreur indique un problème d'autorisation SSH. Un exemple courant d'erreur d'autorisation SSH se produit lors de l'accès aux dépôts GitHub privés avec Cloud Build. Pour obtenir des instructions sur la configuration de SSH pour GitHub, consultez la page Accéder aux dépôts GitHub privés.
Les compilations échouent en raison d'une erreur No route to host
L'erreur suivante ou similaire s'affiche lorsque vous exécutez une compilation dans un pool privé :
Unable to connect to the server: dial tcp 192.168.10.XX:<port>: connect: no route to host
Cloud Build exécute ses compilateurs Cloud sur la machine virtuelle dans le projet géré par Google à l'aide des conteneurs Docker. Une plage d'adresses IP 192.168.10.0/24 est attribuée à l'interface du pont Docker (et par conséquent aux conteneurs connectés à cette interface), ce qui rend la communication avec les hôtes externes du même sous-réseau impossible. Lors de l'allocation des plages d'adresses IP des ressources de vos projets lors de la configuration du pool privé, nous vous recommandons de sélectionner une plage en dehors de 192.168.10.0/24. Pour obtenir des instructions, consultez la page Configurer votre environnement pour les pools privés.
Échec des compilations avec le message d'erreur "Expiré" et aucun journal ne s'affiche
Vous déclenchez ou envoyez une compilation, qui échoue en générant une erreur "Expiré", et aucun journal n'est généré.
Vérifiez les points suivants dans votre configuration :
Vous avez configuré une valeur
queueTtlinférieure (par exemple, 20 s).Augmentez la valeur dans votre schéma et relancez la compilation. Pour en savoir plus, consultez
queueTtl.Vous avez atteint le quota de builds simultanés.
Vous pouvez demander une augmentation sur la page "Quotas" de la console Google Cloud . Pour en savoir plus, consultez Quotas et limites.
Vous utilisez un pool privé et avez choisi une machine autre que celle par défaut.
Le démarrage de la compilation peut prendre plus de temps, car il peut être nécessaire d'attendre le démarrage d'une nouvelle machine virtuelle. Pour en savoir plus, consultez Types de machines.
Vous pouvez essayer de modifier le type de machine.
Vous utilisez un pool privé et avez spécifié une plage d'adresses IP pour le pool.
La plage physique d'adresses IP détermine le nombre de VM de nœuds de calcul dans le pool, et donc la limite de compilations simultanées, même si elle est inférieure au quota de compilations simultanées. Les builds sont mis en file d'attente si aucune VM de nœud de calcul n'est disponible dans le pool.
Cela se produit lorsque les adresses IP disponibles dans le sous-réseau désigné sont entièrement utilisées, ce qui ne laisse aucune adresse à allouer aux nouveaux nœuds de calcul Cloud Build. Essayez d'augmenter la plage du sous-réseau et relancez la compilation.
La connexion à une ressource externe échoue, car aucune adresse IP externe n'est activée
L'erreur suivante s'affiche lorsque vous vous connectez à une ressource externe à partir d'un pool privé :
Failed to connect to <external_domain>: Connection timed out
Les pools privés utilisent des adresses IP externes pour accéder aux ressources sur l'Internet public, telles que les dépôts externes. Lorsque vous créez ou mettez à jour un pool privé, cochez la case pour attribuer des adresses IP externes à votre pool privé. Pour savoir comment créer ou mettre à jour des champs dans votre pool privé, consultez Créer et gérer des pools privés.
Erreur de délai avant expiration d'E/S
L'erreur suivante s'affiche lors de l'exécution d'une compilation :
Timeout - last error: dial tcp IP_ADDRESS: i/o timeout
Cette erreur peut se produire lorsque votre compilation tente d'accéder à des ressources d'un réseau privé, mais échoue. Par défaut, les builds exécutés à l'aide de Cloud Build peuvent accéder aux ressources privées sur l'Internet public, telles que les ressources d'un dépôt ou d'un registre. Toutefois, les builds ne peuvent accéder aux ressources d'un réseau privé que si vous utilisez des pools privés et que vous les configurez pour accéder au réseau privé. Consultez Utiliser Cloud Build dans un réseau privé.
Expiration du délai d'attente des nœuds de calcul d'un pool privé lors du clonage à partir d'un serveur GitHub Enterprise interne
Lors de l'exécution d'un build dans un pool privé qui clone le code source à partir d'un serveur GitHub Enterprise interne ou sur site, l'étape de compilation échoue avec des erreurs de délai avant expiration de la connexion semblables aux suivantes :
fatal: unable to access 'https://github.example.com/org/repo.git/': Failed to connect to github.example.com port 443: Connection timed out
ou :
fatal: unable to access 'https://github.example.com/org/repo.git/': Could not resolve host: github.example.com
Pour résoudre les délais avant expiration de la connexion entre les nœuds de calcul du pool privé et votre serveur GitHub Enterprise interne, vérifiez les conditions préalables suivantes concernant le réseau et le routage :
Exporter des routes personnalisées via l'appairage Service Networking : les pools privés s'exécutent dans un réseau de producteur de services géré par Google, appairé à votre réseau cloud privé virtuel (VPC) à l'aide de Service Networking (
servicenetworking-googleapis-com). Par défaut, l'appairage de réseaux VPC n'échange que les routes de sous-réseau. Si votre serveur GitHub Enterprise est hébergé sur site ou sur un réseau externe accessible via Cloud VPN ou Cloud Interconnect, les routes dynamiques apprises par Cloud Router ou les routes statiques personnalisées de votre réseau VPC ne sont pas automatiquement partagées avec le pool privé.Assurez-vous que votre configuration d'appairage de réseaux VPC exporte les routes personnalisées vers le réseau du producteur de services :
gcloud compute networks peerings update servicenetworking-googleapis-com \ --network=VPC_NETWORK \ --export-custom-routesRemplacez
VPC_NETWORKpar le nom du réseau VPC appairé au pool privé. Pour en savoir plus, consultez Options d'échange de routes.Configurer la résolution DNS interne pour les noms d'hôte privés : les VM de nœud de calcul du pool privé ne peuvent pas résoudre les noms d'hôte privés hébergés dans des zones Cloud DNS privées ou des serveurs DNS sur site sans appairage DNS :
- Zone Cloud DNS privée : partagez le suffixe DNS avec le réseau du producteur Service Networking à l'aide de l'appairage DNS de l'accès aux services privés (
gcloud services peered-dns-domains create). - Serveur DNS sur site : configurez à la fois une zone de transfert Cloud DNS dans votre réseau VPC et l'appairage DNS de l'accès aux services privés pour le même suffixe DNS. Les requêtes de transfert sortant proviennent de
35.199.192.0/19plutôt que de la plage d'adresses IP du pool privé. Vérifiez donc vos règles de pare-feu et vos routes de retour pour les cibles de type 1 et de type 2.
- Zone Cloud DNS privée : partagez le suffixe DNS avec le réseau du producteur Service Networking à l'aide de l'appairage DNS de l'accès aux services privés (
Vérifiez les règles de pare-feu et les listes d'autorisation d'adresses IP GitHub Enterprise :
- Pare-feu VPC et de périmètre : assurez-vous que les règles de pare-feu de votre réseau VPC et tous les pare-feu sur site intermédiaires autorisent le trafic entrant de la plage d'adresses IP allouée du pool privé vers le serveur GitHub Enterprise sur le port TCP 443 (HTTPS) ou le port 22 (SSH).
- Listes d'autorisation d'adresses IP GitHub Enterprise : si votre organisation ou votre serveur GitHub Enterprise applique une liste d'autorisation d'adresses IP, ajoutez la plage CIDR allouée du sous-réseau d'appairage de votre pool privé à la liste d'autorisation. Si votre pool privé achemine le trafic de sortie via un proxy interne ou une passerelle NAT autogérée, ajoutez plutôt les adresses IP du proxy ou de la passerelle NAT à la liste d'autorisation.
Résoudre le problème d'appairage de réseaux VPC non transitif : l'appairage de réseaux VPC n'est pas transitif. Si votre serveur GitHub Enterprise est déployé dans un réseau VPC secondaire appairé au réseau VPC qui héberge le pool privé, le pool privé ne peut pas accéder à GitHub Enterprise via le réseau VPC intermédiaire. Pour activer la connectivité de bout en bout, connectez les réseaux à l'aide de Cloud VPN, de Cloud Interconnect ou d'un proxy intermédiaire. Pour en savoir plus, consultez Réseau de transit avec plusieurs appairages.
Erreurs de client 4xx
Ce groupe d'erreurs indique que la requête de compilation n'a probablement pas abouti en raison de la défaillance de l'utilisateur qui envoie la requête. Voici quelques exemples d'erreurs client 4xx :
**Error**: 404 : Requested entity was not found**Error**: 404 : Trigger not found**Error**: 400 : Failed Precondition**Error**: 403 : Permission denied
Lorsqu'une erreur client 4xx s'affiche, consultez vos journaux de compilation pour vérifier s'ils contiennent plus d'informations sur les causes de l'erreur. Voici quelques causes courantes d'erreurs client :
- L'emplacement source que vous avez spécifié n'a aucun nouvel élément à valider et l'arborescence de travail est propre. Dans ce cas, vérifiez l'emplacement de votre code source et relancez la compilation.
- Votre dépôt ne contient pas de fichier de configuration de compilation. Dans ce cas, importez un fichier de configuration de compilation dans votre dépôt, puis exécutez à nouveau la compilation.
- Vous avez spécifié un ID de déclencheur incorrect.
- Vous avez récemment ajouté un dépôt après avoir installé l'application GitHub, et Cloud Build n'est pas autorisé à accéder à ce nouveau dépôt. Dans ce cas, connectez votre nouveau dépôt à Cloud Build.
- Vous devez accorder une autre autorisation à votre compte de service de compilation.
Échec de la compilation en raison de restrictions de quota
L'erreur suivante s'affiche, indiquant qu'un build échoue en raison de restrictions de quota dans une région particulière :
Failed to trigger build: generic::failed_precondition: due to quota restrictions, cannot run builds in this region. Please contact support.
Contactez Cloud Customer Care pour augmenter vos quotas pour cette région spécifique.
Problèmes de délai d'expiration lors de l'extraction d'images du registre Docker
Les erreurs de délai avant expiration suivantes s'affichent dans votre journal Cloud Build après l'exécution d'un build :
Step #0: Pulling image: python:3.8.16-alpine3.17
Step #0: Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)
Step 1/7 : FROM python:3.8.16-alpine3.17
Get "https://registry-1.docker.io/v2/": dial tcp 34.205.13.154:443: i/o timeout
Pour résoudre l'erreur, téléchargez l'image Docker à l'aide de crane, puis chargez-la sur l'image Docker Cloud Build.
Ajoutez l'extrait suivant à votre fichier cloudbuild.yaml.
...
# Crane runs as a regular user so we need to allow it to access the directory where it saves the image.
- name: gcr.io/cloud-builders/docker
args:
- a+w
- /workspace
entrypoint: chmod
# Use crane to download the image through the proxy
- name: gcr.io/go-containerregistry/crane
env: - 'HTTPS_PROXY=HTTPS_PROXY'
args:
- pull
- 'python:3.8.16-alpine3.17'
- /workspace/image.tar
# Use docker load to add the image into the local Cloud Build registry
- name: gcr.io/cloud-builders/docker
args: [load, --input, "/workspace/image.tar"]
- .
HTTPS_PROXY: adresse de votre proxy HTTP (par exemple,https://proxy.example.com:8888/).
Une fois l'image chargée, vos étapes cloudbuid.yaml existantes devraient fonctionner normalement, par exemple :
...
- name: python:3.8.16-alpine3.17
args:
- echo
- hello
entrypoint: bash
# Or use it internally on a Dockerfile
- name: gcr.io/cloud-builders/docker
args:
- build
Erreurs Unauthenticated pour les étapes Docker de longue durée
Les étapes de compilation qui impliquent une commande Docker s'exécutant pendant plus d'une heure (par exemple, l'envoi d'une image volumineuse vers Artifact Registry) peuvent échouer avec une erreur d'authentification. Cloud Build actualise les jetons d'authentification toutes les heures, mais il est possible que Docker ne récupère pas ces nouveaux jetons, ce qui entraîne des problèmes d'authentification. Vous pouvez écrire votre propre jeton avec une durée de vie personnalisée dans un fichier et le référencer pour les commandes Docker.
Builds mis en file d'attente dans un pool privé appairé à un réseau VPC
Lorsque vous exécutez des builds dans un pool privé dont le réseau du producteur de services est appairé à votre propre réseau VPC, il est important que la connexion privée entre ces deux réseaux reste intacte. Si vous supprimez la connexion privée sur laquelle repose un pool privé, vous risquez de casser ce pool privé. Cela peut se traduire par des compilations qui restent en file d'attente jusqu'à ce qu'elles expirent. Par conséquent, si vous souhaitez supprimer une connexion privée, veillez à supprimer également tous les pools privés dont le réseau du producteur de services était connecté à votre propre réseau VPC à l'aide de cette connexion privée.
Tentative d'approbation ou de rejet de builds en attente datant de plus de deux mois
Vous ne pouvez pas approuver ni rejeter les builds en attente datant de plus de deux mois. Si vous essayez de le faire, un message d'erreur semblable à celui-ci peut s'afficher :
404, "message": "Requested entity was not
found.", "status": "NOT_FOUND" } }
Si cela se produit, essayez d'envoyer une nouvelle compilation.
Échec de la création du pool privé : le pool de nœuds de calcul n'est pas appairé à l'API Service Networking
Vous avez essayé de créer un pool privé. Cependant, vous recevez le message d'erreur suivant :
Failed to create private pool private-worker-pool: generic::failed_precondition: network "projects/PROJECT_NAME/global/networks/vpc-scmdev-lab-vpc" is not peered to the Service Networking API; please check your configuration and the documentation for troubleshooting and setting up your pool
Pour que les builds puissent accéder aux ressources privées de votre réseau cloud privé virtuel, vous devez configurer une connexion d'appairage entre votre réseau cloud privé virtuel et le réseau cloud privé virtuel où résident les pools privés. Pour obtenir des instructions, consultez Configurer une connexion privée entre votre réseau VPC et le réseau du producteur de services.
Échec de la création du pool privé : impossible d'accéder à la configuration peered_network
Si vous utilisez un VPC partagé ou si vous avez déjà supprimé l'agent de service Service Networking, la création du pool privé peut échouer avec une erreur semblable à celle-ci :
generic::permission_denied: cannot access peered_network config.
Pour résoudre ce problème, assurez-vous que l'agent de service Service Networking (service-PROJECT_NUMBER@service-networking.) existe dans votre projet de service et dispose des autorisations nécessaires.
Créez le compte de service s'il est manquant :
gcloud beta services identity create \
--service=servicenetworking.googleapis.com \
--project=PROJECT_ID
Attribuez au compte de service le rôle roles/servicenetworking.serviceAgent requis :
gcloud projects add-iam-policy-binding PROJECT_ID \
--member="serviceAccount:service-PROJECT_NUMBER@service-networking." \
--role="roles/servicenetworking.serviceAgent"
Étapes suivantes
- Découvrez comment gérer les journaux de compilation.
Les journaux de compilation s'affichent dans le désordre
Vous avez exécuté des étapes de compilation qui génèrent des journaux et vous avez remarqué que les journaux stderr (erreur) apparaissent dans l'interface utilisateur avant les journaux stdout (sortie standard) correspondants. Les journaux n'apparaissent pas dans l'ordre chronologique.
Cet ordre correspond au comportement standard de mise en mémoire tampon des flux Linux et Docker. Lorsque le code s'exécute dans un environnement non TTY, comme un conteneur de compilation, stdout est mis en mémoire tampon par bloc (retardé jusqu'à ce que la mémoire tampon se remplisse), tandis que stderr reste non mis en mémoire tampon (s'affiche immédiatement).
Pour contourner cette méthode de classement et garantir un classement strict des journaux, vous devez explicitement désactiver la mise en mémoire tampon dans l'environnement d'exécution de votre étape de compilation.
Python : définissez la variable d'environnement PYTHONUNBUFFERED :
yaml
steps:
- name: 'python:3'
env: ['PYTHONUNBUFFERED=1']
script: |
python main.py
Scripts C/C++ et Bash :
Utilisez la commande stdbuf pour forcer la mise en mémoire tampon des lignes :
yaml
steps:
- name: 'ubuntu'
script: |
stdbuf -oL ./your_binary
Java :
Java ne permet pas de désactiver la mise en mémoire tampon de manière native à l'aide d'un flag, mais vous pouvez forcer un vidage immédiat dans votre code après les instructions de journalisation critiques :
java
System.out.println("Log message");
System.out.flush();