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
<a name="sample-runner-buildkite-CLI"></a>

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

1. 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 nom`CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN`, un type `SECRETS_MANAGER` et une valeur égale au jeton d'agent Buildkite associé à votre cluster Buildkite.

   1. Type de source égal à `NO_SOURCE`

   1. 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>}}
   ```

1. 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`

   1. 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
   ```

1. Enregistrez l'URL de la ** charge utile ** et ** les valeurs ** secrètes renvoyées par l'`create-webhook`appel 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](sample-runner-buildkite.md) pour obtenir un guide sur la configuration de cette ressource.