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

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

빌드 환경의 환경 변수

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

AWS_DEFAULT_REGION

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

AWS_REGION

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

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

배치 빌드에 있는 빌드의 식별자입니다. 이것은 배치 빌드 사양에서 지정됩니다. 자세한 정보는 Batch 빌드 빌드 사양 참조을 참조하십시오.

코드빌드_빌드_ARN

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

코드빌드_빌드_ID

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

코드빌드_빌드_이미지

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

코드빌드_빌드_번호

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

코드빌드_빌드_성공

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

코드빌드_이니시에이터

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

코드빌드_KMS_KEY_ID

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

코드빌드_LOG_경로

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

코드빌드_공개_빌드_URL

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

코드빌드_해결_소스_버전

빌드의 소스 코드 버전 식별자입니다. 컨텐츠는 소스 코드 리포지토리에 따라 다릅니다.

CodeCommit, GitHub, GitHub Enterprise Server 및 Bitbucket을

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

CodePipeline

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

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

Amazon S3

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

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

코드빌드_소스_리포_URL

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

보조 소스의 경우 보조 소스 저장소 URL에 대한 환경 변수는 다음과 같습니다.CODEBUILD_SOURCE_REPO_URL_<sourceIdentifier>여기서<sourceIdentifier>는 사용자가 생성하는 소스 식별자입니다.

코드빌드_소스_버전

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

  • 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>는 사용자가 생성하는 소스 식별자입니다. 자세한 정보는 다중 입력 소스 및 출력 아티팩트 샘플을 참조하십시오.

코드빌드_SRC_DIR

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

보조 소스의 경우 보조 소스 디렉토리 경로에 대한 환경 변수는CODEBUILD_SRC_DIR_<sourceIdentifier>여기서<sourceIdentifier>는 사용자가 생성하는 소스 식별자입니다. 자세한 정보는 다중 입력 소스 및 출력 아티팩트 샘플을 참조하십시오.

코드빌드_스타트_시간

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

코드빌드_웹훅_액터_계정_ID

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

코드빌드_웹훅_베이스_REF

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

코드빌드_웹훅_이벤트

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

코드빌드_웹훅_머지_커밋

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

코드빌드_웹훅_프리_커밋

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

코드빌드_웹훅_헤드_REF

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

코드빌드_웹훅_트리거

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

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

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

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

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

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

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

중요

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

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