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 build:
- 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 build (ad esempio,
us-east-1). Questa variabile di ambiente viene utilizzata principalmente da AWS SDKs. - 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 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 compilazione (ad esempio,
aws/codebuild/standard:2.0). - CODEBUILD_BUILD_NUMBER
-
Il numero di build corrente del progetto.
- CODEBUILD_BUILD_SUCCEEDING
-
Se la build 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 è stata CodePipeline avviata la build, 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 for CodeBuild ha avviato la build, questa è la stringaCodeBuild-Jenkins-Plugin. - CODEBUILD_ KMS _ _ID KEY
-
L'identificatore della AWS KMS chiave utilizzata per crittografare l'elemento di output della build (ad esempio o). CodeBuild
arn:aws:kms:region-ID:account-ID:key/key-IDalias/key-alias - CODEBUILD_LOG_PATH
-
Il nome del flusso di log in CloudWatch Logs per la build.
- CODEBUILD_PUBLIC_BUILD_URL
-
I risultati URL della build di questa build sul sito web Public Builds. Questa variabile è impostata solo se il progetto di compilazione ha le build pubbliche abilitate. Per ulteriori informazioni, consulta Get public build project URLs.
- 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 che non ha il controllo delle versioni abilitato, questa variabile di ambiente non è impostata.
- Amazon S3
-
Questa variabile non è impostata.
Se applicabile, la
CODEBUILD_RESOLVED_SOURCE_VERSIONvariabile è disponibile solo dopo laDOWNLOAD_SOURCEfase. - CODEBUILD_SOURCE_REPO_URL
-
Vai URL all'artefatto di input o al 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 è il clone del repository. URL Se una build ha origine da CodePipeline, questa variabile di ambiente potrebbe essere vuota.Per le fonti secondarie, la variabile di ambiente per l'archivio dei sorgenti secondari URL è
CODEBUILD_SOURCE_REPO_URL_,<sourceIdentifier><sourceIdentifier> - CODEBUILD_SOURCE_VERSION
-
Il formato del valore dipende dal repository di origine.
-
Per Amazon S3, è l'ID di versione associato all'elemento di input.
-
Infatti 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 attivata da un evento di pull request di 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/src).Per le fonti secondarie, la variabile di ambiente per il percorso della directory di origine secondaria è
CODEBUILD_SRC_DIR_, dove si<sourceIdentifier><sourceIdentifier> - CODEBUILD_START_TIME
-
L'ora di inizio della compilazione specificata come timestamp Unix in millisecondi.
- CODEBUILDACCOUNT_ _ _ _ID WEBHOOK ACTOR
-
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 fusione utilizzato per la build. Questa variabile viene impostata quando una pull request di Bitbucket viene unita alla strategia squash e il ramo pull request viene chiuso. In questo caso, il commit di pull request originale non esiste più, quindi questa variabile di ambiente contiene l'identificatore dello squashed merge commit.
- CODEBUILD_WEBHOOK_PREV_COMMIT
-
L'ID del commit più recente prima dell'evento webhook push 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 build. Questa variabile è disponibile solo per build attivate da un webhook. Il valore viene analizzato dal payload inviato a CodeBuild by GitHub, GitHub Enterprise Server o 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
-
- HOME
-
Questa variabile di ambiente è sempre impostata su.
/root
AWS CodeBuild supporta anche un set di variabili di ambiente per build runner ospitate autonomamente. Per ulteriori informazioni su CodeBuild self-hosted runner, consulta. Tutorial: configura un GitHub Actions CodeBuild runner ospitato
- CODEBUILD_RUNNER_OWNER
-
Il proprietario del repository che attiva la build self-hosted runner.
- CODEBUILD_RUNNER_REPO
-
Il nome del repository che attiva la build del runner ospitato autonomamente.
- CODEBUILD_RUNNER_REPO_DOMAIN
-
Il dominio del repository che attiva la build del runner ospitato autonomamente. Solo build Enterprise specificate. GitHub
- CODEBUILD_WEBHOOK_LABEL
-
L'etichetta utilizzata per configurare le sostituzioni di build e il runner self-hosted durante la compilazione.
- CODEBUILD_ _ _ID WEBHOOK RUN
-
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 self-hosted runner request, 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, è possibile eseguire il comando printenv (per un ambiente di compilazione basato su Linux) o "Get-ChildItem Env:" (per ambienti di compilazione basati su Windows) durante una compilazione. Ad eccezione di quelle elencate in precedenza, le variabili di ambiente che iniziano con sono per uso interno. CODEBUILD_ CodeBuild Non devono essere utilizzate nei comandi di compilazione.
Importante
Sconsigliamo vivamente l'uso di variabili di ambiente per memorizzare valori sensibili, in particolare la chiave IDs 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 in Amazon EC2 Systems Manager Parameter Store e poi recuperarli dalle tue specifiche di costruzione. 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.
