Umgebungsvariablen in Build-Umgebungen - AWS CodeBuild

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Umgebungsvariablen in Build-Umgebungen

AWS CodeBuild bietet mehrere Umgebungsvariablen, die Sie in Ihren Build-Befehlen verwenden können:

AWS_DEFAULT_REGION

DieAWS-Region, in der Build ausgeführt wird (z. B.us-east-1) enthalten. Diese Umgebungsvariable wird hauptsächlich bei der AWS CLI verwendet.

AWS_REGION

DieAWS-Region, in der Build ausgeführt wird (z. B.us-east-1) enthalten. Diese Umgebungsvariable wird hauptsächlich von den AWS SDKs verwendet.

CODEBUILD_BATCH_BUILD_IDENTIFIER

Die Kennung des Builds in einem Batch-Build. Dies ist in der Batch-Buildspec angegeben. Weitere Informationen finden Sie unter Batch-Build-Buildspec Referenz.

CODEBUILD_BUILD_ARN

Der Amazon-Ressourcennamen (ARN) des Build (z. B.arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE) enthalten.

CODEBUILD_BUILD_ID

Die CodeBuild-ID des Build (z. B.codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE) enthalten.

CODEBUILD_BUILD_IMAGE

Die CodeBuild-Image-Kennung (z. B.aws/codebuild/standard:2.0) enthalten.

CODEBUILD_BUILD_NUMBER

Die aktuelle Build-Nummer für das Projekt.

CODEBUILD_BUILD_SUCCEEDING

Ob der aktuelle Build erfolgreich ist. Legen Sie den Wert auf 0 fest, wenn der Build fehlschlägt, und auf 1, wenn er erfolgreich ausgeführt wird.

CODEBUILD_INITIATOR

Die Entität, die den Build gestartet hat. Wenn CodePipeline den Build gestartet hat, ist dies der Name der Pipeline (z. B.codepipeline/my-demo-pipeline) enthalten. Wenn ein IAM-Benutzer von den Build gestartet hat, ist dies der Name der Pipeline (z. B.MyUserName) enthalten. Wenn das Jenkins-Plugin für CodeBuild den Build gestartet hat, lautet die ZeichenfolgeCodeBuild-Jenkins-Pluginaus.

CODEBUILD_KMS_KEY_ID

Die ID derAWS KMS-Schlüssel, den CodeBuild zur Verschlüsselung des Build-Ausgabeartefakts verwendet (z. B.arn:aws:kms:region-ID:account-ID:key/key-IDoderalias/key-alias) enthalten.

CODEBUILD_LOG_PATH

Der Name des Protokollstreams in CloudWatch Logs für den Build.

CODEBUILD_PUBLIC_BUILD_URL

Die URL der Build-Ergebnisse für diesen Build auf der öffentlichen Builds-Website. Diese Variable wird nur festgelegt, wenn das Build-Projekt öffentliche Builds aktiviert hat. Weitere Informationen finden Sie unter Öffentliche Build-Projekte inAWS CodeBuild.

CODEBUILD_RESOLVED_SOURCE_VERSION

Die Versions-ID des Quellcodes eines Build. Der Inhalt richtet sich nach dem Quellcode-Repository:

CodeCommit, GitHub, GitHub Enterprise Server und Bitbucket

Diese Variable enthält die Commit-ID.

CodePipeline

Diese Variable enthält die von CodePipeline bereitgestellte Quellrevision.

Wenn CodePipeline die Quellrevision nicht auflösen kann, z. B. wenn es sich bei der Quelle um einen Amazon S3 S3-Bucket handelt, für den die Versionierung nicht aktiviert ist, ist diese Umgebungsvariable nicht festgelegt.

Amazon S3

Diese Variable ist nicht festgelegt.

Gegebenenfalls wird derCODEBUILD_RESOLVED_SOURCE_VERSIONist erst nach demDOWNLOAD_SOURCE-Phase.

CODEBUILD_SOURCE_REPO_URL

Die URL zum Eingabe-Artefakt oder den Quellcode-Repository. Für Amazon S3 ist diess3://gefolgt von dem Bucket-Namen und dem Pfad zum Eingabotefakt. Dies ist die Repository-Klon-URL für CodeCommit und GitHub. Wenn ein Build aus CodePipeline stammt, kann diese Umgebungsvariable leer sein.

Für sekundäre Quellen lautet die Umgebungsvariable für die sekundäre Quell-Repository-URLCODEBUILD_SOURCE_REPO_URL_<sourceIdentifier>, wobei<sourceIdentifier>ist die Quellkennung, die Sie erstellen.

CODEBUILD_SOURCE_VERSION

Das Format des Werts richtet sich nach dem Quellcode-Repository.

  • Bei Amazon S3 handelt es sich um die Versions-ID, die zum Eingabotefakt gehört.

  • Bei CodeCommit handelt es sich um die Commit-ID oder den Branch-Namen, der zur Version des zu erstellenden Quellcodes gehört.

  • Bei GibHub, GitHub Enterprise Server und Bitbucket handelt es sich um die Commit-ID, den Branch-Namen oder den Tag-Namen, die bzw. der zur Version des zu erstellenden Quellcodes gehört.

    Anmerkung

    Bei einem GitHub- oder GitHub Enterprise Server-Build, der über eine Webhook-Pull-Anforderung ausgelöst wird, handelt es sich um pr/pull-request-number.

Für sekundäre Quellen lautet die Umgebungsvariable für die sekundäre QuellversionCODEBUILD_SOURCE_VERSION_<sourceIdentifier>, wobei<sourceIdentifier>ist die Quellkennung, die Sie erstellen. Weitere Informationen finden Sie unter Beispiel für mehrere Eingabequellen und Ausgabeartefakte.

CODEBUILD_SRC_DIR

Der Verzeichnispfad, den CodeBuild für den Build verwendet (z. B./tmp/src123456789/src) enthalten.

Für sekundäre Quellen lautet die Umgebungsvariable für den sekundären QuellverzeichnispfadCODEBUILD_SRC_DIR_<sourceIdentifier>, wobei<sourceIdentifier>ist die Quellkennung, die Sie erstellen. Weitere Informationen finden Sie unter Beispiel für mehrere Eingabequellen und Ausgabeartefakte.

CODEBUILD_START_TIME

Die Startzeit des Builds, angegeben als Unix-Zeitstempel in Millisekunden.

CODEBUILD_WEBHOOK_ACTOR_ACCOUNT_ID

Die Konto-ID des Benutzers, der das Webhook-Ereignis ausgelöst hat.

CODEBUILD_WEBHOOK_BASE_REF

Der Basisreferenzname des Webhook-Ereignisses, das den aktuellen Build auslöst. Bei einer Pull-Anforderung handelt es sich hierbei um die Verzweigungsreferenz.

CODEBUILD_WEBHOOK_EVENT

Das Webhook-Ereignis, das den aktuellen Build auslöst.

CODEBUILD_WEBHOOK_MERGE_COMMIT

Die Kennung des Merge-Commits, der für den Build verwendet wird. Diese Variable wird festgelegt, wenn eine Bitbucket-Pull-Anforderung mit der Squash-Strategie zusammengeführt wird und der Pull-Request-Zweig geschlossen wird. In diesem Fall existiert das ursprüngliche Pull-Request-Commit nicht mehr, daher enthält diese Umgebungsvariable den Bezeichner des gequashten Merge-Commits.

CODEBUILD_WEBHOOK_PREV_COMMIT

Die ID des letzten Commits vor dem Webhook-Push-Ereignis, das den aktuellen Build auslöst.

CODEBUILD_WEBHOOK_HEAD_REF

Der Kopfreferenzname des Webhook-Ereignisses, das den aktuellen Build auslöst. Hierbei kann es sich um eine Verzweigungsreferenz oder um eine Tag-Referenz handeln.

CODEBUILD_WEBHOOK_TRIGGER

Zeigt das Webhook-Ereignis an, das den Build ausgelöst hat. Diese Variable ist nur für Builds verfügbar, die von einem Webhook ausgelöst wurden. Der Wert wird der Nutzlast entnimmt, die von GitHub, GitHub Enterprise Server oder Bitbucket an CodeBuild gesendet wurde. Der Wert des Formats hängt davon ab, welche Art von Ereignis den Build ausgelöst hat.

  • Für Builds, die von einer Pull-Anforderung ausgelöst wurden, handelt es sich um pr/pull-request-number.

  • Für Builds, die durch das Erstellen eines neuen Branches oder durch Pushen eines Commits für einen Branch ausgelöst wurden, handelt es sich um branch/branch-name.

  • Für Builds, die durch das Pushen eines Tags in ein Repository ausgelöst wurden, handelt es sich um tag/tag-name.

ZUHAUSE

Diese Umgebungsvariable ist immer auf gesetzt/rootaus.

Sie können auch Build-Umgebungen mit Ihren eigenen Umgebungsvariablen liefern. Weitere Informationen finden Sie unter den folgenden Themen:

Zur Auflistung der verfügbaren Umgebungsvariablen in einer Build-Umgebung können Sie während eines Builds den Befehl printenv ausführen (für eine Linux-basierte Build-Umgebung), oder "Get-ChildItem Env:" (für Windows-basierte Build-Umgebungen). Mit Ausnahme der vorstehend aufgeführten Umgebungsvariablen, die mit beginnenCODEBUILD_sind zur internen Verwendung von CodeBuild bestimmt. Diese sollten nicht in Ihrem Build-Befehlen eingesetzt werden.

Wichtig

Wir raten dringend davon ab, Umgebungsvariablen zum Speichern vertraulicher Werte zu verwenden, dies gilt insbesondere für AWS-Zugriffsschlüssel-IDs und geheime Zugriffsschlüssel. Umgebungsvariablen können mit Tools wie der CodeBuild-Konsole und über dieAWS CLIaus.

Sie sollten sensible Werte im Amazon EC2 Systems Manager Parameter Store speichern und anschließend aus Ihrer Build-Spezifikation abrufen. Informationen zum Speichern sensibler Werte finden Sie unterSystems Manager Parameter StoreundVorgehensweise für: Erstellen und Testen eines String-Parameters (Konsole)imAmazon EC2 Systems Manager Manager-Benutzerhandbuchaus. Informationen zum Abrufen dieser Variablen finden Sie unter der parameter-store-Zuordnung in Syntax der Build-Spezifikation.