빌드 환경의 환경 변수 - AWS CodeBuild

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

빌드 환경의 환경 변수

AWS CodeBuild는 빌드 명령에서 사용할 수 있는 다양한 환경 변수를 제공합니다.

AWS_DEFAULT_REGION

빌드가 실행되고 있는 AWS 리전입니다(예: us-east-1). 이 환경 변수는 AWS CLI에 의해 주로 사용됩니다.

AWS_REGION

빌드가 실행되고 있는 AWS 리전입니다(예: us-east-1). 이 환경 변수는 AWS SDK에 의해 주로 사용됩니다.

코드빌드_배치_빌드_식별자

배치 빌드의 빌드 식별자입니다. 이는 배치 buildspec에 지정되어 있습니다. 자세한 내용은 배치 빌드 buildspec 참조 섹션을 참조하세요.

CODEBUILD_BUILD_ARN

빌드의 Amazon 리소스 이름(ARN)입니다(예: arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE).

CODEBUILD_BUILD_ID

빌드의 CodeBuild ID입니다(예: codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE).

CODEBUILD_BUILD_IMAGE

CodeBuild 빌드 이미지 식별자입니다(예: aws/codebuild/standard:2.0).

CODEBUILD_BUILD_NUMBER

프로젝트의 현재 빌드 번호입니다.

CODEBUILD_BUILD_SUCCEEDING

현재 빌드가 성공적으로 진행되는지 여부입니다. 빌드가 실패하는 경우 0으로 설정하고, 성공하는 경우 1로 설정합니다.

CODEBUILD_INITIATOR

빌드를 시작한 엔터티입니다. CodePipeline이 빌드를 시작한 경우 파이프라인의 이름입니다(예: codepipeline/my-demo-pipeline). 사용자가 빌드를 시작했으면 사용자의 이름입니다(예: MyUserName). CodeBuild용 Jenkins 플러그인이 빌드를 시작했으면 문자열 CodeBuild-Jenkins-Plugin입니다.

CODEBUILD_KMS_KEY_ID

CodeBuild가 빌드 출력 아티팩트를 암호화하는 데 사용하고 있는 arn:aws:kms:region-ID:account-ID:key/key-ID 키 식별자입니다(예: AWS KMS 또는 alias/key-alias).

CODEBUILD_LOG_PATH

해당 빌드에 대한 CloudWatch Logs의 로그 스트림 이름입니다.

CODEBUILD_PUBLIC_BUILD_URL

퍼블릭 빌드 웹사이트에 있는 이 빌드의 빌드 결과 URL입니다. 이 변수는 빌드 프로젝트에 퍼블릭 빌드가 활성화된 경우에만 설정됩니다. 자세한 내용은 AWS CodeBuild의 퍼블릭 빌드 프로젝트 섹션을 참조하세요.

CODEBUILD_RESOLVED_SOURCE_VERSION

빌드 소스 코드의 버전 식별자입니다. 내용은 다음 소스 코드 리포지토리에 따라 달라집니다.

CodeCommit, GitHub, GitHub Enterprise Server 및 Bitbucket

이 변수에는 커밋 ID가 포함됩니다.

CodePipeline

이 변수에는 CodePipeline에서 제공하는 소스 수정 버전이 포함되어 있습니다.

CodePipeline이 소스 수정 사항을 확인할 수 없는 경우(예: 소스가 버전 관리가 활성화되지 않은 Amazon S3 버킷인 경우), 이 환경 변수는 설정되지 않습니다.

Amazon S3

이 변수는 설정되지 않습니다.

해당하는 경우 CODEBUILD_RESOLVED_SOURCE_VERSION 변수는 DOWNLOAD_SOURCE 단계 이후에만 사용할 수 있습니다.

CODEBUILD_SOURCE_REPO_URL

입력 아티팩트 또는 소스 코드 리포지토리에 대한 URL입니다. Amazon S3의 경우 s3:// 뒤에 버킷 이름과 입력 아티팩트에 대한 경로가 옵니다. CodeCommit과 GitHub의 경우 리포지토리의 복제 URL입니다. CodePipeline에서 빌드를 시작한 경우 이 환경 변수는 비어 있을 수 있습니다.

보조 소스의 경우 보조 소스 리포지토리 URL의 환경 변수는 CODEBUILD_SOURCE_REPO_URL_<sourceIdentifier>입니다. 여기서 <sourceIdentifier>는 사용자가 생성한 소스 식별자입니다.

CODEBUILD_SOURCE_VERSION

값의 형식은 소스 코드 리포지토리에 따라 다릅니다.

  • Amazon S3의 경우 입력 아티팩트에 연결된 버전 ID입니다.

  • CodeCommit의 경우, 커밋 ID 또는 빌드할 소스 코드 버전과 연관된 분기 이름입니다.

  • GitHub, GitHub Enterprise Server, Bitbucket의 경우, 커밋 ID, 분기 이름 또는 빌드할 소스 코드 버전과 연관된 태그 이름입니다.

    참고

    Webhook pull 요청 이벤트에서 트리거하는 GitHub 또는 GitHub Enterprise Server 빌드의 경우 pr/pull-request-number입니다.

보조 소스의 경우 보조 소스 버전의 환경 변수는 CODEBUILD_SOURCE_VERSION_<sourceIdentifier>입니다. 여기서 <sourceIdentifier>는 사용자가 생성한 소스 식별자입니다. 자세한 내용은 다중 입력 소스 및 출력 아티팩트 샘플 섹션을 참조하세요.

CODEBUILD_SRC_DIR

CodeBuild가 빌드에 사용하는 디렉터리 경로입니다(예: /tmp/src123456789/src).

보조 소스를 사용하는 경우 보조 소스 디렉터리 경로의 환경 변수는 CODEBUILD_SRC_DIR_<sourceIdentifier>입니다. 여기서 <sourceIdentifier>는 사용자가 생성한 소스 식별자입니다. 자세한 내용은 다중 입력 소스 및 출력 아티팩트 샘플 섹션을 참조하세요.

CODEBUILD_START_TIME

밀리초 단위의 Unix 타임스탬프로 지정된 빌드의 시작 시간입니다.

CODEBUILD_WEBHOOK_ACTOR_ACCOUNT_ID

Webhook 이벤트를 트리거한 사용자의 계정 ID입니다.

CODEBUILD_WEBHOOK_BASE_REF

현재 빌드를 트리거하는 Webhook 이벤트의 기본 참조 이름입니다. pull 요청의 경우 이를 브랜치 참조라고 합니다.

CODEBUILD_WEBHOOK_EVENT

현재 빌드를 트리거하는 Webhook 이벤트입니다.

CODEBUILD_WEBHOOK_MERGE_COMMIT

빌드에 사용된 병합 커밋의 식별자입니다. 이 변수는 Bitbucket 풀 요청이 스쿼시 전략과 병합되고 pull 요청 분기가 닫힐 때 설정됩니다. 이 경우 원래의 풀 요청 커밋은 더 이상 존재하지 않으므로 이 환경 변수에는 스쿼시된 병합 커밋의 식별자가 포함됩니다.

CODEBUILD_WEBHOOK_PREV_COMMIT

현재 빌드를 트리거하는 webhook 푸시 이벤트 전 최신 커밋의 ID입니다.

CODEBUILD_WEBHOOK_HEAD_REF

현재 빌드를 트리거하는 Webhook 이벤트의 헤드 참조 이름입니다. 브랜치 참조 또는 태그 참조일 수 있습니다.

CODEBUILD_WEBHOOK_TRIGGER

빌드를 트리거하는 Webhook 이벤트를 표시합니다. 이 변수는 Webhook가 트리거하는 빌드에만 사용할 수 있습니다. 이 값은 GitHub, GitHub Enterprise Server 또는 Bitbucket이 CodeBuild로 전송하는 페이로드에서 구문 분석됩니다. 값의 형식은 빌드를 트리거한 이벤트 유형에 따라 다릅니다.

  • pull 요청이 트리거한 빌드의 경우 pr/pull-request-number입니다.

  • 새 브랜치를 생성하거나 브랜치로 커밋을 푸시하여 트리거된 빌드의 경우 branch/branch-name입니다.

  • 리포지토리로 태그를 푸시하여 트리거된 빌드의 경우 tag/tag-name입니다.

HOME

이 환경 변수는 항상 /root로 설정되어 있습니다.

자체 환경 변수를 사용하여 빌드 환경을 제공할 수도 있습니다. 자세한 정보는 다음 주제를 참조하세요.

빌드 환경에서 사용 가능한 모든 환경 변수를 나열하려면 빌드 중에 printenv (Linux 기반 빌드 환경의 경우) 또는 "Get-ChildItem Env:" (Windows 기반 빌드 환경의 경우) 명령을 실행하면 됩니다. 앞에서 나열한 환경 변수를 제외하고, CODEBUILD_로 시작하는 환경 변수는 CodeBuild에서 내부적으로 사용합니다. 이러한 환경 변수는 빌드 명령에서 사용하면 안 됩니다.

중요

환경 변수를 사용하여 중요한 값(특히 AWS 액세스 키 ID)을 저장하는 것은 가급적 피해야 합니다. 환경 변수는 CodeBuild 콘솔 및 AWS CLI와 같은 도구를 사용하여 일반 텍스트로 표시할 수 있습니다.

중요한 값을 Amazon EC2 Systems Manager Parameter Store에 저장한 후에 buildspec에서 검색하는 것이 좋습니다. 중요한 값을 저장하려면 Amazon EC2 Systems Manager 사용 설명서의 Systems Manager Parameter Store 및 안내: 문자열 파라미터 생성 및 테스트(콘솔)를 참조하세요. 검색하려면 buildspec 구문의 parameter-store 매핑을 참조하십시오.