기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # AWS CodeBuild 빌드 및 테스트 작업 참조 파이프라인의 일부로 빌드와 테스트를 실행할 수 있습니다. CodeBuild 빌드 또는 테스트 작업을 실행할 때 buildspec에 지정된 명령이 CodeBuild 컨테이너 내에서 실행됩니다. 명령을 실행하는 컨테이너 내에서 CodeBuild 작업에 대해 입력 아티팩트로 지정된 모든 아티팩트를 사용할 수 있습니다. CodeBuild는 빌드 또는 테스트 작업을 제공할 수 있습니다. 자세한 내용은 [AWS CodeBuild 사용 설명서](https://docs.aws.amazon.com/codebuild/latest/userguide/)를 참조하십시오. 콘솔에서 CodePipeline 마법사를 사용하여 빌드 프로젝트를 생성할 때 CodeBuild 빌드 프로젝트는 소스 공급자가 CodePipeline임을 보여줍니다. CodeBuild 콘솔에서 빌드 프로젝트를 생성할 때 CodePipeline을 소스 공급자로 지정할 수 없지만, 파이프라인에 빌드 작업을 추가하면 CodeBuild 콘솔에서 소스가 조정됩니다. 자세한 내용은AWS CodeBuild API 참조의 [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html)를 참조하세요.** **Topics** + [작업 유형](#action-reference-CodeBuild-type) + [구성 파라미터](#action-reference-CodeBuild-config) + [입력 아티팩트](#action-reference-CodeBuild-input) + [출력 아티팩트](#action-reference-CodeBuild-output) + [출력 변수](#action-reference-CodeBuild-variables) + [서비스 역할 권한: CodeBuild 작업](#edit-role-codebuild) + [작업 선언(CodeBuild 예제)](#action-reference-CodeBuild-example) + [다음 사항도 참조하세요.](#action-reference-CodeBuild-links) ## 작업 유형 + 범주: `Build` 또는 `Test` + 소유자: `AWS` + 공급자: `CodeBuild` + 버전: `1` ## 구성 파라미터 **ProjectName** 필수 항목 여부: 예 `ProjectName`은 CodeBuild에서 빌드 프로젝트의 이름입니다. **PrimarySource** 필수 항목 여부: 조건부 `PrimarySource` 파라미터 값은 작업에 대한 입력 아티팩트 중 하나의 이름이어야 합니다. CodeBuild는 buildspec 파일을 찾아 이 아티팩트의 압축 해제된 버전이 포함된 디렉터리에서 buildspec 명령을 실행합니다. CodeBuild 작업에 대해 여러 입력 아티팩트가 지정되는 경우 이 파라미터는 필수 항목입니다. 작업에 대해 소스 아티팩트가 하나만 있는 경우 해당 아티팩트의 기본값은 `PrimarySource` 아티팩트입니다. **BatchEnabled** 필수 여부: 아니요 `BatchEnabled` 파라미터의 부울 값을 사용하면 작업이 동일한 빌드 실행에서 여러 빌드를 실행할 수 있습니다. 이 옵션을 활성화하면 `CombineArtifacts` 옵션을 사용할 수 있습니다. 배치 빌드가 활성화된 파이프라인 예제는 [CodePipeline과 CodeBuild 및 배치 빌드의 통합](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-pipeline-batch.html)을 참조하세요. **BuildspecOverride** 필수 여부: 아니요 이 빌드에 한해, 빌드 프로젝트에서 정의된 최신 빌드 프로젝트를 재정의하는 인라인 buildspec 정의 또는 buildspec 파일 선언입니다. 프로젝트에 정의된 buildspec은 변경되지 않습니다. 이 값이 설정된 경우, 다음 중 하나일 수 있습니다. + 인라인 buildspec 정의입니다. 자세한 내용은 [Buildspec 구문](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec-ref-syntax)의 구문 참조를 참조하세요. + 내장 `CODEBUILD_SRC_DIR` 환경 변수의 값을 기준으로 한 대체 buildspec 파일의 경로 또는 S3 버킷의 경로입니다. 버킷은 빌드 프로젝트와 동일한 AWS 리전 에 있어야 합니다. ARN을 사용하여 buildspec 파일을 지정합니다(예: `arn:aws:s3:::my-codebuild-sample2/buildspec.yml`). 이 값을 제공하지 않거나 빈 문자열로 설정하는 경우 소스 코드에 루트 디렉터리의 buildspec 파일이 포함되어 있어야 합니다. 경로 추가에 대한 자세한 내용은 [Buildspec 파일 이름 및 스토리지 위치](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec-ref-name-storage)를 참조하세요. 이 속성을 사용하면 컨테이너에서 실행할 빌드 명령을 변경할 수 있으므로이 API를 호출하고 이 파라미터를 설정하는 기능이 있는 IAM 보안 주체가 기본 설정을 재정의할 수 있습니다. 또한 소스 리포지토리의 파일 또는 Amazon S3 버킷과 같은 신뢰할 수 있는 buildspec 위치를 사용하는 것이 좋습니다. **CombineArtifacts** 필수 여부: 아니요 `CombineArtifacts` 파라미터의 부울 값은 배치 빌드의 모든 빌드 아티팩트를 빌드 작업을 위한 단일 아티팩트 파일로 결합합니다. 이 옵션을 사용하려면 `BatchEnabled` 파라미터를 활성화해야 합니다. **EnvironmentVariables** 필수 여부: 아니요 이 파라미터의 값은 파이프라인의 CodeBuild 작업에 대한 환경 변수를 설정하는 데 사용됩니다. `EnvironmentVariables` 파라미터 값은 환경 변수 객체의 JSON 배열 형식을 취합니다. [작업 선언(CodeBuild 예제)](#action-reference-CodeBuild-example)의 예제 파라미터를 참조하십시오. 각 객체에는 세 부분이 있으며 모두 문자열입니다. + `name`: 환경 변수의 이름 또는 키입니다. + `value`: 환경 변수의 값입니다. `PARAMETER_STORE` 또는 `SECRETS_MANAGER` 유형을 사용하는 경우이 값은 AWS Systems Manager Parameter Store에 이미 저장한 파라미터의 이름이거나 Secrets Manager에 AWS 이미 저장한 보안 암호여야 합니다. **참고** 환경 변수를 사용하여 민감한 값, 특히 AWS 자격 증명을 저장하지 않는 것이 좋습니다. CodeBuild 콘솔 또는 AWS CLI를 사용하면 환경 변수가 일반 텍스트로 표시됩니다. 중요한 값의 경우 대신 `SECRETS_MANAGER` 유형을 사용하는 것이 좋습니다. + `type`: (선택 사항) 환경 변수의 유형입니다. 유효한 값은 `PARAMETER_STORE`, `SECRETS_MANAGER`또는 `PLAINTEXT`입니다. 지정하지 않으면 기본적으로 `PLAINTEXT`가 사용됩니다. 환경 변수 구성에 대해 `name`, `value` 및 `type`을 입력할 때, 특히 환경 변수에 CodePipeline 출력 변수 구문이 포함된 경우 구성 값 필드에 1000자 제한을 초과하지 마십시오. 이 제한을 초과하면 확인 오류가 반환됩니다. 자세한 내용은 AWS CodeBuild API 참조의 [ EnvironmentVariable](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_EnvironmentVariable.html)을 참조하세요. GitHub 브랜치 이름으로 확인되는 환경 변수를 포함하는 CodeBuild 작업의 예는 [예: CodeBuild 환경 변수와 함께 BranchName 변수 사용](actions-variables.md#actions-variables-examples-env-branchname) 섹션을 참조하세요. ## 입력 아티팩트 + **아티팩트 수:** `1 to 5` + **설명:** CodeBuild는 기본 소스 아티팩트의 디렉터리에서 buildspec 파일을 찾고 buildspec 명령을 실행합니다. 단일 입력 소스가 지정되거나 CodeBuild 작업에 대해 둘 이상의 입력 소스가 지정된 경우 단일 아티팩트 또는 여러 입력 소스의 경우 기본 아티팩트를 CodePipeline의 `PrimarySource` 작업 구성 파라미터를 사용하여 설정해야 합니다. 각 입력 아티팩트가 자체 디렉터리로 추출되며 이 위치가 환경 변수에 저장됩니다. 기본 소스 아티팩트의 디렉터리는 `$CODEBUILD_SRC_DIR`에서 사용할 수 있습니다. 다른 모든 입력 아티팩트의 디렉터리는 `$CODEBUILD_SRC_DIR_yourInputArtifactName`에서 사용할 수 있습니다. **참고** CodeBuild 프로젝트에서 구성된 아티팩트가 파이프라인에서는 CodeBuild 작업에 의해 사용되는 입력 아티팩트가 됩니다. ## 출력 아티팩트 + **아티팩트 수:** `0 to 5` + **설명:** 파이프라인의 후속 작업에 사용할 수 있는 CodeBuild buildspec 파일에 정의된 아티팩트를 만드는 데 사용할 수 있습니다. 출력 아티팩트가 하나만 정의되는 경우 buildspec 파일의 `artifacts` 섹션에서 직접 이 아티팩트를 정의할 수 있습니다. 둘 이상의 출력 아티팩트가 지정된 경우 참조되는 모든 아티팩트는 buildspec 파일에서 보조 아티팩트로 정의되어야 합니다. CodePipeline의 출력 아티팩트의 이름은 buildspec 파일의 객체 식별자와 일치해야 합니다. **참고** CodeBuild 프로젝트에서 구성된 아티팩트가 파이프라인 작업에서는 CodePipeline 입력 아티팩트가 됩니다. `CombineArtifacts` 파라미터를 배치 빌드용으로 선택한 경우 출력 아티팩트 위치에는 동일한 실행에서 실행된 여러 빌드의 결합된 아티팩트가 포함됩니다. ## 출력 변수 이 작업은 빌드의 일부로 내보낸 모든 환경 변수를 변수로 생성합니다. 환경 변수를 내보내는 방법에 대한 자세한 내용은AWS CodeBuild API 가이드의 [ EnvironmentVariable](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_EnvironmentVariable.html)을 참조하세요.** CodePipeline에서 CodeBuild 환경 변수를 사용하는 방법에 대한 자세한 내용은 [CodeBuild 작업 출력 변수](reference-variables.md#reference-variables-list-configured-codebuild)의 예제를 참조하세요. CodeBuild에서 사용할 수 있는 환경 변수 목록은AWS CodeBuild 사용 설명서의 [빌드 환경의 환경 변수](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html)를 참조하세요.** ## 서비스 역할 권한: CodeBuild 작업 CodeBuild 지원의 경우 다음을 정책 설명에 추가합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "codebuild:BatchGetBuilds", "codebuild:StartBuild", "codebuild:BatchGetBuildBatches", "codebuild:StartBuildBatch" ], "Resource": [ "arn:aws:codebuild:*:111122223333:project/[[ProjectName]]" ], "Effect": "Allow" } ] } ``` ------ ## 작업 선언(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 사용 설명서](https://docs.aws.amazon.com/codebuild/latest/userguide/) - CodeBuild 작업이 포함된 예제 파이프라인은 [ CodePipeline을 CodeBuild와 함께 사용하여 코드 테스트 및 빌드 실행을 참조하세요](https://docs.aws.amazon.com/codebuild/latest/userguide/how-to-create-pipeline.html). 입력 및 출력 CodeBuild 아티팩트가 여러 개인 프로젝트의 예제는 [CodePipeline과 CodeBuild의 통합 및 다중 입력 소스 및 출력 아티팩트 샘플](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-pipeline-multi-input-output.html)과 [다중 입력 소스 및 출력 아티팩트 샘플](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-multi-in-out.html)을 참조하세요. + [자습서:를 사용하여 Android 앱을 빌드하고 테스트하는 파이프라인 생성 AWS Device Farm](tutorials-codebuild-devicefarm.md) - 이 자습서는 CodeBuild 및 AWS Device Farm을 사용하여 Android 앱을 빌드 및 테스트하는 GitHub 소스가 있는 파이프라인을 생성하기 위한 샘플 buildspec 파일과 샘플 애플리케이션을 제공합니다. + [CodeBuild에 대한 빌드 사양 참조](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) - 이 참조 항목에서는 CodeBuild buildspec 파일을 이해하기 위한 정의와 예제를 제공합니다. CodeBuild에서 사용할 수 있는 환경 변수 목록은AWS CodeBuild 사용 설명서의 [빌드 환경의 환경 변수](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html)를 참조하세요.**