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

# CodeBuild 호스팅 Buildkite 실행기에서 지원되는 레이블 재정의
<a name="buildkite-runner-update-labels"></a>

Buildkite 파이프라인 단계에서 에이전트 태그 레이블을 지정하면 자체 호스팅된 러너 빌드를 수정하는 다양한 레이블 재정의를 제공할 수 있습니다. CodeBuild에서 인식하지 못하는 빌드는 무시되지만 웹후크 요청에 실패하지는 않습니다. 예를 들어 다음 워크플로 YAML에는 이미지, 인스턴스 크기, 플릿 및 buildspec에 대한 재정의를 포함합니다.

```
agents:
  queue: "myQueue"
steps:
  - command: "echo \"Hello World\""
    agents:
      project: "codebuild-myProject"
      image: "{{matrix.os}}"
      instance-size: "{{matrix.size}}"
      buildspec-override: "true"
    matrix:
      setup:
        os:
          - "arm-3.0"
          - "al2-5.0"
        size:
          - "small"
          - "large"
```

 `project:codebuild-<project-name>`(필수)
+ 예시: `project: "codebuild-myProject"`
+ 모든 Buildkite 파이프라인 단계 구성에 필요합니다. *<project name>*은 자체 호스팅 러너 웹후크가 구성된 프로젝트의 이름과 같아야 합니다.

`queue: "<queue-name>"`
+ 예시: `queue: "<queue-name>"`
+ Buildkite 작업을 특정 대기열로 라우팅하는 데 사용됩니다. 자세한 내용은 [ Buildkite 에이전트 대기열 태그를 ](https://buildkite.com/docs/agent/v3/cli-start#the-queue-tag) 참조하세요.

 `image: "<environment-type>-<image-identifier>"` 
+ 예시: `image: "arm-3.0"`
+ 큐레이션된 이미지로 자체 호스팅 러너 빌드를 시작할 때 사용되는 이미지 및 환경 유형을 재정의합니다. 지원되는 값에 대한 자세한 내용은 [CodeBuild 호스팅 Buildkite 러너에서 지원되는 컴퓨팅 이미지](buildkite-runner-update-yaml.images.md) 섹션을 참조하세요.

  1. 사용자 지정 이미지와 함께 사용되는 이미지 및 환경 유형을 재정의하려면를 사용합니다. `image: "custom-<environment-type>-<custom-image-identifier>"` 

  1. 예제: 

     ```
     image:
           "custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0"
     ```
**참고**  
사용자 지정 이미지가 프라이빗 레지스트리에 있는 경우 CodeBuild 프로젝트에서 적절한 레지스트리 자격 증명을 구성해야 합니다.

`instance-size: "<instance-size>"`
+ 예시: `instance-size: "medium"`
+ 자체 호스팅 실행기 빌드를 시작할 때 사용되는 인스턴스 유형을 재정의합니다. 지원되는 값에 대한 자세한 내용은 [CodeBuild 호스팅 Buildkite 러너에서 지원되는 컴퓨팅 이미지](buildkite-runner-update-yaml.images.md) 섹션을 참조하세요.

`fleet: "<fleet-name>"`
+ 예시: `fleet: "myFleet"`
+ 지정된 플릿을 사용하도록 프로젝트에 구성된 플릿 설정을 재정의합니다. 자세한 내용은 [ 예약된 용량 플릿에서 빌드 실행을 참조하세요](https://docs.aws.amazon.com/codebuild/latest/userguide/fleets.html).

`buildspec-override: "<boolean>"`
+ 예시: `buildspec-override: "true"`
+ `true`로 설정된 경우 빌드가 `INSTALL`, `PRE_BUILD` 및 `POST_BUILD` 단계에서 buildspec 명령을 실행하도록 허용합니다.