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.

# Programmgesteuertes Einrichten eines Buildkite-Runners
<a name="sample-runner-buildkite-CLI"></a>

Um ein Buildkite-Runner-Projekt programmgesteuert zu konfigurieren, müssen Sie die folgenden Ressourcen konfigurieren:

**Um einen Buildkite-Runner programmgesteuert zu erstellen**

1. Erstellen Sie ein Buildkite-Agenten-Token und speichern Sie das Token darin im Klartext. AWS Secrets Manager

1. Richten Sie ein CodeBuild Projekt mit Ihrer bevorzugten Konfiguration ein. Sie müssen die folgenden zusätzlichen Attribute konfigurieren:

   1. Ein Umgebungswert mit Name`CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN`, Typ und einem Wert`SECRETS_MANAGER`, der dem Buildkite-Agent-Token entspricht, das Ihrem Buildkite-Cluster zugeordnet ist.

   1. Quelltyp gleich `NO_SOURCE`

   1. Zugriffsberechtigungen für das Geheimnis, das in Schritt 1 in der Servicerolle Ihres Projekts erstellt wurde

   Sie können beispielsweise den folgenden Befehl verwenden, um ein gültiges Buildkite-Runner-Projekt über die CLI zu erstellen:

   ```
   aws codebuild create-project \
   --name buildkite-runner-project \
   --source "{\"type\": \"NO_SOURCE\",\"buildspec\":\"\"}" \
   --environment "{\"image\":\"aws/codebuild/amazonlinux-x86_64-standard:5.0\",\"type\":\"LINUX_CONTAINER\",\"computeType\":\"BUILD_GENERAL1_MEDIUM\",\"environmentVariables\":[{\"name\":\"CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN\",\"type\":\"SECRETS_MANAGER\",\"value\":\"<buildkite-secret-name>\"}]}" \
   --artifacts "{\"type\": \"NO_ARTIFACTS\"}" \
   --service-role {{<service-role>}}
   ```

1. Erstellen Sie einen Buildkite Runner-Webhook für das in Schritt 2 erstellte Projekt. Sie müssen beim Erstellen des Webhooks die folgenden Konfigurationsoptionen verwenden:

   1. **build-type ** sollte gleich sein `RUNNER_BUILDKITE_BUILD`

   1. Ein Filter mit einem Typ `EVENT` und einem Muster, das gleich ist `WORKFLOW_JOB_QUEUED` 

   Sie können beispielsweise den folgenden Befehl verwenden, um über die CLI einen gültigen Buildkite Runner-Webhook zu erstellen:

   ```
   aws codebuild create-webhook \
   --project-name buildkite-runner-project \
   --filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"WORKFLOW_JOB_QUEUED\"}]]" \
   --build-type RUNNER_BUILDKITE_BUILD
   ```

1. Speichern Sie die ** Payload-URL ** und die ** ** Secret-Werte, die vom `create-webhook` Aufruf zurückgegeben wurden, und verwenden Sie die Anmeldeinformationen, um einen Webhook in der Buildkite-Konsole zu erstellen. Eine Anleitung zum Einrichten dieser Ressource finden Sie in Schritt 3: Erstellen Sie einen CodeBuild Webhook in [Tutorial: Konfiguriere einen CodeBuild-hosted Buildkite Runner](sample-runner-buildkite.md) Buildkite.