

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.

# Builds lokal mit dem AWS CodeBuild Agenten ausführen
<a name="use-codebuild-agent"></a>

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
<a name="use-codebuild-agent.prerequisites"></a>

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
<a name="use-codebuild-agent.setup-image"></a>

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. <a name="codebuild-agent-sha"></a>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
<a name="use-codebuild-agent.run-agent"></a>

**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 <container-image> -a <output directory>
   ```

   Führen Sie den folgenden Befehl aus, um einen ARM-Build auszuführen:

   ```
   $ ./codebuild_build.sh -i <container-image> -a <output directory> -l public.ecr.aws/codebuild/local-builds:aarch64
   ```

   *<container-image>*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 <build project directory>` Option zum Skriptbefehl hinzu.

## Erhalten Sie Benachrichtigungen für neue CodeBuild Agentenversionen
<a name="receive-codebuild-agent-notifications"></a>

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. 