배치 빌드 buildspec 참조

이 주제에는 배치 빌드 속성에 대한 buildspec 참조가 포함되어 있습니다.

배치

선택적 매핑. 프로젝트에 대한 배치 빌드 설정입니다.

배치/빠른 실패

선택 사항. 하나 이상의 빌드 태스크가 실패할 경우 배치 빌드의 동작을 지정합니다.

false

기본값입니다. 실행 중인 모든 빌드가 완료됩니다.

true

빌드 태스크 중 하나가 실패하면 실행 중인 모든 빌드가 중지됩니다.

기본적으로 모든 배치 빌드 태스크는 buildspec 파일에 지정된 env 및 phases와 같은 빌드 설정으로 실행됩니다. batch/<batch-type>/buildspec 파라미터에 다른 env 값이나 다른 buildspec 파일을 지정하여 기본 빌드 설정을 재정의할 수 있습니다.

batch 속성의 내용은 지정된 배치 빌드 유형에 따라 달라집니다. 가능한 배치 빌드 유형은 다음과 같습니다.

• batch/build-graph

• batch/build-list

• batch/build-matrix

batch/build-graph

빌드 그래프를 정의합니다. 빌드 그래프는 일괄 처리의 다른 태스크에 종속되는 일련의 태스크를 정의합니다. 자세한 내용은 빌드 그래프 섹션을 참조하세요.

이 요소에는 빌드 태스크의 배열이 포함되어 있습니다. 각 빌드 태스크는 다음 속성을 포함합니다.

identifier

필수. 태스크의 식별자입니다.

buildspec

선택 사항. 태스크에 사용할 buildspec 파일의 경로 및 파일 이름입니다. 이 파라미터를 지정하지 않으면 현재 buildspec인 파일이 사용됩니다.

debug-session

선택 사항. 이 배치 빌드에 세션 디버깅을 활성화할지를 여부를 나타내는 부울 값입니다. 세션 디버깅에 대한 자세한 내용은 Session Manager에서 실행 중인 빌드 보기 섹션을 참조하세요.

false

세션 디버깅이 비활성화되었습니다.

true

세션 디버깅이 활성화되었습니다.

depend-on

선택 사항. 이 태스크가 의존하는 태스크 식별자의 배열입니다. 이 태스크는 이러한 태스크가 완료될 때까지 실행되지 않습니다.

env

선택 사항. 태스크에 대한 빌드 환경 재정의입니다. 여기에는 다음 속성이 포함됩니다.

compute-type

태스크에 사용할 컴퓨팅 유형의 식별자입니다. 가능한 값은 빌드 환경 컴퓨팅 모드 및 유형의 computeType을 참조하세요.

image

태스크에 사용할 이미지의 식별자입니다. 가능한 값은 Docker 이미지 제공: CodeBuild의 이미지 식별자를 참조하세요.

privileged-mode

Docker 컨테이너 내부에서 Docker 대몬(daemon)을 실행할지 여부를 나타내는 부울 값입니다. 빌드 프로젝트가 도커 이미지를 빌드하는 데 사용되는 경우에만 true로 설정합니다. 그렇지 않으면 도커 데몬과 상호 작용을 시도하는 빌드가 실패합니다. 기본 설정은 false입니다.

type

태스크에 사용할 환경 유형의 식별자입니다. 가능한 값은 빌드 환경 컴퓨팅 모드 및 유형에서 환경 유형을 참조하세요.

variables

빌드 환경에 표시될 환경 변수입니다. 자세한 내용은 env/variables 섹션을 참조하세요.

ignore-failure

선택 사항. 이 빌드 태스크의 실패를 무시할 수 있는지 여부를 나타내는 부울 값입니다.

false

기본값입니다. 이 빌드 태스크가 실패하면 배치 빌드가 실패합니다.

true

이 빌드 태스크가 실패하더라도 배치 빌드는 여전히 성공할 수 있습니다.

다음은 빌드 그래프 buildSpec 항목의 예제입니다.

batch:
  fast-fail: false
  build-graph:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      depend-on:
        - build1
    - identifier: build3
      env:
        variables:
          BUILD_ID: build3
      depend-on:
        - build2

batch/build-list

빌드 목록을 정의합니다. 빌드 목록은 병렬로 실행되는 여러 태스크를 정의하는 데 사용됩니다. 자세한 내용은 빌드 목록 섹션을 참조하세요.

이 요소에는 빌드 태스크의 배열이 포함되어 있습니다. 각 빌드 태스크는 다음 속성을 포함합니다.

identifier

필수. 태스크의 식별자입니다.

buildspec

선택 사항. 태스크에 사용할 buildspec 파일의 경로 및 파일 이름입니다. 이 파라미터를 지정하지 않으면 현재 buildspec인 파일이 사용됩니다.

debug-session

선택 사항. 이 배치 빌드에 세션 디버깅을 활성화할지를 여부를 나타내는 부울 값입니다. 세션 디버깅에 대한 자세한 내용은 Session Manager에서 실행 중인 빌드 보기 섹션을 참조하세요.

false

세션 디버깅이 비활성화되었습니다.

true

세션 디버깅이 활성화되었습니다.

env

선택 사항. 태스크에 대한 빌드 환경 재정의입니다. 여기에는 다음 속성이 포함됩니다.

compute-type

태스크에 사용할 컴퓨팅 유형의 식별자입니다. 가능한 값은 빌드 환경 컴퓨팅 모드 및 유형의 computeType을 참조하세요.

image

태스크에 사용할 이미지의 식별자입니다. 가능한 값은 Docker 이미지 제공: CodeBuild의 이미지 식별자를 참조하세요.

privileged-mode

Docker 컨테이너 내부에서 Docker 대몬(daemon)을 실행할지 여부를 나타내는 부울 값입니다. 빌드 프로젝트가 도커 이미지를 빌드하는 데 사용되는 경우에만 true로 설정합니다. 그렇지 않으면 도커 데몬과 상호 작용을 시도하는 빌드가 실패합니다. 기본 설정은 false입니다.

유형

태스크에 사용할 환경 유형의 식별자입니다. 가능한 값은 빌드 환경 컴퓨팅 모드 및 유형에서 환경 유형을 참조하세요.

variables

빌드 환경에 표시될 환경 변수입니다. 자세한 내용은 env/variables 섹션을 참조하세요.

ignore-failure

선택 사항. 이 빌드 태스크의 실패를 무시할 수 있는지 여부를 나타내는 부울 값입니다.

false

기본값입니다. 이 빌드 태스크가 실패하면 배치 빌드가 실패합니다.

true

이 빌드 태스크가 실패하더라도 배치 빌드는 여전히 성공할 수 있습니다.

다음은 빌드 목록 buildSpec 항목의 예제입니다.

batch:
  fast-fail: false
  build-list:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      ignore-failure: true

batch/build-matrix

빌드 매트릭스를 정의합니다. 빌드 매트릭스는 병렬로 실행되는 다양한 구성의 태스크를 정의합니다. CodeBuild는 가능한 각 구성 조합에 대해 별도의 빌드를 생성합니다. 자세한 내용은 빌드 매트릭스 섹션을 참조하세요.

static

정적 속성은 모든 빌드 태스크에 적용됩니다.

ignore-failure

선택 사항. 이 빌드 태스크의 실패를 무시할 수 있는지 여부를 나타내는 부울 값입니다.

false

기본값입니다. 이 빌드 태스크가 실패하면 배치 빌드가 실패합니다.

true

이 빌드 태스크가 실패하더라도 배치 빌드는 여전히 성공할 수 있습니다.

env

선택 사항. 모든 태스크에 대한 빌드 환경 재정의입니다.

privileged-mode

Docker 컨테이너 내부에서 Docker 대몬(daemon)을 실행할지 여부를 나타내는 부울 값입니다. 빌드 프로젝트가 도커 이미지를 빌드하는 데 사용되는 경우에만 true로 설정합니다. 그렇지 않으면 도커 데몬과 상호 작용을 시도하는 빌드가 실패합니다. 기본 설정은 false입니다.

type

태스크에 사용할 환경 유형의 식별자입니다. 가능한 값은 빌드 환경 컴퓨팅 모드 및 유형에서 환경 유형을 참조하세요.

dynamic

동적 속성은 빌드 매트릭스를 정의합니다.

buildspec

선택 사항. 이러한 태스크에 사용할 buildspec 파일의 경로와 파일 이름을 포함하는 배열입니다. 이 파라미터를 지정하지 않으면 현재 buildspec인 파일이 사용됩니다.

env

선택 사항. 이러한 태스크에 대해 빌드 환경이 재정의됩니다.

compute-type

이러한 태스크에 사용할 컴퓨팅 유형의 식별자가 포함된 배열입니다. 가능한 값은 빌드 환경 컴퓨팅 모드 및 유형의 computeType을 참조하세요.

image

이러한 태스크에 사용할 이미지의 식별자가 포함된 배열입니다. 가능한 값은 Docker 이미지 제공: CodeBuild의 이미지 식별자를 참조하세요.

variables

이러한 태스크에 대한 빌드 환경에 표시될 환경 변수를 포함하는 배열입니다. 자세한 내용은 env/variables 섹션을 참조하세요.

다음은 빌드 매트릭스 buildSpec 항목의 예제입니다.

batch:
  build-matrix:
    static:
      ignore-failure: false
    dynamic:
      buildspec: 
        - matrix1.yml
        - matrix2.yml
      env:
        variables:
          MY_VAR:
            - VALUE1
            - VALUE2
            - VALUE3

자세한 내용은 빌드 매트릭스 섹션을 참조하세요.