Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Variabili di ambiente degli ambienti di compilazione
AWS CodeBuild fornisce diverse variabili di ambiente che puoi usare nei comandi di compilazione:
- AWS_DEFAULT_REGION
-
La AWS regione in cui è in esecuzione la build (ad esempio,
us-east-1). Questa variabile di ambiente è utilizzata principalmente dalla AWS CLI. - AWS_REGION
-
La AWS regione in cui è in esecuzione la compilazione (ad esempio,
us-east-1). Questa variabile di ambiente viene utilizzata principalmente dagli AWS SDK. - CODEBUILD_BATCH_BUILD_IDENTIFIER
-
L'identificatore della build in una build batch. Questo è specificato nel batch buildspec. Per ulteriori informazioni, consulta Riferimento buildspec per la compilazione in batch.
- CODEBUILD_BUILD_ARN
-
L'Amazon Resource Name (ARN) della build (ad esempio,).
arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE - CODEBUILD_BUILD_ID
-
L' CodeBuild ID della build (ad esempio,).
codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE - CODEBUILD_BUILD_IMAGE
-
L'identificatore dell'immagine di CodeBuild build (ad esempio,).
aws/codebuild/standard:2.0 - CODEBUILD_BUILD_NUMBER
-
Il numero di build corrente del progetto.
- CODEBUILD_BUILD_SUCCEEDING
-
Se la compilazione corrente ha esito positivo. Impostare
0se la compilazione non sta riuscendo, oppure1se la compilazione sta riuscendo. - CODEBUILD_INITIATOR
-
L'entità che ha avviato la compilazione. Se CodePipeline ha avviato la compilazione, questo è il nome della pipeline (ad esempio,
codepipeline/my-demo-pipeline). Se un utente ha avviato la build, questo è il nome dell'utente (ad esempio,MyUserName). Se il plugin Jenkins per CodeBuild ha avviato la compilazione, questa è la stringaCodeBuild-Jenkins-Plugin. - CODEBUILD_KMS_KEY_ID
-
L'identificatore della AWS KMS chiave utilizzata per crittografare l'artefatto di CodeBuild output della build (ad esempio, or).
arn:aws:kms:region-ID:account-ID:key/key-IDalias/key-alias - CODEBUILD_PROJECT_ARN
-
L'Amazon Resource Name (ARN) del progetto (ad esempio,).
arn:aws:codebuild:region-ID:account-ID:project/project-name - CODEBUILD_PUBLIC_BUILD_URL
-
L'URL dei risultati della compilazione per questa build sul sito web delle build pubbliche. Questa variabile è impostata solo se nel progetto di compilazione sono abilitate le build pubbliche. Per ulteriori informazioni, consulta Ottieni gli URL pubblici dei progetti di compilazione.
- CODEBUILD_RESOLVED_SOURCE_VERSION
-
L'identificatore di versione del codice sorgente di una build. Il contenuto dipende dal repository del codice sorgente:
- CodeCommit GitHub, GitHub Enterprise Server e Bitbucket
-
Questa variabile contiene l'ID di commit.
- CodePipeline
-
Questa variabile contiene la revisione del codice sorgente fornita da CodePipeline.
Se non CodePipeline è in grado di risolvere la revisione del codice sorgente, ad esempio quando l'origine è un bucket Amazon S3 su cui non è abilitato il controllo delle versioni, questa variabile di ambiente non è impostata.
- Simple Storage Service (Amazon S3)
-
Questa variabile non è impostata.
Se applicabile, la
CODEBUILD_RESOLVED_SOURCE_VERSIONvariabile è disponibile solo dopo laDOWNLOAD_SOURCEfase. - CODEBUILD_SOURCE_REPO_URL
-
L'URL dell'artefatto di input o del repository del codice sorgente. Per Amazon S3, questo è
s3://seguito dal nome del bucket e dal percorso dell'elemento di input. Per CodeCommit e GitHub, questo è l'URL clone del repository. Se una build proviene da CodePipeline, questa variabile di ambiente potrebbe essere vuota.Per le fonti secondarie, la variabile di ambiente per l'URL del repository di origine secondario è
CODEBUILD_SOURCE_REPO_URL_,<sourceIdentifier><sourceIdentifier> - CODEBUILD_SOURCE_VERSION
-
Il formato del valore dipende dal repository di origine.
-
Per Amazon S3, è l'ID della versione associato all'elemento di input.
-
Per CodeCommit, è l'ID di commit o il nome del ramo associato alla versione del codice sorgente da creare.
-
Per GitHub GitHub Enterprise Server e Bitbucket è l'ID di commit, il nome del ramo o il nome del tag associato alla versione del codice sorgente da creare.
Nota
Per una build GitHub di GitHub Enterprise Server che viene attivata da un evento di pull request webhook, lo è.
pr/pull-request-number
Per le fonti secondarie, la variabile di ambiente per la versione di origine secondaria è
CODEBUILD_SOURCE_VERSION_,<sourceIdentifier><sourceIdentifier> -
- CODEBUILD_SRC_DIR
-
Il percorso della directory CodeBuild utilizzato per la compilazione (ad esempio,).
/tmp/src123456789/srcPer le fonti secondarie, la variabile di ambiente per il percorso della directory di origine secondaria è
CODEBUILD_SRC_DIR_, dov'è<sourceIdentifier><sourceIdentifier> - CODEBUILD_START_TIME
-
L'ora di inizio della build specificata come timestamp Unix in millisecondi.
- CODEBUILD_WEBHOOK_ACTOR_ACCOUNT_ID
-
L'ID dell'account dell'utente che ha attivato l'evento webhook.
- CODEBUILD_WEBHOOK_BASE_REF
-
Il nome di riferimento di base dell'evento webhook che attiva la build corrente. Per una richiesta pull, questo è il riferimento del ramo.
- CODEBUILD_WEBHOOK_EVENT
-
L'evento webhook che attiva la build corrente.
- CODEBUILD_WEBHOOK_MERGE_COMMIT
-
L'identificatore del commit di unione utilizzato per la compilazione. Questa variabile viene impostata quando una richiesta pull di Bitbucket viene unita alla strategia squash e il ramo di pull request viene chiuso. In questo caso, il commit della pull request originale non esiste più, quindi questa variabile di ambiente contiene l'identificatore del commit di unione schiacciato.
- CODEBUILD_WEBHOOK_PREV_COMMIT
-
L'ID del commit più recente prima dell'evento push del webhook che attiva la build corrente.
- CODEBUILD_WEBHOOK_HEAD_REF
-
Il nome di riferimento principale dell'evento webhook che attiva la build corrente. Si tratta di un riferimento ramo o tag.
- CODEBUILD_WEBHOOK_TRIGGER
-
Mostra l'evento webhook che ha attivato la compilazione. Questa variabile è disponibile solo per build attivate da un webhook. Il valore viene analizzato dal payload inviato a GitHub Enterprise Server o CodeBuild GitHub Bitbucket. Il formato del valore dipende dal tipo di evento che ha attivato la build.
-
Per le build attivate da una richiesta di pull, è
pr/.pull-request-number -
Per le build attivate dalla creazione di un nuovo ramo o dal push di un commit a un ramo, è
branch/.branch-name -
Per le build attivate dal push di un tag a un repository, è
tag/.tag-name
-
- CASA
-
Questa variabile di ambiente è sempre impostata su
/root.
AWS CodeBuild supporta anche una serie di variabili di ambiente per build di runner ospitate autonomamente. Per saperne di più su CodeBuild self-hosted runner, vedi. Tutorial: configura un CodeBuild-hosted GitHub Actions runner
- CODEBUILD_RUNNER_OWNER
-
Il proprietario del repository che attiva la build self-hosted di Runner.
- CODEBUILD_RUNNER_REPO
-
Il nome del repository che attiva la build self-hosted del runner.
- CODEBUILD_RUNNER_REPO_DOMAIN
-
Il dominio del repository che attiva la build del runner self-hosted. Solo le build Enterprise specificate. GitHub
- CODEBUILD_WEBHOOK_LABEL
-
L'etichetta utilizzata per configurare le sostituzioni della build e il runner self-hosted durante la compilazione.
- CODEBUILD_WEBHOOK_RUN_ID
-
L'ID di esecuzione del flusso di lavoro associato alla build.
- CODEBUILD_WEBHOOK_JOB_ID
-
L'ID del lavoro associato alla build.
- CODEBUILD_WEBHOOK_WORKFLOW_NAME
-
Il nome del flusso di lavoro associato alla build, se presente nel payload della richiesta del webhook.
- CODEBUILD_RUNNER_WITH_BUILDSPEC
-
Se un override buildspec è configurato nelle etichette di richiesta del runner self-hosted, questo è impostato su.
true
È anche possibile fornire ambienti di compilazione con le proprie variabili di ambiente. Per ulteriori informazioni, consulta i seguenti argomenti:
Per elencare tutte le variabili di ambiente disponibili in un ambiente di compilazione, puoi eseguire il printenv comando (per l'ambiente di compilazione) o "Get-ChildItem Env:" (per gli ambienti di Linux-based compilazione) durante Windows-based una compilazione. Ad eccezione di quelle elencate in precedenza, le variabili di ambiente che iniziano con CODEBUILD_ sono per uso CodeBuild interno. Non devono essere utilizzate nei comandi di compilazione.
Importante
Sconsigliamo vivamente l'uso di variabili di ambiente per memorizzare valori sensibili, in particolare gli ID delle chiavi di AWS accesso. Le variabili di ambiente possono essere visualizzate in testo semplice utilizzando strumenti come la CodeBuild console e il AWS CLI.
Ti consigliamo di memorizzare i valori sensibili nell'Amazon EC2 Systems Manager Parameter Store e quindi recuperarli dal tuo buildspec. Per memorizzare valori sensibili, consulta Systems Manager Parameter Store and Walkthrough: Create and test a String parameter (console) nella Amazon EC2 Systems Manager User Guide. Per recuperarli, consultare la mappatura parameter-store in Sintassi buildspec.
- CODEBUILD_BUILD_URL
L'URL dei risultati della compilazione per questa build.
