Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menyiapkan pelari Buildkite secara terprogram
<a name="sample-runner-buildkite-CLI"></a>

Untuk mengkonfigurasi proyek Buildkite runner secara terprogram, Anda perlu mengkonfigurasi sumber daya berikut:

**Untuk membuat pelari Buildkite secara terprogram**

1. Buat token agen Buildkite dan simpan token dalam plaintext di dalamnya. AWS Secrets Manager

1. Siapkan CodeBuild proyek dengan konfigurasi pilihan Anda. Anda perlu mengonfigurasi atribut tambahan berikut:

   1. Nilai lingkungan dengan nama`CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN`, jenis`SECRETS_MANAGER`, dan nilai yang sama dengan token agen Buildkite yang terkait dengan cluster Buildkite Anda.

   1. Jenis sumber sama dengan `NO_SOURCE`

   1. Izin untuk mengakses rahasia yang dibuat pada langkah 1 dalam peran layanan proyek Anda

   Misalnya, Anda dapat menggunakan perintah berikut untuk membuat proyek Buildkite runner yang valid melalui 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. Buat webhook pelari Buildkite pada proyek yang dibuat pada langkah 2. Anda harus menggunakan opsi konfigurasi berikut saat membuat webhook:

   1. **tipe bangunan ** harus sama dengan `RUNNER_BUILDKITE_BUILD`

   1. Filter dengan tipe `EVENT` dan pola yang sama dengan `WORKFLOW_JOB_QUEUED` 

   Misalnya, Anda dapat menggunakan perintah berikut untuk membuat webhook Buildkite runner yang valid melalui CLI:

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

1. Simpan ** nilai URL ** Payload ** dan ** Rahasia yang dikembalikan oleh `create-webhook` panggilan dan gunakan kredenSIAL untuk membuat webhook di dalam konsol Buildkite. Anda dapat merujuk Langkah 3: Buat CodeBuild webhook di Buildkite [Tutorial: Konfigurasikan pelari CodeBuild-hosted Buildkite](sample-runner-buildkite.md) untuk panduan tentang cara mengatur sumber daya ini.