Risoluzione degli errori di build e altro ancora

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:

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:

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:

  1. 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_ID
    
  2. Poi, concedi il ruolo IAM roles/cloudbuild.serviceAgent all'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:

  1. Apri Esplora log nella console Google Cloud :

    Vai a Esplora log

  2. 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."
    
  3. 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 il protoPayload.authenticationInfo.principalEmail in quel log per determinare l'identità IAM responsabile della rimozione dell'autorizzazione o del ruolo roles/cloudbuild.serviceAgent contenente 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 queueTtl inferiore (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-routes
    

    Sostituisci VPC_NETWORK con 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:

  • 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

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();