View a markdown version of this page

Programmgesteuertes Einrichten eines Buildkite-Runners - 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.

Programmgesteuertes Einrichten eines Buildkite-Runners

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

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

    1. Ein Umgebungswert mit NameCODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN, Typ und einem WertSECRETS_MANAGER, der dem Buildkite-Agent-Token entspricht, das Ihrem Buildkite-Cluster zugeordnet ist.

    2. Quelltyp gleich NO_SOURCE

    3. 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>

  3. 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

    2. 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

  4. 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 Buildkite.