빌드 환경의 환경 변수

AWS CodeBuild 는 빌드 명령에 사용할 수 있는 몇 가지 환경 변수를 제공합니다.

AWS_DEFAULT_REGION

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

AWS_REGION

빌드가 실행 중인 AWS 리전(예: us-east-1). 이 환경 변수는 주로 에서 사용됩니다 AWS SDKs.

CODEBUILD_BATCH_BUILD_IDENTIFIER

배치 빌드의 빌드 식별자입니다. 이는 배치 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). 에 대한 Jenkins 플러그인이 빌드를 CodeBuild 시작한 경우 문자열 입니다CodeBuild-Jenkins-Plugin.

CODEBUILD_KMS_KEY_ID

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

CODEBUILD_LOG_PATH

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

CODEBUILD_PUBLIC_BUILD_URL

퍼블릭 빌드 웹 사이트에서 이 빌드URL에 대한 빌드 결과의 입니다. 이 변수는 빌드 프로젝트에 퍼블릭 빌드가 활성화된 경우에만 설정됩니다. 자세한 내용은 공개 빌드 프로젝트 받기 URLs 단원을 참조하십시오.

CODEBUILD_RESOLVED_SOURCE_VERSION

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

CodeCommit, GitHub, GitHub 엔터프라이즈 서버 및 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입니다.
의 경우 빌드할 소스 코드의 버전과 연결된 커밋 ID 또는 브랜치 이름 CodeCommit입니다.
GitHub, GitHub 엔터프라이즈 서버 및 Bitbucket의 경우 빌드할 소스 코드의 버전과 연결된 커밋 ID, 브랜치 이름 또는 태그 이름입니다.

참고
웹후크 풀 요청 이벤트에 의해 트리거되는 GitHub 또는 GitHub 엔터프라이즈 서버 빌드의 경우 입니다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 엔터프라이즈 서버 또는 Bitbucket에서 로 전송 CodeBuild 한 페이로드에서 구문 분석됩니다. 값의 형식은 빌드를 트리거한 이벤트 유형에 따라 다릅니다.

pull 요청이 트리거한 빌드의 경우 pr/pull-request-number입니다.
새 브랜치를 생성하거나 브랜치로 커밋을 푸시하여 트리거된 빌드의 경우 branch/branch-name입니다.
리포지토리로 태그를 푸시하여 트리거된 빌드의 경우 tag/tag-name입니다.

HOME

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

AWS CodeBuild 는 자체 호스팅 러너 빌드에 대한 환경 변수 집합도 지원합니다. 자체 호스팅 러너에 대한 CodeBuild 자세한 내용은 섹션을 참조하세요의 자체 호스팅 GitHub 작업 러너 AWS CodeBuild.

CODEBUILD_RUNNER_OWNER: 자체 호스팅 러너 빌드를 트리거하는 리포지토리의 소유자입니다.
CODEBUILD_RUNNER_REPO: 자체 호스팅 러너 빌드를 트리거하는 리포지토리의 이름입니다.
CODEBUILD_RUNNER_REPO_DOMAIN: 자체 호스팅 러너 빌드를 트리거하는 리포지토리의 도메인입니다. 지정된 GitHub 엔터프라이즈 빌드만 해당됩니다.
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 액세스 키 를 저장하지 않는 것이 좋습니다IDs. 환경 변수는 CodeBuild 콘솔 및 와 같은 도구를 사용하여 일반 텍스트로 표시할 수 있습니다 AWS CLI.

민감한 값은 Amazon EC2 Systems Manager 파라미터 스토어에 저장한 다음 빌드 사양에서 검색하는 것이 좋습니다. 민감한 값을 저장하려면 Amazon EC2 Systems Manager 사용 설명서의 Systems Manager 파라미터 스토어 및 연습: 문자열 파라미터 생성 및 테스트(콘솔)를 참조하세요. 검색하려면 buildspec 구문의 parameter-store 매핑을 참조하십시오.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

빌드 환경의 쉘 및 명령

빌드 환경의 배경 작업

빌드 환경의 환경 변수

참고

중요