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. # Manuelles Ausführen von AWS CodeBuild Builds Sie können die AWS CodeBuild Konsole oder verwenden AWS CLI, AWS SDKs um einen Build in auszuführen CodeBuild. **Topics** + [ # Builds lokal mit dem AWS CodeBuild Agenten ausführen ](use-codebuild-agent.md) + [ # Ausführen eines Build (Konsole) ](run-build-console.md) + [ # Ausführen eines Build (AWS CLI) ](run-build-cli.md) + [ # Führen Sie einen Batch-Build (AWS CLI) aus ](run-batch-build-cli.md) + [ # Ausführung von Builds automatisch starten (AWS CLI) ](run-build-cli-auto-start.md) + [ # Ausführung von Builds automatisch beenden (AWS CLI) ](run-build-cli-auto-stop.md) + [ # Ausführen eines Build (AWS SDKs) ](run-build-sdks.md) # Builds lokal mit dem AWS CodeBuild Agenten ausführen Sie können den AWS CodeBuild Agenten verwenden, um CodeBuild Builds auf einem lokalen Computer auszuführen. Es sind Agenten für x86\$164- und ARM-Plattformen verfügbar. Sie können auch Benachrichtigungen abonnieren, wenn neue Versionen des Agenten veröffentlicht werden. ## Voraussetzungen Bevor Sie beginnen, müssen Sie Folgendes tun: + Installieren Sie Git auf Ihrem lokalen Computer. + Installieren und richten Sie [Docker](https://www.docker.com/) auf Ihrem lokalen Computer ein. ## Richten Sie das Build-Image ein Sie müssen das Build-Image nur einrichten, wenn Sie den Agenten zum ersten Mal ausführen oder wenn sich das Image geändert hat. **Um das Build-Image einzurichten** 1. [Wenn Sie ein kuratiertes Amazon Linux 2-Image verwenden möchten, können Sie es aus dem CodeBuild öffentlichen Amazon ECR-Repository unter https://gallery.ecr abrufen. aws/codebuild/amazonlinux-x86\$164-standard](https://gallery.ecr.aws/codebuild/amazonlinux-x86_64-standard) mit dem folgenden Befehl: ``` $ docker pull public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0 ``` Wenn Sie ein anderes Linux-Image verwenden möchten, führen Sie alternativ die folgenden Schritte aus: 1. Klonen Sie das CodeBuild Image-Repo: ``` $ git clone https://github.com/aws/aws-codebuild-docker-images.git ``` 1. Wechseln Sie in das Image-Verzeichnis. Verwenden Sie für dieses Beispiel das `aws/codebuild/standard:5.0` Bild: ``` $ cd aws-codebuild-docker-images/ubuntu/standard/5.0 ``` 1. Erstellen Sie das Bild. Dies dauert einige Minuten. ``` $ docker build -t aws/codebuild/standard:5.0 . ``` 1. Laden Sie den CodeBuild Agenten herunter. Führen Sie den folgenden Befehl aus, um die x86\$164-Version des Agenten herunterzuladen: ``` $ docker pull public.ecr.aws/codebuild/local-builds:latest ``` Führen Sie den folgenden Befehl aus, um die ARM-Version des Agenten herunterzuladen: ``` $ docker pull public.ecr.aws/codebuild/local-builds:aarch64 ``` 1. Der CodeBuild Agent ist unter [https://gallery.ecr verfügbar. aws/codebuild/local-baut](https://gallery.ecr.aws/codebuild/local-builds). Die SHA-Signatur (Secure Hash Algorithm) für die x86\$164-Version des Agenten lautet: ``` sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940 ``` Die SHA-Signatur für die ARM-Version des Agenten lautet: ``` sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192 ``` Sie können das SHA verwenden, um die Version des Agenten zu identifizieren. Um die SHA-Signatur des Agenten zu sehen, führen Sie den folgenden Befehl aus und suchen Sie unter`RepoDigests`: ``` $ docker inspect public.ecr.aws/codebuild/local-builds:latest ``` ## Führen Sie den CodeBuild Agenten aus **Um den CodeBuild Agenten auszuführen** 1. Wechseln Sie in das Verzeichnis, das die Quelle Ihres Build-Projekts enthält. 1. Laden Sie das Skript [codebuild\$1build.sh](https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/codebuild_build.sh) herunter: ``` $ curl -O https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh $ chmod +x codebuild_build.sh ``` 1. Führen Sie das `codebuild_build.sh` Skript aus und geben Sie Ihr Container-Image und das Ausgabeverzeichnis an. Führen Sie den folgenden Befehl aus, um einen x86\$164-Build auszuführen: ``` $ ./codebuild_build.sh -i -a ``` Führen Sie den folgenden Befehl aus, um einen ARM-Build auszuführen: ``` $ ./codebuild_build.sh -i -a -l public.ecr.aws/codebuild/local-builds:aarch64 ``` **Ersetzen Sie es durch den Namen des Container-Images, z. B. `aws/codebuild/standard:5.0` oder`public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0`. Das Skript startet das Build-Image und führt den Build für das Projekt im aktuellen Verzeichnis aus. Um den Speicherort des Build-Projekts anzugeben, fügen Sie die `-s ` Option zum Skriptbefehl hinzu. ## Erhalten Sie Benachrichtigungen für neue CodeBuild Agentenversionen Sie können Amazon SNS SNS-Benachrichtigungen abonnieren, sodass Sie benachrichtigt werden, wenn neue Versionen des AWS CodeBuild Agenten veröffentlicht werden. **Um CodeBuild Agentenbenachrichtigungen zu abonnieren** 1. Öffnen Sie die Amazon SNS SNS-Konsole unter [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home). 1. Ändern Sie in der Navigationsleiste die AWS Region auf **USA Ost (Nord-Virginia**), sofern sie nicht bereits ausgewählt ist. Sie müssen diese AWS Region auswählen, da die Amazon SNS SNS-Benachrichtigungen, die Sie abonnieren, in dieser Region erstellt werden. 1. Wählen Sie im Navigationsbereich **Subscriptions** aus. 1. Wählen Sie **Create subscription**. 1. Gehen **Sie unter Abonnement erstellen** wie folgt vor: 1. Verwenden Sie für **Topic ARN** den folgenden Amazon-Ressourcennamen (ARN): ``` arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates ``` 1. Wählen Sie für **Protocol (Protokoll)** die Option **Email (E-Mail)** oder **SMS**. 1. Wählen Sie unter **Endpoint (Endpunkt)** aus, worüber (per E-Mail oder SMS) die Benachrichtigungen empfangen werden sollen. Geben Sie eine E-Mail-Adresse, Adresse oder Telefonnummer einschließlich Vorwahl ein. 1. Wählen Sie **Create subscription** (Abonnement erstellen) aus. 1. Wählen Sie **E-Mail**, um eine E-Mail zu erhalten, in der Sie aufgefordert werden, Ihr Abonnement zu bestätigen. Befolgen Sie die Anweisungen in der E-Mail zum Abschließen Ihres Abonnements. Wenn Sie diese Benachrichtigungen nicht mehr erhalten möchten, führen Sie die folgenden Schritte aus, um sich abzumelden. **Um sich von CodeBuild Agentenbenachrichtigungen abzumelden** 1. Öffnen Sie die Amazon SNS SNS-Konsole unter [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home). 1. Wählen Sie im Navigationsbereich **Subscriptions** aus. 1. Wählen Sie das Abonnement und unter **Actions (Aktionen)** die Option **Delete subscriptions (Abonnements löschen)** aus. Wenn Sie aufgefordert werden, Ihre Entscheidung zu bestätigen, wählen Sie **Delete** aus. # Ausführen eines Build (Konsole) Um einen Build mit auszuführen CodeBuild, überspringen Sie diese Schritte und folgen Sie den Anweisungen unter[Verwenden Sie CodeBuild mit CodePipeline](how-to-create-pipeline.md). AWS CodePipeline 1. Öffnen Sie die AWS CodeBuild Konsole unter [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. Wählen Sie im linken Navigationsbereich **Build projects** aus. 1. Wählen Sie in der Liste der Build-Projekte das Build-Projekt aus. 1. Sie können den Build mit den Standard-Build-Projekteinstellungen ausführen oder die Build-Einstellungen nur für diesen Build überschreiben. 1. Wenn Sie den Build mit den Standardeinstellungen für das Build-Projekt ausführen möchten, wählen Sie **Build starten**. Der Build wird sofort gestartet. 1. Wenn Sie die Standardeinstellungen für das Build-Projekt überschreiben möchten, wählen Sie **Build mit Überschreibungen starten** aus. Auf der Seite „**Build starten**“ können Sie Folgendes überschreiben: + **Konfiguration erstellen** + **Quelle** + **Überschreibungen von Umgebungsvariablen** Wenn Sie erweiterte Überschreibungen auswählen müssen, wählen Sie **Erweiterte Build-Überschreibungen**. Auf dieser Seite können Sie Folgendes überschreiben: + **Konfiguration erstellen** + **Quelle** + **Umgebung** + **Buildspec** + **Artefakte** + **Protokolle** Wenn Sie Ihre Override-Auswahl getroffen haben, wählen Sie **Build starten** aus. Weitere Informationen zu diesem Build finden Sie unter [Anzeigen von Build-Details (Konsole)](view-build-details.md#view-build-details-console). # Ausführen eines Build (AWS CLI) **Anmerkung** Um einen Build mit auszuführen AWS CodeBuild, überspringen Sie diese Schritte und folgen Sie den Anweisungen unter[Erstellen Sie eine Pipeline, die CodeBuild (AWS CLI) verwendet](how-to-create-pipeline-cli.md). CodePipeline Weitere Informationen zur Verwendung von AWS CLI with CodeBuild finden Sie unter[Befehlszeilenreferenz](cmd-ref.md). 1. Führen Sie den Befehl `start-build` auf eine der folgenden Weisen aus: ``` aws codebuild start-build --project-name ``` Sie können diesen Befehl verwenden, wenn Sie ein Build ausführen möchten, dass die neueste Version des Build-Eingabeartifakts und die vorhandenen Einstellungen des Build-Projekts einsetzt. ``` aws codebuild start-build --generate-cli-skeleton ``` Verwenden Sie diesen Befehl, wenn Sie einen Build mit einer früheren Version des Build-Eingabeartefakts verwenden oder die Einstellungen für Build-Ausgabeartefakte, Umgebungsvariablen, Build-Spezifikationen oder Standard-Build-Zeitbeschränkungen überschreiben möchten. 1. Wenn Sie den **start-build** Befehl mit der `--project-name` Option ausführen, ersetzen Sie ihn durch den Namen des Build-Projekts, und fahren Sie dann ** mit Schritt 6 dieses Verfahrens fort. Informationen zum Abrufen einer Liste von Build-Projekten finden Sie unter [Namen von Build-Projekten anzeigen](view-project-list.md). 1. Wenn Sie den **start-build** Befehl mit der `--idempotency-token` Option ausführen, ist ein eindeutiger Bezeichner oder ein Token, bei dem die Groß- und Kleinschreibung beachtet wird, in der `start-build` Anforderung enthalten. Das Token ist nach der Anforderung 5 Minuten gültig. Wenn Sie die `start-build` Anfrage mit demselben Token wiederholen, aber einen Parameter ändern, wird ein Fehler wegen Nichtübereinstimmung der Parameter CodeBuild zurückgegeben. 1. Wenn Sie den **start-build** Befehl mit der Option `--generate-cli-skeleton` ausführen, werden Daten im JSON-Format in der Ausgabe angezeigt. Kopieren Sie die Daten in eine Datei (z. B.`start-build.json`) an einem Speicherort auf dem lokalen Computer oder in der Instanz, in der der installiert AWS CLI ist. Ändern Sie die kopierten Daten, damit diese mit dem nachfolgenden Format übereinstimmen und speichern Sie die Ergebnisse: ``` { "projectName": "projectName", "sourceVersion": "sourceVersion", "artifactsOverride": { "type": "type", "location": "location", "path": "path", "namespaceType": "namespaceType", "name": "artifactsOverride-name", "packaging": "packaging" }, "buildspecOverride": "buildspecOverride", "cacheOverride": { "location": "cacheOverride-location", "type": "cacheOverride-type" }, "certificateOverride": "certificateOverride", "computeTypeOverride": "computeTypeOverride", "environmentTypeOverride": "environmentTypeOverride", "environmentVariablesOverride": { "name": "environmentVariablesOverride-name", "value": "environmentVariablesValue", "type": "environmentVariablesOverride-type" }, "gitCloneDepthOverride": "gitCloneDepthOverride", "imageOverride": "imageOverride", "idempotencyToken": "idempotencyToken", "insecureSslOverride": "insecureSslOverride", "privilegedModeOverride": "privilegedModeOverride", "queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride", "reportBuildStatusOverride": "reportBuildStatusOverride", "timeoutInMinutesOverride": "timeoutInMinutesOverride", "sourceAuthOverride": "sourceAuthOverride", "sourceLocationOverride": "sourceLocationOverride", "serviceRoleOverride": "serviceRoleOverride", "sourceTypeOverride": "sourceTypeOverride" } ``` Ersetzen die folgenden Platzhalter: + *projectName*: Erforderliche Zeichenfolge. Der Name des Build-Projekts, der für diesen Build zu verwenden ist. + *sourceVersion*: Optionale Zeichenfolge. Eine Version des Quellcodes, der wie folgt zu erstellen ist: + Für Amazon S3 die Versions-ID, die der Version der Eingabe-ZIP-Datei entspricht, die Sie erstellen möchten. Wenn *sourceVersion* nicht angegeben, wird die neueste Version verwendet. + Für CodeCommit die Commit-ID, die der Version des Quellcodes entspricht, den Sie erstellen möchten. Wenn nicht angegeben, *sourceVersion* wird die HEAD-Commit-ID des Standardzweigs verwendet. (Sie können keinen Tag-Namen für angeben*sourceVersion*, aber Sie können die Commit-ID des Tags angeben.) + Für GitHub die Commit-ID, die Pull-Request-ID, den Branch-Namen oder den Tag-Namen, der der Version des Quellcodes entspricht, den Sie erstellen möchten. Wenn eine Pull-Anforderungs-ID angegeben ist, muss diese das Format `pr/pull-request-ID` verwenden (Beispiel: `pr/25`). Wenn ein Branch-Name angegeben wird, wird die Commit-ID von HEAD verwendet. Wenn nicht angegeben, *sourceVersion* wird die HEAD-Commit-ID des Standard-Branches verwendet. + Für Bitbucket, Commit-ID, Branch-Name oder Tag-Name, die/der der Version des Quellcodes entspricht, die Sie erstellen möchten. Wenn ein Branch-Name angegeben wird, wird die Commit-ID von HEAD verwendet. Wenn nicht angegeben, *sourceVersion* wird die HEAD-Commit-ID des Standard-Branches verwendet. + Die folgenden Platzhalter gelten für `artifactsOverride`. + *type*: Optional. Die Art des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. + *location*: Optional. Der Speicherort des Build-Ausgabeartefakt, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. + *path*: Optional. Der Pfad des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. + *namespaceType*: Optional. Der Pfadtyp des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. + *name*: Optional. Der Name des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. + *packaging*: Optional. Die Verpackungsart des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. + *buildspecOverride*: Optional. Eine Build-Spezifikationsdeklaration, die für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. Wenn dieser Wert festgelegt ist, kann es sich entweder um eine Inline-Definition einer Build-Spezifikation, den Pfad zu einer alternativen buildspec-Datei relativ zum Wert der integrierten Umgebungsvariablen `CODEBUILD_SRC_DIR` oder den Pfad zu einem S3-Bucket handeln. Der S3-Bucket muss sich in derselben AWS -Region wie das Build-Projekt befinden. Geben Sie die buildspec-Datei mit ihrem ARN an (z. B. `arn:aws:s3:::/buildspec.yml`). Wenn der Wert nicht angegeben oder eine leere Zeichenfolge ist, muss der Quellcode eine `buildspec.yml`-Datei im Stammverzeichnis enthalten. Weitere Informationen finden Sie unter [Dateiname der Build-Spezifikation und Speicherort](build-spec-ref.md#build-spec-ref-name-storage). + Die folgenden Platzhalter gelten für `cacheOverride`. + *cacheOverride-location*: Optional. Der Speicherort eines `ProjectCache`-Objekts für diesen Build, der das im Build-Projekt angegebene `ProjectCache`-Objekt überschreibt. `cacheOverride` ist optional und akzeptiert ein `ProjectCache`-Objekt. `location` ist in einem `ProjectCache`-Objekt erforderlich. + *cacheOverride-type*: Optional. Der Typ eines `ProjectCache`-Objekts für diesen Build, der das im Build-Projekt angegebene `ProjectCache`-Objekt überschreibt. `cacheOverride` ist optional und akzeptiert ein `ProjectCache`-Objekt. `type` ist in einem `ProjectCache`-Objekt erforderlich. + *certificateOverride*: Optional. Der Name eines Zertifikats für diesen Build, das das im Build-Projekt angegebene überschreibt. + *environmentTypeOverride*: Optional. Ein Containertyp für diesen Build, der den im Build-Projekt angegebenen überschreibt. Die aktuell gültige Zeichenfolge ist `LINUX_CONTAINER`. + Die folgenden Platzhalter gelten für `environmentVariablesOverride`. + *environmentVariablesOverride-name*: Optional. Der Name einer Umgebungsvariable in dem Build\$1Projekt, deren Wert Sie für diesen Build überschreiben möchten. + *environmentVariablesOverride-type*: Optional. Der Typ der Umgebungsvariablen im Build-Projekt, deren Wert für diesen Build überschrieben werden soll. + *environmentVariablesValue*: Optional. Der Wert der Umgebungsvariablen, der im Build-Projekt festgelegt wurde und für diesen Build überschrieben werden soll. + *gitCloneDepthOverride*: Optional. Der Wert für **Git clone depth**, der in dem Build-Projekt festgelegt ist, dessen Wert Sie für diesen Build überschreiben möchten. Wenn Ihr Quelltyp Amazon S3 ist, wird dieser Wert nicht unterstützt. + *imageOverride*: Optional. Der Name eines Abbilds für diesen Build, das das im Build-Projekt angegebene überschreibt. + *idempotencyToken*: Optional. Eine Zeichenfolge, die als Token dient und angibt, dass die Build-Anforderung idempotent ist. Sie können eine beliebige Zeichenfolge mit maximal 64 Zeichen verwenden. Das Token ist nach der Start-Build-Anfrage 5 Minuten lang gültig. Wenn Sie die Start-Build-Anfrage mit demselben Token wiederholen, aber einen Parameter ändern, wird ein CodeBuild Parameterkonflikt-Fehler zurückgegeben. + *insecureSslOverride*: Optionaler boolescher Wert, der angibt, ob die im Build-Projekt angegebene unsichere TLS-Einstellung überschrieben werden soll. Die unsichere TLS-Einstellung bestimmt, ob TLS-Warnungen ignoriert werden sollen, während die Verbindung zum Projektquellcode hergestellt wird. Diese Überschreibung gilt nur, wenn die Quelle des Builds Enterprise Server ist GitHub . + *privilegedModeOverride*: Optionaler boolescher Wert. Ist der Wert "true" festgelegt, überschreibt der Build den privilegierten Modus im Build-Projekt. + *queuedTimeoutInMinutesOverride*: Optionale Ganzzahl, die angibt, wie viele Minuten ein Build in die Warteschlange gestellt werden darf, bevor das Timeout eintritt. Der kleinste Wert beträgt fünf Minuten, der größte Wert beträgt 480 Minuten (8 Stunden). + *reportBuildStatusOverride*: Optionaler boolescher Wert, der angibt, ob Ihrem Quellanbieter der Status des Beginns und des Abschlusses eines Builds gesendet werden soll. Wenn Sie dies mit einem anderen Quellanbieter als GitHub GitHub Enterprise Server oder Bitbucket festlegen, wird ein invalidInputException ausgelöst. + *sourceAuthOverride*: Optionale Zeichenfolge. Ein Autorisierungstyp für diesen Build, der den im Build-Projekt angegebenen überschreibt. Diese Überschreibung gilt nur, wenn die Quelle des Build-Projekts Bitbucket oder GitHub ist. + *sourceLocationOverride*: Optionale Zeichenfolge. Ein Speicherort, der für diesen Build den Quellspeicherort überschreibt, der im Build-Projekt definiert ist. + *serviceRoleOverride*: Optionale Zeichenfolge. Der Name einer Servicerolle für diesen Build, die die im Build-Projekt angegebene Servicerolle überschreibt. + *sourceTypeOverride*: Optionale Zeichenfolge. Ein Quelleingabetyp für diesen Build, der die im Build-Projekt definierte Quelleingabe überschreibt. Gültige Zeichenfolgen sind `NO_SOURCE`, `CODECOMMIT`, `CODEPIPELINE`, `GITHUB`, `S3`, `BITBUCKET` und `GITHUB_ENTERPRISE`. + *timeoutInMinutesOverride*: Optionale Zahl. Die Anzahl der Minuten der Build-Zeitbeschränkung, die für diesen Build den Build überschreiben, der im Build-Projekt festgelegt ist. Wir empfehlen, dass Sie eine Umgebungsvariable mit einem sensiblen Wert wie einer AWS Zugriffsschlüssel-ID, einem AWS geheimen Zugriffsschlüssel oder einem Passwort als Parameter im Amazon EC2 Systems Manager Parameter Store speichern. CodeBuild kann einen im Amazon EC2 Systems Manager Parameter Store gespeicherten Parameter nur verwenden, wenn der Name dieses Parameters mit beginnt `/CodeBuild/` (z. B.`/CodeBuild/dockerLoginPassword`). Sie können die CodeBuild Konsole verwenden, um einen Parameter in Amazon EC2 Systems Manager zu erstellen. Wählen Sie **Create a parameter (Parameter erstellen)** aus und befolgen Sie dann die Anweisungen. (In diesem Dialogfeld können Sie für **KMS-Schlüssel** optional den ARN eines AWS KMS Schlüssels in Ihrem Konto angeben. Amazon EC2 Systems Manager verwendet diesen Schlüssel, um den Wert des Parameters beim Speichern zu verschlüsseln und beim Abrufen zu entschlüsseln.) Wenn Sie die CodeBuild Konsole verwenden, um einen Parameter zu erstellen, beginnt die Konsole den Parameter mit dem Wert, `/CodeBuild/` während er gespeichert wird. Wenn Sie jedoch die Amazon EC2 Systems Manager Parameter Store-Konsole verwenden, um einen Parameter zu erstellen, müssen Sie den Namen des Parameters mit `/CodeBuild/` beginnen und **Type** auf **Secure String** setzen. Weitere Informationen finden Sie unter [AWS Systems Manager Parameterspeicher](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) und [Exemplarische Vorgehensweise: Erstellen und Testen eines String-Parameters (Konsole)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-console.html) im *Amazon EC2 Systems Manager Manager-Benutzerhandbuch*. Wenn Ihr Build-Projekt auf Parameter Store von Amazon EC2 Systems Manager gespeicherte Parameter verweist, muss die Service-Rolle des Build-Projekts die `ssm:GetParameters` Aktion zulassen. Wenn Sie zuvor **in Ihrem Konto die Option Neue Servicerolle erstellen** ausgewählt haben, wird CodeBuild diese Aktion automatisch in die Standard-Servicerolle für Ihr Build-Projekt aufgenommen. Wenn Sie jedoch **Choose an existing service role from your account** ausgewählt haben, müssen Sie diese Aktion separat in Ihre Service-Rolle aufnehmen. Von Ihnen gesetzte Umgebungsvariablen ersetzen vorhandene Umgebungsvariablen. Wenn das Docker-Image beispielsweise bereits eine Umgebungsvariable mit dem Namen `MY_VAR` und einem Wert von `my_value` enthält und Sie eine Umgebungsvariable mit dem Namen `MY_VAR` und einem Wert von `other_value` festlegen, wird `my_value` durch `other_value` ersetzt. Wenn das Docker-Image demgegenüber bereits eine Umgebungsvariable mit dem Namen `PATH` und einem Wert von `/usr/local/sbin:/usr/local/bin` enthält und Sie eine Umgebungsvariable mit dem Namen `PATH` und einem Wert von `$PATH:/usr/share/ant/bin` festlegen, wird `/usr/local/sbin:/usr/local/bin` durch den Literalwert `$PATH:/usr/share/ant/bin` ersetzt. Legen Sie keine Umgebungsvariable mit einem Namen fest, der mit `CODEBUILD_` beginnt. Dieses Präfix ist zur -internen Verwendung reserviert. Wenn eine Umgebungsvariable mit identischem Namen an mehreren Orten definiert ist, wird der Wert der Umgebungsvariable folgendermaßen bestimmt: + Der Wert im Aufruf zum Starten des Build-Vorgangs hat den höchsten Vorrang. + Der Wert in der Build-Projektdefinition folgt darauf. + Der Wert in der Deklaration in der buildspec-Datei hat die niedrigste Priorität. Weitere Informationen zu gültigen Werten für diese Platzhalter finden Sie unter [Erstellen eines Build-Projekts (AWS CLI)](create-project.md#create-project-cli). Eine Liste der neuesten Einstellungen für ein Build-Projekt finden Sie unter [Details zum Build-Projekt anzeigen](view-project-details.md). 1. Wechseln Sie in das Verzeichnis, das die soeben gespeicherte Datei enthält, und führen Sie den Befehl `start-build` erneut aus. ``` aws codebuild start-build --cli-input-json file://start-build.json ``` 1. Bei Erfolg enthält die Ausgabe Daten wie in der [So führen Sie den Build aus](getting-started-overview.md#getting-started-run-build-cli)-Anleitung beschrieben. Um mit den detaillierten Informationen über diesen Build zu arbeiten, notieren Sie sich den Wert `id` im der Ausgabe und zeigen Sie sich dann [Anzeigen von Build-Details (AWS CLI)](view-build-details.md#view-build-details-cli) an. # Führen Sie einen Batch-Build (AWS CLI) aus 1. Führen Sie den Befehl `start-build-batch` auf eine der folgenden Weisen aus: ``` aws codebuild start-build-batch --project-name ``` Sie können diesen Befehl verwenden, wenn Sie ein Build ausführen möchten, dass die neueste Version des Build-Eingabeartifakts und die vorhandenen Einstellungen des Build-Projekts einsetzt. ``` aws codebuild start-build-batch --generate-cli-skeleton > ``` Verwenden Sie diesen Befehl, wenn Sie einen Build mit einer früheren Version des Build-Eingabeartefakts verwenden oder die Einstellungen für Build-Ausgabeartefakte, Umgebungsvariablen, Build-Spezifikationen oder Standard-Build-Zeitbeschränkungen überschreiben möchten. 1. Wenn Sie den **start-build-batch** Befehl mit der `--project-name` Option ausführen, ersetzen Sie ihn durch den Namen des Build-Projekts, und fahren Sie dann ** mit Schritt 6 dieses Verfahrens fort. Informationen zum Abrufen einer Liste von Build-Projekten finden Sie unter [Namen von Build-Projekten anzeigen](view-project-list.md). 1. Wenn Sie den **start-build-batch** Befehl mit der `--idempotency-token` Option ausführen, ist ein eindeutiger Bezeichner (Token), bei dem die Groß- und Kleinschreibung beachtet wird, in der `start-build-batch` Anforderung enthalten. Das Token ist nach der Anforderung 5 Minuten gültig. Wenn Sie die `start-build-batch` Anforderung mit demselben Token wiederholen, aber einen Parameter ändern, wird ein Fehler CodeBuild zurückgegeben, bei dem die Parameter nicht übereinstimmen. 1. Wenn Sie den **start-build-batch** Befehl mit der `--generate-cli-skeleton` Option ausführen, werden Daten im JSON-Format in die Datei ausgegeben. ** Diese Datei ähnelt dem durch den **start-build** Befehl erstellten Grundgerüst, wurde jedoch um das folgende Objekt erweitert. Weitere Hinweise zu den gängigen Objekten finden Sie unter[Ausführen eines Build (AWS CLI)](run-build-cli.md). Ändern Sie diese Datei, um alle Build-Overrides hinzuzufügen, und speichern Sie Ihre Ergebnisse. ``` "buildBatchConfigOverride": { "combineArtifacts": combineArtifacts, "restrictions": { "computeTypesAllowed": [ allowedComputeTypes ], "maximumBuildsAllowed": maximumBuildsAllowed }, "serviceRole": "batchServiceRole", "timeoutInMins": batchTimeout } ``` Das `buildBatchConfigOverride` Objekt ist eine [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html)Struktur, die die Überschreibungen der Batch-Build-Konfiguration für diesen Build enthält. *combineArtifacts* Ein boolescher Wert, der angibt, ob die Build-Artefakte für den Batch-Build zu einem einzigen Artefakt-Speicherort zusammengefasst werden sollen. *allowedComputeTypes* Ein Array von Zeichenfolgen, die die Datenverarbeitungstypen angeben, die für den Stapel-Build zulässig sind. Informationen zu diesen Werten finden Sie unter [Berechnungstypen für die Build-Umgebung](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html). *maximumBuildsAllowed* Gibt die maximal zulässige Anzahl von Builds an. *batchServiceRole* Gibt die Servicerollen-ARN für das Stapel-Build-Projekt an. *batchTimeout* Gibt die maximale Zeitspanne in Minuten an, in der die Stapelerstellung abgeschlossen werden muss. 1. Wechseln Sie in das Verzeichnis, das die soeben gespeicherte Datei enthält, und führen Sie den Befehl `start-build-batch` erneut aus. ``` aws codebuild start-build-batch --cli-input-json file://start-build.json ``` 1. Bei Erfolg wird die JSON-Darstellung eines [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html)Objekts in der Konsolenausgabe angezeigt. Ein Beispiel für diese Daten finden Sie in der [StartBuildBatch Antwortsyntax](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax). # Ausführung von Builds automatisch starten (AWS CLI) Wenn Ihr Quellcode in einem GitHub oder einem GitHub Enterprise Server-Repository gespeichert ist, können Sie GitHub Webhooks verwenden, um Ihren Quellcode jedes Mal AWS CodeBuild neu erstellen zu lassen, wenn eine Codeänderung in das Repository übertragen wird. Führen Sie den Befehl **create-webhook** wie folgt aus: ``` aws codebuild create-webhook --project-name ``` **ist der Name des Build-Projekts, das den Quellcode enthält, der neu erstellt werden soll. Denn GitHub in der Ausgabe erscheinen Informationen, die den folgenden ähneln: ``` { "webhook": { "url": "" } } ``` **ist die URL zum GitHub Webhook. Für GitHub Enterprise Server erscheinen in der Ausgabe Informationen, die den folgenden ähneln: ![\[Beispiel für Ausgabeinformationen.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/create-webhook-ghe.png) 1. Kopieren Sie den geheimen Schlüssel und Nutzlast-URL aus der Ausgabe. Sie benötigen sie, um einen Webhook in GitHub Enterprise Server hinzuzufügen. 1. Wählen Sie in GitHub Enterprise Server das Repository aus, in dem Ihr CodeBuild Projekt gespeichert ist. Wählen Sie **Settings (Einstellungen)**, **Hooks & services (Hooks und Services)** und anschließend **Add webhook (Webhook hinzufügen)** aus. 1. Geben Sie die Nutzlast-URL und den geheimen Schlüssels ein, übernehmen Sie die Standardeinstellungen für die anderen Felder, und wählen Sie dann **Add webhook**. # Ausführung von Builds automatisch beenden (AWS CLI) Wenn Ihr Quellcode in einem GitHub oder einem GitHub Enterprise Server-Repository gespeichert ist, können Sie GitHub Webhooks so einrichten, dass Ihr Quellcode jedes Mal AWS CodeBuild neu erstellt wird, wenn eine Codeänderung in das Repository übertragen wird. Weitere Informationen finden Sie unter [Ausführung von Builds automatisch starten (AWS CLI)](run-build-cli-auto-start.md). Wenn Sie dieses Verhalten aktiviert haben, können Sie es ausschalten, indem Sie den `delete-webhook`-Befehl wie folgt ausführen: ``` aws codebuild delete-webhook --project-name ``` + wo ** ist der Name des Build-Projekts, das den Quellcode enthält, der neu erstellt werden soll. Ist dieser Befehl erfolgreich, werden in der Ausgabe keine Informationen und Fehler angezeigt. **Anmerkung** Dadurch wird nur der Webhook aus Ihrem CodeBuild Projekt gelöscht. Sie sollten den Webhook auch aus Ihrem Repository GitHub oder Ihrem GitHub Enterprise Server-Repository löschen. # Ausführen eines Build (AWS SDKs) Um einen Build mit auszuführen AWS CodeBuild, überspringen Sie diese Schritte und folgen Sie [Verwenden Sie AWS CodeBuild with AWS CodePipeline , um Code zu testen und Builds auszuführen](how-to-create-pipeline.md) stattdessen den Anweisungen unter. CodePipeline Informationen zur Verwendung CodeBuild mit dem AWS SDKs finden Sie unter[AWS SDKs und Werkzeug-Referenz](sdk-ref.md).