Batch 빌드 빌드 사양 참조

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

배치

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

배치/빠른 실패

선택 사항. 하나 이상의 빌드 작업이 실패할 때 배치 빌드의 동작을 지정합니다.

false

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

true

빌드 작업 중 하나가 실패하면 실행 중인 모든 빌드가 중지됩니다.

기본적으로 모든 배치 빌드 작업은 다음과 같은 빌드 설정으로 실행됩니다.env과phasesbuildspec 파일에 지정됩니다. 다른 빌드 설정을 지정해 기본 빌드 설정을 재정의할 수 있습니다.env값 또는 다른 빌드 사양 파일batch/<batch-type>/buildspec파라미터.

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

• batch/build-graph

• batch/build-list

• batch/build-matrix

batch/build-graph

를 정의합니다.그래프 작성. 빌드 그래프는 일괄 처리에서 다른 작업에 종속성이 있는 작업 집합을 정의합니다. 자세한 정보는 그래프 빌드을 참조하십시오.

이 요소에는 빌드 작업 배열이 포함되어 있습니다. 각 빌드 작업에는 다음 속성이 포함되어 있습니다.

확인자

필수. 작업의 식별자입니다.

buildspec

선택 사항. 이 작업에 사용할 buildspec 파일의 경로 및 파일 이름입니다. 이 파라미터를 지정하지 않은 경우 현재 buildspec 파일이 사용됩니다.

디버그-세션

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

false

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

true

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

종속

선택 사항. 이 작업이 종속되는 작업 식별자의 배열입니다. 이 작업은 이러한 작업이 완료될 때까지 실행되지 않습니다.

env

선택 사항. 작업에 대한 빌드 환경이 재정의됩니다. 여기에는 다음 속성이 포함될 수 있습니다.

컴퓨팅 유형

작업에 사용할 컴퓨팅 유형의 식별자입니다. 단원을 참조하십시오.computeType에서빌드 환경 컴퓨팅 유형가능한 값입니다.

이미지

작업에 사용할 이미지의 식별자입니다. 단원을 참조하십시오.이미지 식별자에서CodeBuild에서 제공하는 도커 이미지가능한 값입니다.

권한 모드

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

유형

작업에 사용할 환경 유형의 식별자입니다. 단원을 참조하십시오.환경 유형에서빌드 환경 컴퓨팅 유형가능한 값입니다.

변수

빌드 환경에 존재할 환경 변수입니다. 자세한 내용은 env/variables를 참조하십시오.

실패 무시

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

false

default 기본값입니다. 이 빌드 작업이 실패하면 배치 빌드가 실패합니다.

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

를 정의합니다.빌드 리스트. 빌드 목록은 병렬로 실행되는 여러 작업을 정의하는 데 사용됩니다. 자세한 정보는 빌드 리스트을 참조하십시오.

이 요소에는 빌드 작업 배열이 포함되어 있습니다. 각 빌드 작업에는 다음 속성이 포함되어 있습니다.

확인자

필수. 작업의 식별자입니다.

buildspec

선택 사항. 이 작업에 사용할 buildspec 파일의 경로 및 파일 이름입니다. 이 파라미터를 지정하지 않은 경우 현재 buildspec 파일이 사용됩니다.

디버그-세션

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

false

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

true

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

env

선택 사항. 작업에 대한 빌드 환경이 재정의됩니다. 여기에는 다음 속성이 포함될 수 있습니다.

컴퓨팅 유형

작업에 사용할 컴퓨팅 유형의 식별자입니다. 단원을 참조하십시오.computeType에서빌드 환경 컴퓨팅 유형가능한 값입니다.

이미지

작업에 사용할 이미지의 식별자입니다. 단원을 참조하십시오.이미지 식별자에서CodeBuild에서 제공하는 도커 이미지가능한 값입니다.

권한 모드

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

유형

작업에 사용할 환경 유형의 식별자입니다. 단원을 참조하십시오.환경 유형에서빌드 환경 컴퓨팅 유형가능한 값입니다.

변수

빌드 환경에 존재할 환경 변수입니다. 자세한 내용은 env/variables를 참조하십시오.

실패 무시

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

false

default 기본값입니다. 이 빌드 작업이 실패하면 배치 빌드가 실패합니다.

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는 가능한 구성 조합에 대해 별도의 빌드를 만듭니다. 자세한 정보는 빌드 행렬을 참조하십시오.

공전

정적 속성은 모든 빌드 작업에 적용됩니다.

실패 무시

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

false

default 기본값입니다. 이 빌드 작업이 실패하면 배치 빌드가 실패합니다.

true

이 빌드 작업이 실패해도 배치 빌드는 여전히 성공할 수 있습니다.

env

선택 사항. 빌드 환경은 모든 작업에 대해 재정의됩니다.

권한 모드

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

유형

작업에 사용할 환경 유형의 식별자입니다. 단원을 참조하십시오.환경 유형에서빌드 환경 컴퓨팅 유형가능한 값입니다.

동적

동적 속성은 빌드 행렬을 정의합니다.

buildspec

선택 사항. 이러한 작업에 사용할 buildspec 파일의 경로 및 파일 이름을 포함하는 배열입니다. 이 파라미터를 지정하지 않은 경우 현재 buildspec 파일이 사용됩니다.

env

선택 사항. 이러한 작업에 대한 빌드 환경이 재정의됩니다.

컴퓨팅 유형

이러한 작업에 사용할 계산 유형의 식별자를 포함하는 배열입니다. 단원을 참조하십시오.computeType에서빌드 환경 컴퓨팅 유형가능한 값입니다.

이미지

이러한 작업에 사용할 이미지의 식별자를 포함하는 배열입니다. 단원을 참조하십시오.이미지 식별자에서CodeBuild에서 제공하는 도커 이미지가능한 값입니다.

변수

이러한 작업을 위해 빌드 환경에 존재할 환경 변수를 포함하는 배열입니다. 자세한 내용은 env/variables를 참조하십시오.

다음은 빌드 행렬 buildspec 항목을 보여주는 예입니다.

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

자세한 내용은 빌드 행렬 단원을 참조하세요.