AWS CodeBuild

파이프라인의 일부로 빌드와 테스트를 실행할 수 있습니다. CodeBuild 빌드 또는 테스트 작업을 실행할 때 빌드 사양에 지정된 명령이 CodeBuild 컨테이너 내에서 실행됩니다. 명령을 실행하는 컨테이너 내에서 CodeBuild 작업에 대해 입력 아티팩트로 지정된 모든 아티팩트를 사용할 수 있습니다. CodeBuild는 빌드 또는 테스트 작업을 제공할 수 있습니다. 자세한 정보는 AWS CodeBuild 사용 설명서를 참조하세요.

콘솔에서 CodePipeline 마법사를 사용하여 빌드 프로젝트를 생성할 때 CodeBuild 빌드 프로젝트는 소스 공급자가 CodePipeline임을 보여줍니다. CodeBuild 콘솔에서 빌드 프로젝트를 생성할 때 CodePipeline을 소스 공급자로 지정할 수 없지만, 파이프라인에 빌드 작업을 추가하면 CodeBuild 콘솔에서 소스가 조정됩니다. 자세한 내용은 AWS CodeBuild API 참조의 ProjectSource를 참조하세요.

작업 유형

• 범주: Build 또는 Test

• 소유자: AWS

• 공급자: CodeBuild

• 버전: 1

구성 파라미터

ProjectName

필수 항목 여부: 예

ProjectName은 CodeBuild에서 빌드 프로젝트의 이름입니다.

PrimarySource

필수 항목 여부: 조건부

PrimarySource 파라미터 값은 작업에 대한 입력 아티팩트 중 하나의 이름이어야 합니다. CodeBuild는 빌드 사양 파일을 찾아 이 아티팩트의 압축 해제된 버전이 포함된 디렉터리에서 빌드 사양 명령을 실행합니다.

CodeBuild 작업에 대해 여러 입력 아티팩트가 지정되는 경우 이 파라미터는 필수 항목입니다. 작업에 대해 소스 아티팩트가 하나만 있는 경우 해당 아티팩트의 기본값은 PrimarySource 아티팩트입니다.

BatchEnabled

필수 항목 여부: 아니요

BatchEnabled 파라미터의 부울 값을 사용하면 작업이 동일한 빌드 실행에서 여러 빌드를 실행할 수 있습니다.

이 옵션을 활성화하면 CombineArtifacts 옵션을 사용할 수 있습니다.

배치 빌드가 활성화된 파이프라인 예제는 CodePipeline과 CodeBuild 및 배치 빌드의 통합을 참조하세요.

CombineArtifacts

필수 항목 여부: 아니요

CombineArtifacts 파라미터의 부울 값은 배치 빌드의 모든 빌드 아티팩트를 빌드 작업을 위한 단일 아티팩트 파일로 결합합니다.

이 옵션을 사용하려면 BatchEnabled 파라미터를 활성화해야 합니다.

EnvironmentVariables

필수 항목 여부: 아니요

이 파라미터의 값은 파이프라인의 CodeBuild 작업에 대한 환경 변수를 설정하는 데 사용됩니다. EnvironmentVariables 파라미터 값은 환경 변수 객체의 JSON 배열 형식을 취합니다. 작업 선언(CodeBuild 예제)의 예제 파라미터를 참조하십시오.

각 객체에는 세 부분이 있으며 모두 문자열입니다.

• name: 환경 변수의 이름 또는 키입니다.

• value: 환경 변수의 값입니다. PARAMETER_STORE 또는 SECRETS_MANAGER 유형을 사용할 경우 이 값은 각각 이미 AWS Systems Manager Parameter Store에 저장한 파라미터 이름이거나 이미 AWS Secrets Manager에 저장한 암호여야 합니다.

  참고

  환경 변수를 사용하여 중요한 값(특히 AWS 자격 증명)을 저장하는 것은 가급적 피해야 합니다. CodeBuild 콘솔 또는 AWS CLI를 사용하면 환경 변수가 일반 텍스트로 표시됩니다. 중요한 값의 경우 대신 SECRETS_MANAGER 유형을 사용하는 것이 좋습니다.

• type: (선택 사항) 환경 변수의 유형입니다. 유효한 값은 PARAMETER_STORE, SECRETS_MANAGER 또는 PLAINTEXT입니다. 지정하지 않으면 기본적으로 PLAINTEXT가 사용됩니다.

참고

환경 변수 구성에 대해 name, value 및 type을 입력할 때, 특히 환경 변수에 CodePipeline 출력 변수 구문이 포함된 경우 구성 값 필드에 1000자 제한을 초과하지 마십시오. 이 제한을 초과하면 확인 오류가 반환됩니다.

자세한 내용을 알아보려면 AWS CodeBuild API 참조의 EnvironmentVariable을 참조하세요. GitHub 브랜치 이름으로 확인되는 환경 변수를 포함하는 CodeBuild 작업의 예는 예: CodeBuild 환경 변수와 함께 BranchName 변수 사용 섹션을 참조하세요.

입력 아티팩트

• 아티팩트 수: 1 to 5

• 설명: CodeBuild는 기본 소스 아티팩트의 디렉터리에서 빌드 사양 파일을 찾고 빌드 사양 명령을 실행합니다. CodeBuild 작업에 대해 둘 이상의 입력 소스가 지정된 경우 CodePipeline에서 PrimarySource 작업 구성 파라미터를 사용하여 이 아티팩트를 설정해야 합니다.

  각 입력 아티팩트가 자체 디렉터리로 추출되며 이 위치가 환경 변수에 저장됩니다. 기본 소스 아티팩트의 디렉터리는 $CODEBUILD_SRC_DIR에서 사용할 수 있습니다. 다른 모든 입력 아티팩트의 디렉터리는 $CODEBUILD_SRC_DIR_yourInputArtifactName에서 사용할 수 있습니다.

  참고

  CodeBuild 프로젝트에서 구성된 아티팩트가 파이프라인에서는 CodeBuild 작업에 의해 사용되는 입력 아티팩트가 됩니다.

출력 아티팩트

• 아티팩트 수: 0 to 5

• 설명: 파이프라인의 후속 작업에 사용할 수 있는 CodeBuild 빌드 사양 파일에 정의된 아티팩트를 만드는 데 사용할 수 있습니다. 출력 아티팩트가 하나만 정의되는 경우 빌드 사양 파일의 artifacts 섹션에서 직접 이 아티팩트를 정의할 수 있습니다. 둘 이상의 출력 아티팩트가 지정된 경우 참조되는 모든 아티팩트는 빌드 사양 파일에서 보조 아티팩트로 정의되어야 합니다. CodePipeline의 출력 아티팩트의 이름은 빌드 사양 파일의 객체 식별자와 일치해야 합니다.

  참고

  CodeBuild 프로젝트에서 구성된 아티팩트가 파이프라인 작업에서는 CodePipeline 입력 아티팩트가 됩니다.

  CombineArtifacts 파라미터를 배치 빌드용으로 선택한 경우 출력 아티팩트 위치에는 동일한 실행에서 실행된 여러 빌드의 결합된 아티팩트가 포함됩니다.

출력 변수

이 작업은 빌드의 일부로 내보낸 모든 환경 변수를 변수로 생성합니다. 환경 변수를 내보내는 방법에 대한 자세한 내용은 AWS CodeBuild API 가이드의 EnvironmentVariable을 참조하세요.

CodePipeline에서 CodeBuild 환경 변수를 사용하는 방법에 대한 자세한 내용은 CodeBuild 작업 출력 변수의 예제를 참조하세요. CodeBuild에서 사용할 수 있는 환경 변수 목록은 AWS CodeBuild 사용 설명서의 빌드 환경의 환경 변수를 참조하세요.

작업 선언(CodeBuild 예제)

YAML

Name: Build
Actions:
  - Name: PackageExport
    ActionTypeId:
      Category: Build
      Owner: AWS
      Provider: CodeBuild
      Version: '1'
    RunOrder: 1
    Configuration:
      BatchEnabled: 'true'
      CombineArtifacts: 'true'
      ProjectName: my-build-project
      PrimarySource: MyApplicationSource1
      EnvironmentVariables: '[{"name":"TEST_VARIABLE","value":"TEST_VALUE","type":"PLAINTEXT"},{"name":"ParamStoreTest","value":"PARAMETER_NAME","type":"PARAMETER_STORE"}]'
    OutputArtifacts:
      - Name: MyPipeline-BuildArtifact
    InputArtifacts:
      - Name: MyApplicationSource1
      - Name: MyApplicationSource2
      

JSON

{
    "Name": "Build",
    "Actions": [
        {
            "Name": "PackageExport",
            "ActionTypeId": {
                "Category": "Build",
                "Owner": "AWS",
                "Provider": "CodeBuild",
                "Version": "1"
            },
            "RunOrder": 1,
            "Configuration": {
                "BatchEnabled": "true",
                "CombineArtifacts": "true",
                "ProjectName": "my-build-project",
                "PrimarySource": "MyApplicationSource1",
                "EnvironmentVariables": "[{\"name\":\"TEST_VARIABLE\",\"value\":\"TEST_VALUE\",\"type\":\"PLAINTEXT\"},{\"name\":\"ParamStoreTest\",\"value\":\"PARAMETER_NAME\",\"type\":\"PARAMETER_STORE\"}]"
            },
            "OutputArtifacts": [
                {
                    "Name": "MyPipeline-BuildArtifact"
                }
            ],
            "InputArtifacts": [
                {
                    "Name": "MyApplicationSource1"
                },
                {
                    "Name": "MyApplicationSource2"
                }
            ]
        }
    ]
}

다음 사항도 참조하세요.

이 작업을 수행할 때 참조할 수 있는 관련 리소스는 다음과 같습니다.

• AWS CodeBuild 사용 설명서 - CodeBuild 작업이 있는 예제 파이프라인은 CodePipeline과 CodeBuild를 함께 사용하여 코드 테스트 및 빌드 실행을 참조하세요. 입력 및 출력 CodeBuild 아티팩트가 여러 개인 프로젝트의 예제는 CodePipeline과 CodeBuild의 통합 및 다중 입력 소스 및 출력 아티팩트 샘플과 다중 입력 소스 및 출력 아티팩트 샘플을 참조하세요.

• 튜토리얼: 다음을 사용하여 Android 앱을 빌드하고 테스트하는 파이프라인 만들기 AWS Device Farm - 이 자습서는 CodeBuild 및 AWS Device Farm을 사용하여 Android 앱을 빌드 및 테스트하는 GitHub 소스가 있는 파이프라인을 생성하기 위한 샘플 빌드 사양 파일과 샘플 애플리케이션을 제공합니다.

• CodeBuild에 대한 빌드 사양 참조 - 이 참조 항목에서는 CodeBuild 빌드 사양 파일을 이해하기 위한 정의와 예제를 제공합니다. CodeBuild에서 사용할 수 있는 환경 변수 목록은 AWS CodeBuild 사용 설명서의 빌드 환경의 환경 변수를 참조하세요.