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:
키 식별자입니다(예: AWS KMS 또는region-ID
:account-ID
:key/key-ID
alias/
).key-alias
- CODEBUILD_LOG_PATH
-
해당 빌드에 대한 CloudWatch Logs의 로그 스트림 이름입니다.
- CODEBUILD_PUBLIC_BUILD_URL
-
퍼블릭 빌드 웹사이트에 있는 이 빌드의 빌드 결과 URL입니다. 이 변수는 빌드 프로젝트에 퍼블릭 빌드가 활성화된 경우에만 설정됩니다. 자세한 내용은 퍼블릭 빌드 프로젝트 URL 가져오기 단원을 참조하십시오.
- 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
로 설정되어 있습니다.
AWS CodeBuild는 자체 호스팅 실행기 빌드에 대한 환경 변수 집합도 지원합니다. CodeBuild 자체 호스팅 실행기에 대한 자세한 내용은 자습서: CodeBuild 호스팅 GitHub Action 실행기 구성 섹션을 참조하세요.
- CODEBUILD_RUNNER_OWNER
-
자체 호스팅 실행기 빌드를 트리거하는 리포지토리의 소유자입니다.
- CODEBUILD_RUNNER_REPO
-
자체 호스팅 실행기 빌드를 트리거하는 리포지토리의 이름입니다.
- CODEBUILD_RUNNER_REPO_DOMAIN
-
자체 호스팅 실행기 빌드를 트리거하는 리포지토리의 도메인입니다. 지정된 GitHub Enterprise 빌드만 해당됩니다.
- CODEBUILD_WEBHOOK_LABEL
-
빌드 재정의를 구성하는 데 사용되는 레이블과 빌드 중에 자체 호스팅된 실행기입니다.
- CODEBUILD_WEBHOOK_RUN_ID
-
빌드와 연결된 워크플로의 실행 ID입니다.
- CODEBUILD_WEBHOOK_JOB_ID
-
빌드와 연결된 작업의 작업 ID입니다.
- CODEBUILD_WEBHOOK_WORKFLOW_NAME
-
웹후크 요청 페이로드에 빌드가 있는 경우 빌드와 연결된 워크플로의 이름입니다.
- CODEBUILD_RUNNER_WITH_BUILDSPEC
-
자체 호스팅 실행기 요청 레이블에 buildspec 재정의가 구성된 경우 이 재정의는
true
로 설정됩니다.
자체 환경 변수를 사용하여 빌드 환경을 제공할 수도 있습니다. 자세한 정보는 다음 주제를 참조하세요.
빌드 환경에서 사용 가능한 모든 환경 변수를 나열하려면 빌드 중에 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
매핑을 참조하십시오.