Risoluzione dei problemi AWS CodeBuild

Utilizza le informazioni in questo argomento per individuare, diagnosticare e risolvere problemi. Per informazioni su come registrare e monitorare CodeBuild le build per risolvere i problemi, consulta. Registrazione di log e monitoraggio

Apache Maven compila artefatti di riferimento dal repository errato

Problema: quando usi Maven con un ambiente di compilazione Java AWS CodeBuild fornito, Maven estrae le dipendenze di build e plugin dal repository centrale sicuro di Maven all'indirizzo. https://repo1.maven.org/maven2 Ciò avviene anche se il file pom.xml del progetto di compilazione dichiara esplicitamente altre posizioni alternative da utilizzare.

Possibile causa: gli ambienti di compilazione CodeBuild-provided Java includono un file denominato settings.xml preinstallato nella directory dell'ambiente di compilazione. /root/.m2 Questo settings.xml file contiene le seguenti dichiarazioni, che indicano a Maven di estrarre sempre le dipendenze di build e plugin dal repository centrale sicuro di Maven all'indirizzo. https://repo1.maven.org/maven2

<settings>
  <activeProfiles>
    <activeProfile>securecentral</activeProfile>
  </activeProfiles>
  <profiles>
    <profile>
      <id>securecentral</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>https://repo1.maven.org/maven2</url>
          <releases>
            <enabled>true</enabled>
          </releases>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>central</id>
          <url>https://repo1.maven.org/maven2</url>
          <releases>
            <enabled>true</enabled>
          </releases>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
</settings>

Soluzione consigliata: procedi come segue:

I comandi di compilazione vengono eseguiti come root per impostazione predefinita

Problema: AWS CodeBuild esegue i comandi di compilazione come utente root. Ciò avviene anche se il Dockerfile dell'immagine di compilazione correlata imposta l'istruzione USER su un altro utente.

Causa: per impostazione predefinita, CodeBuild esegue tutti i comandi di compilazione come utente root.

Soluzione consigliata: nessuna.

Le compilazioni potrebbero fallire se i nomi dei file sono contrassegnati da un valore diverso da-. U.S caratteri non appartenenti alla lingua inglese (Stati Uniti)

Problema: quando si esegue una build che utilizza file con nomi di file che contengono non-U.S. caratteri non appartenenti alla lingua inglese (Stati Uniti) (ad esempio, caratteri cinesi), la compilazione non riesce.

Possibile causa: le impostazioni locali predefinite degli ambienti di compilazione forniti da AWS CodeBuild sono impostate suPOSIX. POSIXle impostazioni di localizzazione sono meno compatibili CodeBuild e i nomi di file che contengono non-U.S. caratteri non appartenenti alla lingua inglese (Stati Uniti) e possono causare l'esito negativo delle compilazioni correlate.

Soluzione consigliata: aggiungi i seguenti comandi alla sezione pre_build del file buildspec. Questi comandi utilizzano U.S l'ambiente di compilazione. Inglese UTF-8 per le sue impostazioni di localizzazione, che è più compatibile con CodeBuild e i nomi di file che contengono non-U.S. alla lingua inglese (Stati Uniti).

Per gli ambienti di compilazione basati su Ubuntu:

pre_build:
  commands:
    - export LC_ALL="en_US.UTF-8"
    - locale-gen en_US en_US.UTF-8
    - dpkg-reconfigure -f noninteractive locales

Per ambienti di compilazione basati su Amazon Linux:

pre_build:
  commands:
    - export LC_ALL="en_US.utf8"

Le build potrebbero fallire quando si ottengono i parametri da Amazon EC2 Parameter Store

Problema: quando una build tenta di ottenere il valore di uno o più parametri archiviati in Amazon EC2 Parameter Store, la compilazione ha esito negativo nella DOWNLOAD_SOURCE fase con l'errore. Parameter does not exist

Possibile causa: il ruolo di servizio su cui si basa il progetto di compilazione non dispone dell'autorizzazione per richiamare l'ssm:GetParametersazione oppure il progetto di compilazione utilizza un ruolo di servizio generato da AWS CodeBuild e che consente di richiamare l'ssm:GetParametersazione, ma i parametri hanno nomi che non iniziano con. /CodeBuild/

Soluzioni consigliate:

Impossibile accedere al filtro delle filiali nella console CodeBuild

Problema: l'opzione di filtro per le filiali non è disponibile nella console quando si crea o si aggiorna un AWS CodeBuild progetto.

Possibile causa: l'opzione di filtro dei rami è obsoleto. È stata sostituita dai gruppi di filtri di webhook, che offrono maggiore controllo sugli eventi webhook che attivano una nuova compilazione in CodeBuild.

Soluzione consigliata: per effettuare la migrazione di un filtro dei rami creato prima dell'introduzione dei filtri di webhook, creare un gruppo di filtri di webhook contenente un filtro HEAD_REF con l'espressione regolare ^refs/heads/branchName$. Ad esempio, se l'espressione regolare del tuo filtro dei rami era ^branchName$, l'espressione regolare aggiornata da inserire nel filtro HEAD_REF sarà ^refs/heads/branchName$. Per ulteriori informazioni, consulta Eventi webhook Bitbucket e Filtra gli eventi GitHub webhook (console).

Impossibile visualizzare l'esito positivo o negativo della compilazione

Problema: non riesci a visualizzare se una compilazione ripetuta ha avuto esito positivo o negativo.

Possibile causa: l'opzione per la segnalazione dello stato della compilazione non è abilitata.

Soluzioni consigliate: abilita lo stato di creazione del report quando crei o aggiorni un CodeBuild progetto. Questa opzione indica ad CodeBuild di segnalare lo stato quando si attiva una compilazione. Per ulteriori informazioni, consulta il report BuildStatus nell'AWS CodeBuild API Reference.

Stato della build non segnalato al fornitore di origine

Problema: dopo aver consentito la segnalazione dello stato della build a un provider di origine, come GitHub Bitbucket, lo stato della build non viene aggiornato.

Causa possibile: l'utente associato al provider di origine non ha accesso in scrittura al repository.

Soluzioni consigliate: per poter segnalare lo stato di compilazione al provider di origine, l'utente associato al provider di origine deve avere accesso in scrittura al repository. Se l'utente non dispone dell'accesso in scrittura, lo stato della build non può essere aggiornato. Per ulteriori informazioni, consulta Accesso al provider di origine.

Impossibile trovare e selezionare l'immagine di base della piattaforma Windows Server Core 2019

Problema: non è possibile trovare o selezionare l'immagine di base della piattaforma Windows Server Core 2019.

Causa possibile: stai utilizzando una AWS regione che non supporta questa immagine.

Soluzioni consigliate: utilizzare una delle seguenti AWS regioni in cui è supportata l'immagine di base della piattaforma Windows Server Core 2019:

I comandi precedenti nei file buildspec non vengono riconosciuti dai comandi successivi

Problemi: i risultati di uno o più comandi nel file buildspec non vengono riconosciuti dai comandi successivi nello stesso file buildspec. È ad esempio possibile che un comando imposti una variabile di ambiente locale, ma che una successiva esecuzione del comando non riesca a recuperare il valore di tale variabile di ambiente locale.

Possibile causa: nella versione 0.1 del file buildspec, AWS CodeBuild esegue ogni comando in un'istanza separata della shell predefinita nell'ambiente di compilazione. Questo significa che ogni comando viene eseguito separatamente da tutti gli altri comandi. Per impostazione predefinita, non è dunque possibile eseguire un singolo comando che si basa sullo stato di qualsiasi comando precedente.

Soluzioni consigliate: si consiglia di utilizzare la versione 0.2 di buildspec, che risolve questo problema. Se devi utilizzare la versione 0.1 della specifica di compilazione, ti consigliamo di usare l'operatore di concatenazione del comando shell, ad esempio && in Linux, per combinare più comandi in un singolo comando. In alternativa, includi uno script della shell nel codice sorgente che contiene più comandi, quindi chiama tale script della shell da un singolo comando nel file buildspec. Per ulteriori informazioni, consulta Shell e comandi negli ambienti di compilazione e Variabili di ambiente degli ambienti di compilazione.

Errore "Access denied" (Accesso negato) durante il tentativo di eseguire il download della cache

Problema: quando tenti di scaricare la cache in un progetto di compilazione con la cache abilitata, viene visualizzato l'errore Access denied.

Possibili cause:

Soluzione consigliata: nel caso sia il primo utilizzo, è normale visualizzare questo errore subito dopo l'aggiornamento della configurazione della cache. Se l'errore persiste, verifica se il ruolo del servizio dispone delle autorizzazioni s3:GetObject e s3:PutObject per il bucket S3 con la cache. Per ulteriori informazioni, consulta Specificare le autorizzazioni S3 nella Amazon S3 Developer Guide.

Errore "BUILD_CONTAINER_UNABLE_TO_PULL_IMAGE" durante l'utilizzo di un'immagine di compilazione personalizzata

Problema: quando tenti di eseguire una compilazione che utilizza un'immagine di compilazione personalizzata, la compilazione ha esito negativo e viene restituito l'errore BUILD_CONTAINER_UNABLE_TO_PULL_IMAGE.

Errore: «Il contenitore di compilazione è stato trovato morto prima di completare la compilazione. Il contenitore di compilazione è morto perché la memoria era esaurita o l'immagine Docker non è supportata. ErrorCode: 500"

Problema: quando si tenta di utilizzare un contenitore Microsoft Windows o Linux in AWS CodeBuild, questo errore si verifica durante la fase di PROVISIONING.

Possibili cause:

Soluzioni consigliate:

Errore: "Impossibile connettersi al daemon Docker" quando si esegue una build

Problema: la tua compilazione ha esito negativo e ricevi un errore simile a Cannot connect to the Docker daemon at unix:/var/run/docker.sock. Is the docker daemon running? nel log di compilazione.

Possibile causa: la tua compilazione non è in esecuzione in modalità con privilegi.

Soluzione consigliata: per correggere questo errore, è necessario abilitare la modalità privilegiata e aggiornare il buildspec utilizzando le seguenti istruzioni.

Per eseguire la build in modalità privilegiata, segui questi passaggi:

Dovrai anche avviare il demone Docker all'interno del tuo contenitore. La install fase del tuo buildspec potrebbe essere simile a questa.

phases:
  install:
    commands:
      - nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://127.0.0.1:2375 --storage-driver=overlay2 &
      - timeout 15 sh -c "until docker info; do echo .; sleep 1; done"

Per ulteriori informazioni sui driver di storage OverlayFS a cui si fa riferimento nel file buildspec, consulta Utilizzare il driver di storage OverlayFS nel sito Web Docker.

- timeout -t 15 sh -c "until docker info; do echo .; sleep 1; done"

Per saperne di più su come creare ed eseguire un'immagine Docker utilizzando, vedi. AWS CodeBuildDocker in un esempio di immagine personalizzato per CodeBuild

Errore: "non CodeBuild è autorizzato a eseguire: sts:AssumeRole" durante la creazione o l'aggiornamento di un progetto di compilazione

Problema: quando tenti di creare o aggiornare un progetto di compilazione, viene visualizzato l'errore Code:InvalidInputException, Message:CodeBuild is not authorized to perform: sts:AssumeRole on arn:aws:iam::account-ID:role/service-role-name.

Possibili cause:

Soluzioni consigliate:

Errore: «Errore durante la chiamata GetBucketAcl: il proprietario del bucket è cambiato o il ruolo del servizio non è più autorizzato a chiamare s3:» GetBucketAcl

Problema: quando esegui una build, viene visualizzato un errore circa la modifica della proprietà di un bucket S3 e delle autorizzazioni GetBucketAcl.

Possibile causa: hai aggiunto le s3:GetBucketLocation autorizzazioni s3:GetBucketAcl and al tuo ruolo IAM. Queste autorizzazioni garantiscono la sicurezza del bucket S3 del progetto e garantiscono che solo tu puoi accedervi. Dopo aver aggiunto queste autorizzazioni, il proprietario del bucket S3 cambia.

Soluzione consigliata: verifica di essere il proprietario del bucket S3, quindi aggiungi nuovamente le autorizzazioni al tuo ruolo IAM. Per ulteriori informazioni, consulta Accesso sicuro ai bucket S3.

Errore "Failed to upload artifacts: Invalid arn" (Impossibile caricare artefatti: ARN non valido) durante l'esecuzione di una compilazione

Problema: quando esegui una compilazione , la fase della compilazione UPLOAD_ARTIFACTS non riesce con l'errore Failed to upload artifacts: Invalid arn.

Possibile causa: il bucket di output S3 (il bucket in cui AWS CodeBuild memorizza l'output della build) si trova in una AWS regione diversa dal progetto di compilazione. CodeBuild

Soluzione consigliata: aggiorna le impostazioni del progetto di compilazione in modo che punti a un bucket di output che si trova nella stessa AWS regione del progetto di compilazione.

Errore: «Git clone non riuscito: impossibile accedere 'Il tuo URL del repository': Problema con il certificato SSL: certificato autofirmato»

Problema: quando tenti di eseguire un progetto di compilazione, la compilazione non riesce e restituisce questo errore.

Possibile causa: il repository di origine dispone di un certificato autofirmato, ma non hai scelto l'installazione del certificato dal bucket S3 come parte del progetto di compilazione.

Soluzioni consigliate:

Errore "The bucket you are attempting to access must be addressed using the specified endpoint" (Il bucket a cui tenti di accedere deve essere individuato tramite l'endpoint specificato) durante l'esecuzione di una compilazione

Problema: quando esegui una compilazione , la fase della compilazione DOWNLOAD_SOURCE non riesce con l'errore The bucket you are attempting to access must be addressed using the specified endpoint. Please send all future requests to this endpoint.

Possibile causa: il codice sorgente predefinito è archiviato in un bucket S3 e quel bucket si trova in una regione diversa da quella del progetto di compilazione. AWS AWS CodeBuild

Soluzione consigliata: aggiorna le impostazioni del progetto di compilazione in modo che punti a un bucket contenente il codice sorgente precompilato. Assicurati che il bucket si trovi nella stessa AWS regione del progetto di compilazione.

Errore: "This build image requires selecting at least one runtime version." (Questa immagine di compilazione richiede la selezione di almeno una versione runtime.)

Problema: quando esegui una compilazione , la fase della compilazione DOWNLOAD_SOURCE non riesce con l'errore YAML_FILE_ERROR: This build image requires selecting at least one runtime version.

Causa possibile: la build utilizza la versione 1.0 o successiva dell'immagine standard Amazon Linux 2 (AL2) o la versione 2.0 o successiva dell'immagine standard Ubuntu e un runtime non è specificato nel file buildspec.

Soluzione consigliata: se si utilizza l'immagine aws/codebuild/standard:2.0 CodeBuild gestita, è necessario specificare una versione di runtime nella runtime-versions sezione del file buildspec. Ad esempio, puoi utilizzare il file buildspec seguente per un progetto che utilizza PHP:

version: 0.2

phases:
  install:
    runtime-versions:
        php: 7.3
  build:
    commands:
      - php --version
artifacts:
  files:
    -  README.md

Per ulteriori informazioni, consulta Specify runtime versions in the buildspec file.

Errore: "QUEUED: INSUFFICIENT_SUBNET" quando una compilazione ha esito negativo in una coda di compilazione

Problema: una compilazione in una coda di compilazione ha esito negativo con un errore simile a QUEUED: INSUFFICIENT_SUBNET.

Possibili cause: il blocco CIDR IPv4 specificato per il VPC utilizza un indirizzo IP riservato. I primi quattro indirizzi IP e l'ultimo indirizzo IP in ogni blocco CIDR della sottorete non sono disponibili per l'utilizzo e non possono essere assegnati a un'istanza. Ad esempio, in una sottorete con intervallo CIDR 10.0.0.0/24, i cinque indirizzi IP seguenti sono riservati:

Soluzioni consigliate: controlla se il VPC utilizza un indirizzo IP riservato. Sostituisci qualsiasi indirizzo IP riservato con uno non riservato. Per ulteriori informazioni, consulta VPC e dimensionamento della sottorete nella Guida per l'utente di Amazon VPC.

Errore: «Impossibile scaricare la cache: RequestError: Richiesta di invio non riuscita a causa di: x509: impossibile caricare le radici del sistema e nessuna radice fornita»

Problema: quando tenti di eseguire un progetto di compilazione, la compilazione non riesce e restituisce questo errore.

Possibile causa: hai configurato il caching come parte del progetto di compilazione e utilizzi un'immagine Docker precedente che include un certificato root scaduto.

Soluzione consigliata: aggiorna l'immagine Docker utilizzata nel progetto. AWS CodeBuild Per ulteriori informazioni, consulta Immagini Docker fornite da CodeBuild.

Errore: «Impossibile scaricare il certificato da S3. AccessDenied»

Problema: quando tenti di eseguire un progetto di compilazione, la compilazione non riesce e restituisce questo errore.

Possibili cause:

Soluzioni consigliate:

Errore "Unable to Locate Credentials" (Impossibile individuare le credenziali)

Problema: quando si tenta di eseguire AWS CLI, utilizzare un AWS SDK o chiamare un altro componente simile come parte di una build, si verificano errori di compilazione direttamente correlati all' AWS CLI AWS SDK o al componente. Ad esempio, potresti ricevere un errore di compilazione come Unable to locate credentials.

Possibili cause:

Soluzioni consigliate:

RequestError errore di timeout durante l'esecuzione CodeBuild in un server proxy

Problema: viene visualizzato un errore RequestError simile a uno dei seguenti:

Possibili cause:

Soluzioni consigliate:

La bourne shell (sh) deve esistere nelle immagini di compilazione

Problema: stai utilizzando un'immagine di build non fornita da AWS CodeBuild e le tue build non riescono a visualizzare il messaggio. Build container found dead before completing the build

Causa possibile: la shell Bourne (sh) non è inclusa nell'immagine di build. CodeBuild deve sh eseguire comandi e script di compilazione.

Soluzione consigliata: se non sh è presente nell'immagine di compilazione, assicurati di includerla prima di iniziare altre build che utilizzano l'immagine. (include CodeBuild già sh nelle immagini di compilazione).

Avvertenza: "Skipping install of runtimes. Runtime version selection is not supported by this build image" (L'installazione dei runtime non viene eseguita. L'immagine di compilazione non supporta la selezione delle versioni dei runtime) durante l’esecuzione di una compilazione

Problema: quando esegui una compilazione, il log di compilazione contiene questa avvertenza.

Possibile causa: la build non utilizza la versione 1.0 o successiva dell'immagine standard Amazon Linux 2 (AL2) o la versione 2.0 o successiva dell'immagine standard di Ubuntu e un runtime è specificato in una runtime-versions sezione del file buildspec.

Soluzione consigliata: verificare che il file buildspec non contenga una sezione runtime-versions. La runtime-versions sezione è obbligatoria solo se utilizzi l'immagine standard Amazon Linux 2 (AL2) o successiva o l'immagine standard di Ubuntu versione 2.0 o successiva.

Errore: «Impossibile verificare l' JobWorker identità» all'apertura della console CodeBuild

Problema: quando si apre la CodeBuild console, viene visualizzato il messaggio di errore «Impossibile verificare l' JobWorker identità».

Possibile causa: il ruolo IAM utilizzato per l'accesso alla console ha un tag con jobId come chiave. Questa chiave tag è riservata a CodeBuild e, se presente, causerà questo errore.

Soluzione consigliata: modifica qualsiasi tag di ruolo IAM personalizzato che ha la chiave jobId per avere una chiave diversa, ad esempiojobIdentifier.

La compilazione non è stata avviata

Problema: quando si avvia una compilazione, viene visualizzato il messaggio di errore Build failed to start.

Causa possibile: è stato raggiunto il numero di build simultanee.

Soluzioni consigliate: attendi il completamento delle altre build oppure aumenta il limite di build simultanee per il progetto e riavvia la compilazione. Per ulteriori informazioni, consulta Configurazione del progetto.

Accesso ai GitHub metadati nelle build memorizzate nella cache locale

Problema: in alcuni casi, la directory .git in una build memorizzata nella cache è un file di testo e non una directory.

Possibili cause: quando la memorizzazione nella cache dei sorgenti locali è abilitata per una build, CodeBuild crea un gitlink per la directory. .git Ciò significa che la .git directory è in realtà un file di testo contenente il percorso della directory.

Soluzioni consigliate: in tutti i casi, utilizzate il seguente comando per ottenere la directory dei metadati Git. Questo comando funzionerà indipendentemente dal formato di: .git

git rev-parse --git-dir

AccessDenied: il proprietario del bucket per il gruppo di report non corrisponde al proprietario del bucket S3...

Problema: quando si caricano i dati di test in un bucket Amazon S3, non CodeBuild è in grado di scrivere i dati di test nel bucket.

Possibili cause:

Soluzioni consigliate:

Errore: «Le tue credenziali non dispongono di uno o più ambiti di privilegi richiesti» durante la creazione di un progetto con CodeBuild CodeConnections

Problema: quando crei un CodeBuild progetto con CodeConnections, non hai il permesso di installare un webhook Bitbucket.

Possibili cause:

Soluzioni consigliate:

Errore: «Mi dispiace, non è stato richiesto alcun terminale, impossibile ricevere l'input» durante la compilazione con il comando di installazione di Ubuntu

Problema: se stai eseguendo build con privilegi di GPU Container, potresti installare NVIDIA Container Toolkit seguendo questa procedura. https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html#installing-with-apt Nell'ultima versione dell' CodeBuild immagine, CodeBuild preinstalla e configura docker con l'immagine più recente e curata. nvidia-container-toolkit amazonlinux ubuntu Seguendo questa procedura, le build con il comando di installazione di Ubuntu falliranno con il seguente errore:

Running command curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | gpg --dearmor --no-tty -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
gpg: Sorry, no terminal at all requested - can't get input
curl: (23) Failed writing body

Possibili cause: la chiave gpg esiste già nella stessa posizione.

Soluzioni consigliate: nvidia-container-toolkit è già installata nell'immagine. Se vedi questo errore, puoi saltare il processo di installazione e riavvio di docker nel tuo buildspec.

Le build di Bitbucket falliscono con errori di autenticazione dopo aver utilizzato Secrets Manager OAuth

Problema: le build che utilizzano Bitbucket come provider di origine falliscono con un errore di credenziale di origine. La connessione Bitbucket è stata configurata utilizzando OAuth come servizio di archiviazione. AWS Secrets Manager

Causa possibile: Atlassian applica token di aggiornamento rotanti monouso per Bitbucket OAuth. Ogni volta che usi un token di aggiornamento, Bitbucket lo invalida e ne restituisce uno nuovo. Per ulteriori informazioni, consulta Bitbucket OAuth refresh tokens () monouso sul sito Web per sviluppatori di Atlassian. CHANGE-3052

Soluzione consigliata: aggiungi l'autorizzazione al tuo ruolo di servizio. secretsmanager:PutSecretValue CodeBuild Per ulteriori informazioni sull'autorizzazione IAM richiesta, consultaAzione Manager-stored richiesta per le credenziali di Secrets.