View a markdown version of this page

Configuration d'un Runner Buildkite par programmation - AWS CodeBuild

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration d'un Runner Buildkite par programmation

Pour configurer un projet Buildkite Runner par programmation, vous devez configurer les ressources suivantes :

Pour créer un lanceur Buildkite par programmation

  1. Créez un jeton d'agent Buildkite et enregistrez-le en texte brut à l'intérieur. AWS Secrets Manager

  2. Configurez un CodeBuild projet avec la configuration de votre choix. Vous devrez configurer les attributs supplémentaires suivants :

    1. Une valeur d'environnement avec un nomCODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN, un type SECRETS_MANAGER et une valeur égale au jeton d'agent Buildkite associé à votre cluster Buildkite.

    2. Type de source égal à NO_SOURCE

    3. Autorisations d'accès au secret créé à l'étape 1 dans le rôle de service de votre projet

    Par exemple, vous pouvez utiliser la commande suivante pour créer un projet Buildkite Runner valide via la CLI :

    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. Créez un webhook Buildkite Runner sur le projet créé à l'étape 2. Vous devrez utiliser les options de configuration suivantes lors de la création du webhook :

    1. build-type doit être égal à RUNNER_BUILDKITE_BUILD

    2. Un filtre dont le type EVENT et le motif sont égaux à WORKFLOW_JOB_QUEUED

    Par exemple, vous pouvez utiliser la commande suivante pour créer un webhook Buildkite runner valide via la CLI :

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

  4. Enregistrez l'URL de la charge utile et les valeurs secrètes renvoyées par l'create-webhookappel et utilisez les informations d'identification pour créer un webhook dans la console Buildkite. Vous pouvez consulter Étape 3 : Création d'un CodeBuild webhook dans Buildkite Tutoriel : Configuration d'un moteur CodeBuild-hosted Buildkite pour obtenir un guide sur la configuration de cette ressource.