기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 프로그래밍 방식으로 Buildkite 실행기 설정
<a name="sample-runner-buildkite-CLI"></a>

프로그래밍 방식으로 Buildkite 러너 프로젝트를 구성하려면 다음 리소스를 구성해야 합니다.

**프로그래밍 방식으로 Buildkite 실행기를 생성하려면**

1. Buildkite 에이전트 토큰을 생성하고 토큰을 내에 일반 텍스트로 저장합니다 AWS Secrets Manager.

1. 원하는 구성으로 CodeBuild 프로젝트를 설정합니다. 다음과 같은 추가 속성을 구성해야 합니다.

   1. 이름이 `CODEBUILD_CONFIG_BUILDKITE_AGENT_TOKEN`이고, 유형이 이고`SECRETS_MANAGER`, 값이 Buildkite 클러스터와 연결된 Buildkite 에이전트 토큰과 같은 환경 값입니다.

   1. 소스 유형이과 같음 `NO_SOURCE`

   1. 프로젝트 서비스 역할의 1단계에서 생성된 보안 암호에 액세스할 수 있는 권한

   예를 들어 다음 명령을 사용하여 CLI를 통해 유효한 Buildkite 러너 프로젝트를 생성할 수 있습니다.

   ```
   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. 2단계에서 생성한 프로젝트에 Buildkite 러너 웹후크를 생성합니다. 웹후크를 생성할 때 다음 구성 옵션을 사용해야 합니다.

   1. **build-type**은와 같아야 합니다. `RUNNER_BUILDKITE_BUILD` 

   1. 유형이 `EVENT` 이고 패턴이 인 필터 `WORKFLOW_JOB_QUEUED` 

   예를 들어 다음 명령을 사용하여 CLI를 통해 유효한 Buildkite 러너 웹후크를 생성할 수 있습니다.

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

1. `create-webhook` 호출에서 반환한 **페이로드 URL** 및 **보안** 암호 값을 저장하고 자격 증명을 사용하여 Buildkite 콘솔 내에서 웹후크를 생성합니다. 이 리소스를 설정하는 방법에 [자습서: CodeBuild 호스팅 Buildkite 실행기 구성](sample-runner-buildkite.md) 대한 가이드는의 Buildkite 내에서 3단계: CodeBuild 웹후크 생성을 참조할 수 있습니다.