기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 빌드 환경의 환경 변수 AWS CodeBuild 는 빌드 명령에 사용할 수 있는 여러 환경 변수를 제공합니다. AWS\$1DEFAULT\$1REGION 빌드가 실행 중인 AWS 리전(예: `us-east-1`). 이 환경 변수는 AWS CLI에 의해 주로 사용됩니다. AWS\$1REGION 빌드가 실행 중인 AWS 리전(예: `us-east-1`). 이 환경 변수는 주로 AWS SDKs에서 사용됩니다. 코드빌드\$1배치\$1빌드\$1식별자 배치 빌드의 빌드 식별자입니다. 이는 배치 buildspec에 지정되어 있습니다. 자세한 내용은 [배치 빌드 buildspec 참조](batch-build-buildspec.md) 단원을 참조하십시오. CODEBUILD\$1BUILD\$1ARN 빌드의 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`). CODEBUILD\$1BUILD\$1ID 빌드의 CodeBuild ID입니다(예: `codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`). CODEBUILD\$1BUILD\$1IMAGE CodeBuild 빌드 이미지 식별자입니다(예: `aws/codebuild/standard:2.0`). CODEBUILD\$1BUILD\$1NUMBER 프로젝트의 현재 빌드 번호입니다. CODEBUILD\$1BUILD\$1SUCCEEDING 현재 빌드가 성공적으로 진행되는지 여부입니다. 빌드가 실패하는 경우 `0`으로 설정하고, 성공하는 경우 `1`로 설정합니다. CODEBUILD\$1INITIATOR 빌드를 시작한 엔터티입니다. CodePipeline이 빌드를 시작한 경우 파이프라인의 이름입니다(예: `codepipeline/my-demo-pipeline`). 사용자가 빌드를 시작했으면 사용자의 이름입니다(예: `MyUserName`). CodeBuild용 Jenkins 플러그인이 빌드를 시작했으면 문자열 `CodeBuild-Jenkins-Plugin`입니다. CODEBUILD\$1KMS\$1KEY\$1ID CodeBuild가 빌드 출력 아티팩트를 암호화하는 데 사용하는 AWS KMS 키의 식별자입니다(예: `arn:aws:kms:region-ID:account-ID:key/key-ID` 또는 `alias/key-alias`). CODEBUILD\$1PROJECT\$1ARN 프로젝트의 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:codebuild:region-ID:account-ID:project/project-name`). CODEBUILD\$1PUBLIC\$1BUILD\$1URL 퍼블릭 빌드 웹사이트에 있는 이 빌드의 빌드 결과 URL입니다. 이 변수는 빌드 프로젝트에 퍼블릭 빌드가 활성화된 경우에만 설정됩니다. 자세한 내용은 [퍼블릭 빌드 프로젝트 URL 가져오기](public-builds.md) 단원을 참조하십시오. CODEBUILD\$1RESOLVED\$1SOURCE\$1VERSION 빌드 소스 코드의 버전 식별자입니다. 내용은 다음 소스 코드 리포지토리에 따라 달라집니다. CodeCommit, GitHub, GitHub Enterprise Server 및 Bitbucket 이 변수에는 커밋 ID가 포함됩니다. CodePipeline 이 변수에는 CodePipeline에서 제공하는 소스 수정 버전이 포함되어 있습니다. CodePipeline이 소스 수정 사항을 확인할 수 없는 경우(예: 소스가 버전 관리가 활성화되지 않은 Amazon S3 버킷인 경우), 이 환경 변수는 설정되지 않습니다. Amazon S3 이 변수는 설정되지 않습니다. 해당하는 경우 `CODEBUILD_RESOLVED_SOURCE_VERSION` 변수는 `DOWNLOAD_SOURCE` 단계 이후에만 사용할 수 있습니다. CODEBUILD\$1SOURCE\$1REPO\$1URL 입력 아티팩트 또는 소스 코드 리포지토리에 대한 URL입니다. Amazon S3의 경우 `s3://` 뒤에 버킷 이름과 입력 아티팩트에 대한 경로가 옵니다. CodeCommit과 GitHub의 경우 리포지토리의 복제 URL입니다. CodePipeline에서 빌드를 시작한 경우 이 환경 변수는 비어 있을 수 있습니다. 보조 소스의 경우 보조 소스 리포지토리 URL의 환경 변수는 `CODEBUILD_SOURCE_REPO_URL_`입니다. 여기서 ``는 사용자가 생성한 소스 식별자입니다. CODEBUILD\$1SOURCE\$1VERSION 값의 형식은 소스 코드 리포지토리에 따라 다릅니다. + Amazon S3의 경우 입력 아티팩트에 연결된 버전 ID입니다. + CodeCommit의 경우, 커밋 ID 또는 빌드할 소스 코드 버전과 연관된 분기 이름입니다. + GitHub, GitHub Enterprise Server, Bitbucket의 경우, 커밋 ID, 분기 이름 또는 빌드할 소스 코드 버전과 연관된 태그 이름입니다. **참고** Webhook pull 요청 이벤트에서 트리거하는 GitHub 또는 GitHub Enterprise Server 빌드의 경우 `pr/pull-request-number`입니다. 보조 소스의 경우 보조 소스 버전의 환경 변수는 `CODEBUILD_SOURCE_VERSION_`입니다. 여기서 ``는 사용자가 생성한 소스 식별자입니다. 자세한 내용은 [다중 입력 소스 및 출력 아티팩트 샘플](sample-multi-in-out.md) 단원을 참조하십시오. CODEBUILD\$1SRC\$1DIR CodeBuild가 빌드에 사용하는 디렉터리 경로입니다(예: `/tmp/src123456789/src`). 보조 소스를 사용하는 경우 보조 소스 디렉터리 경로의 환경 변수는 `CODEBUILD_SRC_DIR_`입니다. 여기서 ``는 사용자가 생성한 소스 식별자입니다. 자세한 내용은 [다중 입력 소스 및 출력 아티팩트 샘플](sample-multi-in-out.md) 단원을 참조하십시오. CODEBUILD\$1START\$1TIME 밀리초 단위의 Unix 타임스탬프로 지정된 빌드의 시작 시간입니다. CODEBUILD\$1WEBHOOK\$1ACTOR\$1ACCOUNT\$1ID Webhook 이벤트를 트리거한 사용자의 계정 ID입니다. CODEBUILD\$1WEBHOOK\$1BASE\$1REF 현재 빌드를 트리거하는 Webhook 이벤트의 기본 참조 이름입니다. pull 요청의 경우 이를 브랜치 참조라고 합니다. CODEBUILD\$1WEBHOOK\$1EVENT 현재 빌드를 트리거하는 Webhook 이벤트입니다. CODEBUILD\$1WEBHOOK\$1MERGE\$1COMMIT 빌드에 사용된 병합 커밋의 식별자입니다. 이 변수는 Bitbucket 풀 요청이 스쿼시 전략과 병합되고 pull 요청 분기가 닫힐 때 설정됩니다. 이 경우 원래의 풀 요청 커밋은 더 이상 존재하지 않으므로 이 환경 변수에는 스쿼시된 병합 커밋의 식별자가 포함됩니다. CODEBUILD\$1WEBHOOK\$1PREV\$1COMMIT 현재 빌드를 트리거하는 webhook 푸시 이벤트 전 최신 커밋의 ID입니다. CODEBUILD\$1WEBHOOK\$1HEAD\$1REF 현재 빌드를 트리거하는 Webhook 이벤트의 헤드 참조 이름입니다. 브랜치 참조 또는 태그 참조일 수 있습니다. CODEBUILD\$1WEBHOOK\$1TRIGGER 빌드를 트리거하는 Webhook 이벤트를 표시합니다. 이 변수는 Webhook가 트리거하는 빌드에만 사용할 수 있습니다. 이 값은 GitHub, GitHub Enterprise Server 또는 Bitbucket이 CodeBuild로 전송하는 페이로드에서 구문 분석됩니다. 값의 형식은 빌드를 트리거한 이벤트 유형에 따라 다릅니다. + pull 요청이 트리거한 빌드의 경우 `pr/pull-request-number`입니다. + 새 브랜치를 생성하거나 브랜치로 커밋을 푸시하여 트리거된 빌드의 경우 `branch/branch-name`입니다. + 리포지토리로 태그를 푸시하여 트리거된 빌드의 경우 `tag/tag-name`입니다. HOME 이 환경 변수는 항상 `/root`로 설정되어 있습니다. AWS CodeBuild 는 자체 호스팅 러너 빌드에 대한 환경 변수 집합도 지원합니다. CodeBuild 자체 호스팅 실행기에 대한 자세한 내용은 [자습서: CodeBuild 호스팅 GitHub Action 실행기 구성](action-runner.md) 섹션을 참조하세요. CODEBUILD\$1RUNNER\$1OWNER 자체 호스팅 실행기 빌드를 트리거하는 리포지토리의 소유자입니다. CODEBUILD\$1RUNNER\$1REPO 자체 호스팅 실행기 빌드를 트리거하는 리포지토리의 이름입니다. CODEBUILD\$1RUNNER\$1REPO\$1DOMAIN 자체 호스팅 실행기 빌드를 트리거하는 리포지토리의 도메인입니다. 지정된 GitHub Enterprise 빌드만 해당됩니다. CODEBUILD\$1WEBHOOK\$1LABEL 빌드 재정의를 구성하는 데 사용되는 레이블과 빌드 중에 자체 호스팅된 실행기입니다. CODEBUILD\$1WEBHOOK\$1RUN\$1ID 빌드와 연결된 워크플로의 실행 ID입니다. CODEBUILD\$1WEBHOOK\$1JOB\$1ID 빌드와 연결된 작업의 작업 ID입니다. CODEBUILD\$1WEBHOOK\$1WORKFLOW\$1NAME 웹후크 요청 페이로드에 빌드가 있는 경우 빌드와 연결된 워크플로의 이름입니다. CODEBUILD\$1RUNNER\$1WITH\$1BUILDSPEC 자체 호스팅 실행기 요청 레이블에 buildspec 재정의가 구성된 경우 이 재정의는 `true`로 설정됩니다. 자체 환경 변수를 사용하여 빌드 환경을 제공할 수도 있습니다. 자세한 내용은 다음 항목을 참조하세요. + [CodePipeline에서 CodeBuild 사용](how-to-create-pipeline.md) + [빌드 프로젝트 생성](create-project.md) + [빌드 프로젝트 설정 변경](change-project.md) + [빌드를 수동으로 실행](run-build.md) + [buildspec 참조](build-spec-ref.md) 빌드 환경에서 사용 가능한 모든 환경 변수를 나열하려면 빌드 중에 `printenv` (Linux 기반 빌드 환경의 경우) 또는 `"Get-ChildItem Env:"` (Windows 기반 빌드 환경의 경우) 명령을 실행하면 됩니다. 앞에서 나열한 환경 변수를 제외하고, `CODEBUILD_`로 시작하는 환경 변수는 CodeBuild에서 내부적으로 사용합니다. 이러한 환경 변수는 빌드 명령에서 사용하면 안 됩니다. **중요** 환경 변수를 사용하여 민감한 값, 특히 AWS 액세스 키 IDs를 저장하지 않는 것이 좋습니다. 환경 변수는 CodeBuild 콘솔 및 AWS CLI와 같은 도구를 사용하여 일반 텍스트로 표시할 수 있습니다. 중요한 값을 Amazon EC2 Systems Manager Parameter Store에 저장한 후에 buildspec에서 검색하는 것이 좋습니다. 중요한 값을 저장하려면 Amazon EC2 Systems Manager 사용 설명서의 [Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html) 및 [안내: 문자열 파라미터 생성 및 테스트(콘솔)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-console.html)를 참조하세요.** 검색하려면 [buildspec 구문](build-spec-ref.md#build-spec-ref-syntax)의 `parameter-store` 매핑을 참조하십시오. CODEBUILD\$1BUILD\$1URL 이 빌드에 대한 빌드 결과의 URL입니다.