Questa pagina fornisce strategie di risoluzione dei problemi e soluzioni per alcuni messaggi di errore comuni che potresti visualizzare durante l'esecuzione di una build.
Hai esaminato i log di build?
Utilizza i log di build di Logging o Cloud Storage per ottenere maggiori informazioni sull'errore di build. I log scritti in stdout o stderr sono visualizzabili utilizzando la console Google Cloud e gcloud CLI.
Le build manuali non vanno a buon fine perché l'utente non ha accesso ai log di build
Viene visualizzato il seguente errore quando provi a eseguire una build manualmente:
AccessDeniedAccess denied. [EMAIL_ADDRESS] does not have storage.objects.get access to the Google Cloud Storage object.
Questo errore viene visualizzato perché Cloud Build richiede che gli utenti che eseguono build manuali e utilizzano il bucket di log Cloud Storage predefinito abbiano il ruolo IAM Visualizzatore progetto oltre al ruolo Cloud Build Editor. Per risolvere questo errore, puoi procedere in uno dei seguenti modi:
Utilizza il bucket di log predefinito e concedi il ruolo Visualizzatore progetto e il ruolo Cloud Build Editor all'utente che esegue la build. Per istruzioni su come concedere questa autorizzazione, consulta Configura l'accesso alle risorse Cloud Build.
Crea il tuo bucket Cloud Storage per archiviare i log. Per istruzioni, consulta Archiviazione dei log di build in un bucket creato dall'utente.
Le build non vanno a buon fine a causa dell'autorizzazione iam.serviceAccounts.actAs mancante
Quando provi a eseguire il deployment di una build utilizzando un servizio gestito come Cloud Run o App Engine, viene visualizzato il seguente errore:
Missing necessary permission iam.serviceAccounts.actAs for [USER] on the service account [SERVICE ACCOUNT]
Per risolvere questo errore, configura il service account Cloud Build specificato o il service account Cloud Build predefinito in modo che utilizzi l'identità del account di servizio del servizio gestito che utilizzi per la build. Per saperne di più su questa attività, consulta Configura la simulazione dell'identità dei account di servizio Cloud Build per i servizi gestiti.
Per ulteriori informazioni sui service account e sulle autorizzazioni, consulta i seguenti argomenti:
- Configura i service account specificati dall'utente
- Service account predefinito di Cloud Build
- Informazioni sui ruoli IAM
- Concessione delle autorizzazioni al service account predefinito di Cloud Build
Errore di autorizzazione negata durante il deployment in Cloud Run Functions
Quando provi a utilizzare Cloud Run Functions, viene visualizzato il seguente errore:
ResponseError: status=[403], code=[Ok], message=[Permission 'cloudfunctions.functions.get' denied]
Per risolvere questo errore, concedi il ruolo Cloud Run Functions Developer al service account di build.
Il trigger di build non riesce a causa dell'autorizzazione cloudbuild.builds.create mancante
Quando esegui un trigger di build, viene visualizzato un errore simile al seguente:
Failed to trigger build: Permission 'cloudbuild.builds.create' denied on resource 'projects/xxxxxxxx' (or it may not exist)
I trigger di build utilizzano un account di servizio per creare una build. Questo errore indica che al account di servizio manca l'autorizzazione IAM cloudbuild.builds.create, necessaria per eseguire un trigger di build. Puoi risolvere questo errore concedendo il ruolo IAM Cloud Build Service Account al tuo service account specificato dall'utente o al service account predefinito.
Invio della build non riuscito a causa di autorizzazioni mancanti per l'agente di servizio
Se l'agente di servizio Cloud Build viene eliminato o non dispone delle autorizzazioni, potrebbe verificarsi il seguente errore durante l'invio di una build.
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.
Il chiamante in questo scenario è l'agente di servizio Cloud Build. Per risolvere questo problema relativo alle autorizzazioni, segui questi passaggi:
Assicurati che l'agente di servizio Cloud Build esista. Puoi visualizzare l'agente di servizio per un progetto andando alla pagina IAM nella console Google Cloud e selezionando la casella di controllo Mostra gli account di servizio gestiti da Google. Se non è presente, puoi crearla eseguendo questo comando gcloud CLI:
gcloud beta services identity create --service=cloudbuild.googleapis.com \ --project=PROJECT_IDPoi, concedi il ruolo IAM
roles/cloudbuild.serviceAgentall'agente di servizio Cloud Build:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudbuild." \ --role="roles/cloudbuild.serviceAgent"
Se vuoi verificare quale identità IAM potrebbe essere responsabile del problema relativo alle autorizzazioni dell'agente di servizio, segui questi passaggi:
Apri Esplora log nella console Google Cloud :
Inserisci il seguente testo nel campo della query:
resource.type="project" log_name="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity" "service-PROJECT_NUMBER@gcp-sa-cloudbuild."Se vedi voci di log dopo aver utilizzato questa query, controlla se qualcuna di queste rimuove le autorizzazioni dall'agente di servizio (
service-PROJECT_NUMBER@gcp-sa-cloudbuild.). In tal caso, controlla ilprotoPayload.authenticationInfo.principalEmailin quel log per determinare l'identità IAM responsabile della rimozione dell'autorizzazione o del ruoloroles/cloudbuild.serviceAgentcontenente l'autorizzazione elencata nel messaggio di errore.
Il trigger non va a buon fine con l'errore Couldn't read commit
Quando esegui un trigger di build, viene visualizzato il seguente errore:
Failed to trigger build: Couldn't read commit
Cloud Build restituisce questo messaggio se stai tentando di attivare una build utilizzando un branch che non esiste. Controlla l'ortografia e la coerenza dei nomi delle directory. Per istruzioni sulla configurazione dei trigger, consulta Crea e gestisci i trigger di build.
Impossibile creare il trigger Pub/Sub
Quando crei un trigger Pub/Sub, viene visualizzato il seguente errore:
Failed to create trigger: Request is prohibited by organization's policy
Questo errore indica che l'API Pub/Sub è limitata nel tuo progetto. I progetti che limitano l'API Pub/Sub limitano la possibilità di creare sottoscrizioni push. Per risolvere l'errore, puoi rimuovere temporaneamente Pub/Sub dai servizi limitati nel tuo perimetro, creare il trigger e limitare nuovamente l'API Pub/Sub.
Impossibile eseguire il pull o il recupero dei branch da un repository privato a causa dell'errore: fatal: could not read Username
Quando provi a eseguire un git pull o un git fetch su un branch remoto da un repository privato, viene visualizzato il seguente errore:
fatal: could not read Username for '<REMOTE_URL>': No such device or address
Questo errore è previsto nei repository privati, poiché l'helper delle credenziali git viene rimosso intenzionalmente dopo la clonazione iniziale del repository. Per recuperare i rami remoti da un repository privato, configura manualmente le credenziali di autorizzazione (token API, chiavi SSH) come passaggio di build. Scopri di più sull'accesso ai repository GitHub privati.
Le build non vanno a buon fine a causa di un'autorizzazione SSH non valida
Quando esegui una build, viene visualizzato il seguente errore:
Could not parse ssh: [default]: invalid empty ssh-agent socket, make sure SSH_AUTH_SOCK is set
Questo errore indica un problema con l'autorizzazione SSH. Un esempio comune è l'errore di autorizzazione SSH che si verifica quando si accede ai repository GitHub privati con Cloud Build. Per istruzioni sulla configurazione di SSH per GitHub, consulta Accesso ai repository privati GitHub.
Le build non vanno a buon fine a causa dell'errore No route to host
Quando esegui una build in un pool privato, viene visualizzato il seguente errore o un errore simile:
Unable to connect to the server: dial tcp 192.168.10.XX:<port>: connect: no route to host
Cloud Build esegue i suoi builder Cloud sulla macchina virtuale nel progetto gestito da Google utilizzando i container Docker. All'interfaccia bridge Docker (e di conseguenza ai container connessi a questa interfaccia) viene assegnato un intervallo IP di 192.168.10.0/24, il che rende impossibile la comunicazione con gli host esterni nella stessa subnet. Quando allochi gli intervalli IP per le risorse nei tuoi progetti durante la configurazione del pool privato, ti consigliamo di selezionare un intervallo esterno a 192.168.10.0/24. Per istruzioni, consulta Configurazione dell'ambiente per i pool privati.
Le build non vanno a buon fine e viene visualizzato il messaggio di errore "Scaduto" senza log
Attivi o invii una build che non va a buon fine, generando un errore "Scaduto" e nessun log.
Controlla quanto segue nella configurazione:
Hai configurato un valore
queueTtlinferiore (ad es. 20 secondi).Aumenta il valore nello schema ed esegui di nuovo la build. Per saperne di più, consulta
queueTtl.Hai raggiunto la quota per le build simultanee.
Puoi richiedere un aumento tramite la pagina Quote della console Google Cloud . Per maggiori dettagli, consulta Quote e limiti.
Stai utilizzando un pool privato e hai scelto la macchina non predefinita.
L'avvio della build può richiedere più tempo perché potrebbe essere necessario attendere l'avvio di una nuova macchina virtuale. Per saperne di più, consulta Tipi di macchine.
Puoi provare a modificare il tipo di macchina.
Stai utilizzando un pool privato e hai specificato un intervallo IP per il pool.
L'intervallo fisico di IP determina il numero di VM worker nel pool e, di conseguenza, il limite di build simultanee, anche se è inferiore alla quota di build simultanee. Le build vengono messe in coda se non sono disponibili VM worker nel pool.
Questo accade quando gli indirizzi IP disponibili all'interno della subnet designata sono completamente utilizzati, senza lasciare indirizzi da allocare ai nuovi worker Cloud Build. Prova ad aumentare l'intervallo nella subnet ed esegui nuovamente la build.
La connessione alla risorsa esterna non riesce perché non è abilitato un indirizzo IP esterno
Quando ti connetti a una risorsa esterna da un pool privato, viene visualizzato il seguente errore:
Failed to connect to <external_domain>: Connection timed out
I pool privati utilizzano IP esterni per accedere alle risorse su internet pubblico, ad esempio i repository esterni. Quando crei o aggiorni un pool privato, seleziona la casella per assegnare indirizzi IP esterni al pool privato. Per istruzioni sulla creazione o sull'aggiornamento dei campi all'interno del pool privato, consulta Creazione e gestione dei pool privati.
Errore di timeout I/O
Quando esegui una build, viene visualizzato il seguente errore:
Timeout - last error: dial tcp IP_ADDRESS: i/o timeout
Questo errore può verificarsi quando la build tenta di accedere alle risorse in una rete privata, ma non riesce. Per impostazione predefinita, le build eseguite utilizzando Cloud Build possono accedere alle risorse private su internet pubblico, ad esempio le risorse in un repository o un registry. Tuttavia, le build possono accedere alle risorse in una rete privata solo se utilizzi pool privati e li configuri per accedere alla rete privata. Consulta Utilizzo di Cloud Build in una rete privata.
Timeout dei worker del pool privato durante la clonazione da un server GitHub Enterprise interno
Quando esegui una build in un pool privato che clona il codice sorgente da un server GitHub Enterprise interno o on-premise, il passaggio di build non riesce con errori di timeout della connessione simili ai seguenti:
fatal: unable to access 'https://github.example.com/org/repo.git/': Failed to connect to github.example.com port 443: Connection timed out
oppure:
fatal: unable to access 'https://github.example.com/org/repo.git/': Could not resolve host: github.example.com
Per risolvere i timeout di connessione tra i worker del pool privato e il tuo server GitHub Enterprise interno, verifica i seguenti prerequisiti di rete e routing:
Esporta route personalizzate nel peering di Service Networking: i pool privati vengono eseguiti in una rete di producer di servizi gestita da Google in peering con la tua rete Virtual Private Cloud (VPC) utilizzando Service Networking (
servicenetworking-googleapis-com). Per impostazione predefinita, il peering di rete VPC scambia solo route di subnet. Se il tuo server GitHub Enterprise è ospitato on-premise o in una rete esterna raggiunta utilizzando Cloud VPN o Cloud Interconnect, le route dinamiche apprese dal router Cloud o le route statiche personalizzate nella tua rete VPC non vengono condivise automaticamente con il pool privato.Assicurati che la configurazione del peering di rete VPC esporti le route personalizzate nella rete del producer di servizi:
gcloud compute networks peerings update servicenetworking-googleapis-com \ --network=VPC_NETWORK \ --export-custom-routesSostituisci
VPC_NETWORKcon il nome della rete VPC in peering con il pool privato. Per saperne di più, consulta Opzioni di scambio di route.Configura la risoluzione DNS interna per i nomi host privati: le VM worker dei pool privati non possono risolvere i nomi host privati ospitati in zone Cloud DNS private o server DNS on-premise senza peering DNS:
- Zona Cloud DNS privata: condividi il suffisso DNS con la rete producer di Service Networking utilizzando il peering DNS per l'accesso privato ai servizi (
gcloud services peered-dns-domains create). - Server DNS on-premise: Configura sia una zona di inoltro Cloud DNS nella tua rete VPC sia un peering DNS di accesso privato ai servizi per lo stesso suffisso DNS. Le query di forwarding in uscita provengono da
35.199.192.0/19anziché dall'intervallo IP del pool privato, quindi verifica le regole firewall e le route di ritorno per i target Tipo 1 e Tipo 2.
- Zona Cloud DNS privata: condividi il suffisso DNS con la rete producer di Service Networking utilizzando il peering DNS per l'accesso privato ai servizi (
Verifica le regole firewall e le liste consentite di IP di GitHub Enterprise:
- Firewall VPC e perimetrali: assicurati che le regole firewall nella tua rete VPC e gli eventuali firewall on-premise intermedi consentano il traffico in entrata dall'intervallo di indirizzi IP allocato del pool privato al server GitHub Enterprise sulla porta TCP 443 (HTTPS) o sulla porta 22 (SSH).
- Liste consentite di IP di GitHub Enterprise: se la tua organizzazione o il tuo server GitHub Enterprise applica una lista consentita di IP, aggiungi l'intervallo CIDR allocato della subnet di peering del tuo pool privato alla lista consentita. Se il tuo pool privato instrada il traffico in uscita tramite un proxy interno o un gateway NAT autogestito, aggiungi alla lista consentita gli indirizzi IP del proxy o del NAT.
Risolvi il problema del peering di rete VPC non transitivo: il peering di rete VPC non è transitivo. Se il server GitHub Enterprise è distribuito in una rete VPC secondaria in peering con la rete VPC che ospita il pool privato, quest'ultimo non può raggiungere GitHub Enterprise tramite la rete VPC intermedia. Per abilitare la connettività end-to-end, connetti le reti utilizzando Cloud VPN, Cloud Interconnect o un proxy intermedio. Per saperne di più, consulta Rete di transito con più peering.
Errori client 4xx
Questo gruppo di errori indica che la richiesta di build non è andata a buon fine, presumibilmente per un errore dell'utente che ha inviato la richiesta. Alcuni esempi di errori client 4xx sono:
**Error**: 404 : Requested entity was not found**Error**: 404 : Trigger not found**Error**: 400 : Failed Precondition**Error**: 403 : Permission denied
Quando visualizzi un errore 4xx del client, controlla i log di build per vedere se contengono ulteriori informazioni sul motivo dell'errore. Alcune cause comuni degli errori del client includono:
- La località di origine specificata non ha nuovi elementi di cui eseguire il commit e l'albero di lavoro è pulito. In questo caso, controlla la posizione del codice sorgente e riprova a eseguire la build.
- Il tuo repository non contiene un file di configurazione di compilazione. In questo caso, carica un file di configurazione di build nel repository ed esegui di nuovo la build.
- Hai specificato un ID trigger errato.
- Di recente hai aggiunto un nuovo repository dopo aver installato l'app GitHub e Cloud Build non dispone delle autorizzazioni per accedere al nuovo repository. In questo caso, connetti il nuovo repository a Cloud Build.
- Devi concedere un'altra autorizzazione al tuo account di servizio di build.
La build non riesce a causa di limitazioni della quota
Viene visualizzato il seguente errore, che indica che una build non va a buon fine a causa di limitazioni della quota in una determinata regione:
Failed to trigger build: generic::failed_precondition: due to quota restrictions, cannot run builds in this region. Please contact support.
Contatta l'assistenza clienti Google Cloud per aumentare le quote per questa regione specifica.
Problemi di timeout durante il pull delle immagini dal registry Docker
Dopo aver eseguito una build, nel log di Cloud Build vengono visualizzati i seguenti errori di timeout:
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
Per risolvere l'errore, scarica l'immagine Docker utilizzando crane e procedi con il caricamento dell'immagine nell'immagine Docker di Cloud Build.
Aggiungi il seguente snippet al file 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: l'indirizzo del proxy HTTP (ad es.https://proxy.example.com:8888/).
Una volta caricata l'immagine, i passaggi cloudbuid.yaml esistenti dovrebbero funzionare normalmente, ad esempio:
...
- 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
Errori Unauthenticated per i passaggi Docker a lunga esecuzione
I passaggi di build che prevedono un comando Docker eseguito per più di un'ora (ad esempio il push di un'immagine di grandi dimensioni in Artifact Registry) potrebbero non riuscire con un errore di autenticazione. Cloud Build aggiorna i token di autenticazione ogni ora, ma Docker potrebbe non riuscire a rilevare questi nuovi token, causando problemi di autenticazione. Puoi scrivere il tuo token con una durata personalizzata nel file e farvi riferimento per i comandi Docker.
Build in coda in un pool privato in peering con una rete VPC
Quando esegui build in un pool privato in cui è stato eseguito il peering della rete del producer di servizi con la tua rete VPC, è importante che la connessione privata tra queste due reti rimanga intatta. Se elimini la connessione privata su cui si basava un pool privato, puoi interrompere il pool privato. Questo può manifestarsi con build che rimangono in coda fino al timeout. Pertanto, se vuoi eliminare una connessione privata, assicurati di eliminare anche tutti i pool privati la cui rete del producer di servizi era connessa alla tua rete VPC utilizzando questa connessione privata.
Tentativo di approvare o rifiutare build in attesa risalenti a più di 2 mesi fa
Non puoi approvare o rifiutare build in attesa risalenti a più di 2 mesi fa. Se provi a farlo, potresti visualizzare un messaggio di errore simile al seguente:
404, "message": "Requested entity was not
found.", "status": "NOT_FOUND" } }
In questo caso, prova a inviare una nuova build.
Impossibile creare il pool privato: il pool di worker non è in peering con l'API Service Networking
Hai provato a creare un pool privato. Tuttavia, ricevi il seguente messaggio di errore:
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
Affinché le build possano accedere alle risorse private dalla tua rete Virtual Private Cloud, devi configurare una connessione in peering tra la tua rete Virtual Private Cloud e la rete Virtual Private Cloud in cui risiedono i pool privati. Per istruzioni, consulta Configurazione di una connessione privata tra la tua rete VPC e la rete del producer di servizi.
Impossibile creare il pool privato: impossibile accedere alla configurazione peered_network
Se utilizzi un VPC condiviso o hai eliminato in precedenza l'agente di servizio Service Networking, la creazione del pool privato potrebbe non riuscire con un errore simile al seguente:
generic::permission_denied: cannot access peered_network config.
Per risolvere il problema, assicurati che l'agente di servizio Service Networking (service-PROJECT_NUMBER@service-networking.) esista nel tuo progetto di servizio e disponga delle autorizzazioni necessarie.
Crea il account di servizio se non esiste:
gcloud beta services identity create \
--service=servicenetworking.googleapis.com \
--project=PROJECT_ID
Concedi al account di servizio il ruolo roles/servicenetworking.serviceAgent richiesto:
gcloud projects add-iam-policy-binding PROJECT_ID \
--member="serviceAccount:service-PROJECT_NUMBER@service-networking." \
--role="roles/servicenetworking.serviceAgent"
Passaggi successivi
- Scopri come gestire i log di build.
I log di build non vengono visualizzati nell'ordine corretto
Hai eseguito i passaggi di build che generano log e hai notato che i log stderr (errore) vengono visualizzati nella UI prima dei corrispondenti log stdout (output standard). I log non vengono visualizzati in ordine cronologico.
Questo ordine è il comportamento standard di buffering degli stream di Linux e Docker. Quando il codice viene eseguito in un ambiente non TTY, come un container di build, stdout viene memorizzato nel buffer di blocco (ritardato fino al riempimento del buffer), mentre stderr rimane non memorizzato nel buffer (stampa immediatamente).
Per bypassare questo metodo di ordinamento e garantire un ordinamento rigoroso dei log, devi disattivare esplicitamente il buffering nell'ambiente di esecuzione del passaggio di build.
Python:
Imposta la variabile di ambiente PYTHONUNBUFFERED:
yaml
steps:
- name: 'python:3'
env: ['PYTHONUNBUFFERED=1']
script: |
python main.py
Script C/C++ e Bash:
Utilizza il comando stdbuf per forzare il buffering di riga:
yaml
steps:
- name: 'ubuntu'
script: |
stdbuf -oL ./your_binary
Java:
Java non supporta in modo nativo la disattivazione del buffering tramite un flag, ma puoi forzare uno svuotamento immediato nel codice dopo le istruzioni di log critiche:
java
System.out.println("Log message");
System.out.flush();