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

# 배치 빌드 실행(AWS CLI)
<a name="run-batch-build-cli"></a>

1. 다음 중 한 방법으로 `start-build-batch` 명령을 실행합니다.

   ```
   aws codebuild start-build-batch --project-name <project-name>
   ```

   빌드 입력 결과물의 최신 버전과 빌드 프로젝트의 기존 설정을 사용하는 빌드를 실행하려면 이 방법을 사용합니다.

   ```
   aws codebuild start-build-batch --generate-cli-skeleton > <json-file>
   ```

   이전 버전의 빌드 입력 결과물을 사용하여 빌드를 실행하려는 경우 또는 빌드 출력 결과물, 환경 변수, buildspec 또는 기본 빌드 제한 시간의 설정을 재정의하려는 경우 이 방법을 사용합니다.

1. **start-build-batch** 명령을 `--project-name` 옵션과 함께 실행하는 경우 *<project-name>*을 빌드 프로젝트의 이름으로 바꾼 다음 이 절차의 6단계로 이동합니다. 빌드 프로젝트 목록을 가져오려면 [빌드 프로젝트 이름 보기](view-project-list.md) 단원을 참조하십시오.

1. **start-build-batch** 명령을 `--idempotency-token` 옵션과 함께 실행하면 고유의 대소문자 구분 식별자 또는 토큰이 `start-build-batch` 요청에 포함됩니다. 토큰은 요청 후 5분 동안 유효합니다. 동일한 토큰을 사용하여 `start-build-batch` 요청을 반복하고 파라미터를 변경하면 CodeBuild는 파라미터 불일치 오류를 반환합니다.

1. **start-build-batch** 명령을 `--generate-cli-skeleton` 옵션과 함께 실행하는 경우 JSON 형식 데이터가 *<json-file>* 파일에 출력됩니다. 이 파일은 **start-build** 명령으로 생성된 스켈레톤과 비슷하지만 다음 객체가 추가되었습니다. 일반 객체에 대한 자세한 내용은 [빌드 실행(AWS CLI)](run-build-cli.md) 섹션을 참조하세요.

   이 파일을 수정하여 빌드 재정의를 추가하고 결과를 저장하세요.

   ```
     "buildBatchConfigOverride": {
       "combineArtifacts": combineArtifacts,
       "restrictions": {
         "computeTypesAllowed": [
           allowedComputeTypes
         ],
         "maximumBuildsAllowed": maximumBuildsAllowed
       },
       "serviceRole": "batchServiceRole",
       "timeoutInMins": batchTimeout
     }
   ```

   `buildBatchConfigOverride` 객체는 이 빌드에 대한 배치 빌드 구성 재정의를 포함하는 [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html) 구조입니다.  
*combineArtifacts*  
배치 빌드의 빌드 아티팩트를 단일 아티팩트 위치로 결합할지 여부를 지정하는 부울입니다.  
*allowedComputeTypes*  
배치 빌드에 허용되는 컴퓨팅 유형을 지정하는 문자열 배열입니다. 이러한 값은 [빌드 환경 컴퓨팅 유형](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html)를 참조하세요.  
*maximumBuildsAllowed*  
허용되는 최대 빌드 수를 지정합니다.  
*batchServiceRole*  
배치 빌드 프로젝트에 대한 서비스 역할 ARN을 지정합니다.  
*batchTimeout*  
배치 빌드를 완료해야 하는 최대 시간(분)을 지정합니다.

1. 방금 저장한 파일이 들어 있는 디렉터리로 전환한 다음, `start-build-batch` 명령을 다시 실행합니다.

   ```
   aws codebuild start-build-batch --cli-input-json file://start-build.json
   ```

1. 성공하면 [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html) 객체의 JSON 표현이 콘솔 출력에 나타납니다. 이 데이터의 예는 [StartBuildBatch 응답 구문](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax)을 참조하세요.