에 대한 빌드 사양 참조 CodeBuild

선택적 시퀀스. Linux 또는 Windows 운영 체제에서 지원되는 쉘을 지정합니다.

Linux 운영 체제의 경우 지원되는 쉘 태그는 다음과 같습니다.

Windows 운영 체제의 경우 지원되는 쉘 태그는 다음과 같습니다.

env가 지정된 경우 및 사용자 지정 환경 변수를 일반 텍스트로 정의하려고 할 때 필요합니다. 의 매핑을 포함합니다.key/value 각 매핑이 일반 텍스트로 된 단일 사용자 지정 환경 변수를 나타내는 스칼라입니다.key 는 사용자 지정 환경 변수의 이름이며,value 는 변수의 값입니다.

env 이 지정되어 있고 Amazon EC2 Systems Manager 파라미터 스토어에 저장된 사용자 지정 환경 변수를 검색하려는 경우 필수입니다. 의 매핑을 포함합니다.key/value 각 매핑이 Amazon EC2 Systems Manager 파라미터 스토어에 저장된 단일 사용자 지정 환경 변수를 나타내는 스칼라입니다.key 는 나중에 빌드 명령에서 이 사용자 지정 환경 변수를 참조하는 데 사용하는 이름이며,value 는 Amazon EC2 Systems Manager 파라미터 스토어에 저장된 사용자 지정 환경 변수의 이름입니다. 민감한 값을 저장하려면 Amazon EC2 Systems Manager 사용 설명서의 Systems Manager 파라미터 스토어 및 연습: 문자열 파라미터 생성 및 테스트(콘솔)를 참조하세요.

에 저장된 사용자 지정 환경 변수를 검색하려는 경우 필요합니다 AWS Secrets Manager. 다음 패턴을 사용하여 Secrets Manager reference-key를 지정합니다.

<key>: <secret-id>:<json-key>:<version-stage>:<version-id>

다음 예제에서 TestSecret은 Secrets Manager에 저장되는 키-값 페어의 이름입니다. TestSecret의 키는 MY_SECRET_VAR입니다. 빌드 중에 LOCAL_SECRET_VAR 이름을 사용하여 변수에 액세스합니다.

env:
  secrets-manager:
    LOCAL_SECRET_VAR: "TestSecret:MY_SECRET_VAR"

자세한 내용은AWS Secrets Manager 사용 설명서에서 AWS Secrets Manager란 무엇입니까? 단원을 참조하세요.

선택적 매핑. 내보낼 환경 변수를 나열하는 데 사용됩니다. exported-variables에서 별도의 행에 내보낼 각 변수의 이름을 지정합니다. 내보낼 변수는 빌드 중에 컨테이너에서 사용할 수 있어야 합니다. 내보내는 변수는 환경 변수일 수 있습니다.

내보낸 환경 변수는 와 함께 현재 빌드 단계에서 파이프라인의 후속 단계로 환경 변수를 AWS CodePipeline 내보내는 데 사용됩니다. 자세한 내용을 알아보려면AWS CodePipeline 사용 설명서의 변수 작업을 참조하세요.

빌드하는 동안 변수의 값은 install 단계부터 사용할 수 있습니다. 이 값은 install 단계 시작과 post_build 단계 끝 사이에서 업데이트할 수 있습니다. post_build 단계가 끝나면 내보낸 변수의 값을 변경할 수 없습니다.

선택적 매핑. CodeBuild 가 Git 자격 증명 도우미를 사용하여 Git 자격 증명을 제공하는yes지 여부를 나타내는 데 사용됩니다. 그렇지 않은 경우 no이거나 값이 지정되지 않은 것입니다. 자세한 내용은 Git 웹사이트의 gitcredentials를 참조하십시오.

선택적 매핑. 명시적 프록시 서버에서 빌드가 아티팩트를 업로드하도록 하려면 yes로 설정합니다. 기본값은 no입니다.

선택적 매핑. 명시적 프록시 서버의 yes 빌드에서 CloudWatch 로그를 생성하려면 를 로 설정합니다. 기본값은 no입니다.

선택적 시퀀스. 해당 명령을 실행하는 Linux 사용자를 지정하려면 빌드 단계에 사용합니다. buildspec 파일의 상단에 모든 명령에 대해 전역적으로 run-as도 지정할 경우 단계 수준 사용자가 우선 적용됩니다. 예를 들어 전체적으로 run-as에서 User-1을 지정하고 해당 install 단계에 대해서만 run-as 명령문이 User-2를 지정하는 경우, 해당 install 단계의 명령이 User-2로 실행되는 것을 제외하고 buildspec 파일의 모든 명령은 User-1으로 실행됩니다.

선택적 시퀀스. 단계 중에 오류가 발생할 경우 수행할 작업을 지정합니다. 다음 값 중 하나일 수 있습니다:

이 속성을 지정하지 않으면 오류 프로세스는 빌드 단계 진행에 표시된 전환 단계를 따릅니다.

선택적 블록. finally 블록에 지정된 명령은 commands 블록의 명령 후에 실행됩니다. finally 블록의 명령은 commands 블록의 명령이 실패할 경우에도 실행됩니다. 예를 들어 commands 블록에 3개의 명령이 있고 첫 번째 명령이 실패하면 나머지 2개의 명령을 CodeBuild 건너뛰고 finally 블록에서 명령을 실행합니다. commands 및 finally 블록의 모든 명령이 성공적으로 실행되면 단계가 성공합니다. 어느 단계의 명령이 하나라도 실패하면 그 단계는 실패합니다.

선택적 시퀀스. 설치 중에 CodeBuild 실행되는 명령이 있는 경우 이를 나타냅니다. 빌드 환경에서 패키지를 설치하는 경우에만 install 단계를 사용하는 것이 좋습니다. 예를 들어 이 단계를 사용하여 Mocha 또는 와 같은 코드 테스트 프레임워크를 설치할 수 있습니다RSpec.

선택적 시퀀스. 빌드 전에 CodeBuild 실행되는 명령이 있는 경우 이를 나타냅니다. 예를 들어 이 단계를 사용하여 Amazon 에 로그인ECR하거나 npm 종속성을 설치할 수 있습니다.

선택적 시퀀스. 빌드 중에 CodeBuild 실행되는 명령이 있는 경우 이를 나타냅니다. 예를 들어 이 단계를 사용하여 Mocha, RSpec또는 sbt를 실행할 수 있습니다.

선택적 시퀀스. 빌드 후 CodeBuild 실행되는 명령이 있는 경우 이를 나타냅니다. 예를 들어 Maven을 사용하여 빌드 아티팩트를 JAR 또는 WAR 파일로 패키징하거나 Docker 이미지를 Amazon 에 푸시할 수 있습니다ECR. 그런 다음 Amazon 를 통해 빌드 알림을 보낼 수 있습니다SNS.

선택적 시퀀스. 보고서를 전송할 보고서 그룹을 지정합니다. 프로젝트에는 최대 5개의 보고서 그룹이 포함될 수 있습니다. ARN 기존 보고서 그룹의 를 지정하거나 새 보고서 그룹의 이름을 지정합니다. 이름을 지정하면 는 프로젝트 이름과 형식으로 지정한 이름을 사용하여 보고서 그룹을 CodeBuild 생성합니다<project-name>-<report-group-name>. 보고서 그룹 이름은 와 같은 빌드 사양의 환경 변수를 사용하여 설정할 수도 있습니다$REPORT_GROUP_NAME. 자세한 내용은 보고서 그룹 이름 지정 단원을 참조하십시오.

필수 시퀀스. 보고서에 의해 생성된 테스트 결과의 원시 데이터가 포함된 위치를 나타냅니다. 일련의 스칼라가 포함되어 있으며, 각 스칼라는 가 원래 빌드 위치 또는 설정된 경우 를 기준으로 테스트 파일을 찾을 CodeBuild 수 있는 별도의 위치를 나타냅니다base-directory. 위치에는 다음이 포함될 수 있습니다.

선택적 매핑. 보고서 파일 형식을 나타냅니다. 지정하지 않으면 JUNITXML가 사용됩니다. 이 값은 대소문자를 구분하지 않습니다. 가능한 값은 다음과 같습니다.

선택적 매핑. 가 원시 테스트 파일을 찾을 위치를 결정하는 데 CodeBuild 사용하는 원본 빌드 위치를 기준으로 하나 이상의 최상위 디렉터리를 나타냅니다.

선택 사항입니다. 보고서 파일 디렉터리가 출력에서 평면화되는지 여부를 지정합니다. 이 값이 지정되지 않거나 no를 포함하는 경우 보고서 파일은 디렉터리 구조가 손상되지 않은 상태로 출력됩니다. yes가 포함된 경우 모든 테스트 파일이 동일한 출력 디렉터리에 배치됩니다. 예를 들어, 테스트 결과에 대한 경로가 com/myapp/mytests/TestResult.xml인 경우 yes를 지정하면 이 파일이 /TestResult.xml에 배치됩니다.

필수 시퀀스. 빌드 환경의 빌드 출력 결과물을 포함하는 위치를 나타냅니다. 일련의 스칼라가 포함되어 있으며, 각 스칼라는 원래 빌드 위치 또는 설정된 경우 기본 디렉터리를 기준으로 빌드 출력 아티팩트를 찾을 수 있는 CodeBuild 별도의 위치를 나타냅니다. 위치에는 다음이 포함될 수 있습니다.

빌드 출력 아티팩트 위치를 지정할 때 는 빌드 환경에서 원래 빌드 위치를 CodeBuild 찾을 수 있습니다. 빌드 아티팩트 출력 위치 앞에 원래 빌드 위치 경로를 추가하거나 ./ 같은 것을 지정하지 않아도 됩니다. 이 위치에 대한 경로를 알고 싶으면 빌드 중에 echo $CODEBUILD_SRC_DIR과 같은 명령을 실행하면 됩니다. 각 빌드 환경의 위치는 약간씩 다를 수 있습니다.

선택적 이름. 빌드 아티팩트의 이름을 지정합니다. 이 이름은 다음 중 하나에 해당될 때 사용됩니다.

빌드할 때 계산되는 buildspec 파일에서 이름을 지정할 수 있습니다. buildspec 파일에 지정된 이름은 Shell 명령 언어를 사용합니다. 예를 들어 결과물 이름이 항상 고유하도록 날짜와 시간을 결과물 이름에 추가할 수 있습니다. 고유한 결과물 이름을 사용하면 결과물을 덮어쓰지 않을 수 있습니다. 자세한 정보는 Shell 명령 언어를 참조하십시오.

이름에 경로 정보를 추가하여 이름의 경로를 기준으로 명명된 아티팩트가 디렉터리에 배치되도록 할 수 있습니다. 이 예제에서는 빌드 아티팩트가 출력의 builds/<build number>/my-artifacts 아래에 배치됩니다.

version: 0.2
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: builds/$CODEBUILD_BUILD_NUMBER/my-artifacts

선택 사항입니다. 빌드 아티팩트 디렉터리가 출력에서 평면화되는지 여부를 지정합니다. 이 값이 지정되지 않거나 no를 포함하는 경우 빌드 아티팩트는 디렉터리 구조가 손상되지 않은 상태로 출력됩니다. yes가 포함된 경우 모든 빌드 아티팩트가 동일한 출력 디렉터리에 배치됩니다. 예를 들어, 빌드 출력 아티팩트의 파일 경로가 com/mycompany/app/HelloWorld.java인 경우 yes를 지정하면 이 파일이 /HelloWorld.java에 배치됩니다.

선택적 매핑. 가 빌드 출력 아티팩트에 포함할 파일 및 하위 디렉터리를 결정하는 데 CodeBuild 사용하는 원본 빌드 위치를 기준으로 하나 이상의 최상위 디렉터리를 나타냅니다. 유효한 값으로는 다음이 포함됩니다.

빌드 출력 결과물에는 이 최상위 디렉터리가 포함되지 않으며, 파일 및 하위 디렉터리만 포함됩니다.

포함할 파일 및 하위 디렉터리를 보다 더 제한하려면 files 및 discard-paths를 사용하면 됩니다. 예를 들어 다음 디렉터리구조에서

.
├── my-build-1
│   └── my-file-1.txt
└── my-build-2
    ├── my-file-2.txt
    └── my-subdirectory
        └── my-file-3.txt

다음 artifacts 시퀀스에 대해:

artifacts:
  files:
    - '*/my-file-3.txt'
  base-directory: my-build-2

다음 하위 디렉터리 및 파일이 빌드 출력 결과물에 포함됩니다.

.
└── my-subdirectory
    └── my-file-3.txt

다음 artifacts 시퀀스 동안

artifacts:
  files:
    - '**/*'
  base-directory: 'my-build*'
  discard-paths: yes

다음 파일이 빌드 출력 결과물에 포함됩니다.

.
├── my-file-1.txt
├── my-file-2.txt
└── my-file-3.txt

선택적 매핑. 빌드 아티팩트에서 제외base-directory CodeBuild 될 를 기준으로 하나 이상의 경로를 나타냅니다. 별표(*) 문자는 폴더의 경계를 넘지 않고 0개 이상의 이름 구성 요소 문자와 해당합니다. 이중 별표(**)는 모든 디렉터리에서 이름 구성 요소의 0개 이상 문자와 일치합니다.

exclude-paths의 예는 다음과 같습니다.

선택 사항입니다. 출력 유형이 인 경우 내부 심볼 링크가 ZIP 파일에 보존되는지 여부를 ZIP지정합니다. 가 포함된 경우 소스의 yes모든 내부 심볼 링크가 아티팩트 ZIP 파일에 보존됩니다.

선택 사항입니다. 아티팩트가 Amazon S3 버킷으로 출력되고 네임스페이스 유형이 BUILD_ID일 때 사용되는 접두사를 지정합니다. 사용될 경우 버킷의 출력 경로는 <s3-prefix>/<build-id>/<name>.zip입니다.

선택적 시퀀스. 1개 이상의 아티팩트 정의를 아티팩트 식별자와 아티팩트 정의를 연결하는 매핑으로 나타냅니다. 이 블록에서는 각 아티팩트가 프로젝트의 secondaryArtifacts 속성에서 정의하는 아티팩트와 일치해야 합니다. 각 정의는 위의 artifacts 블록과 동일한 구문을 갖습니다.

예를 들어 프로젝트가 다음과 같은 구조라고 가정할 경우,

{
  "name": "sample-project",
  "secondaryArtifacts": [
    {
      "type": "S3",
      "location": "<output-bucket1>",
      "artifactIdentifier": "artifact1",
      "name": "secondary-artifact-name-1"
    },
    {
      "type": "S3",
      "location": "<output-bucket2>",
      "artifactIdentifier": "artifact2",
      "name": "secondary-artifact-name-2"
    }
  ]
}

buildpec 파일은 다음과 비슷합니다.

version: 0.2

phases:
build:
  commands:
    - echo Building...
artifacts:
  files:
    - '**/*'
  secondary-artifacts:
    artifact1:
      files:
        - directory/file1
      name: secondary-artifact-name-1
    artifact2:
      files:
        - directory/file2
      name: secondary-artifact-name-2

필수 시퀀스. 캐시의 위치를 나타냅니다. 일련의 스칼라가 포함되어 있으며, 각 스칼라는 원래 빌드 위치 또는 설정된 경우 기본 디렉터리를 기준으로 빌드 출력 아티팩트를 찾을 CodeBuild 수 있는 별도의 위치를 나타냅니다. 위치에는 다음이 포함될 수 있습니다.