사전 정의된 CI/CD 변수 참조
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-Managed, GitLab Dedicated
미리 정의된 CI/CD 변수는 모든 GitLab CI/CD 파이프라인에서 사용할 수 있습니다.
미리 정의된 변수는 파이프라인 실행의 두 가지 다른 단계에서 사용할 수 있습니다. 일부 변수는 GitLab이 파이프라인을 만들 때 사용할 수 있으며, 파이프라인을 구성하거나 작업 스크립트에서 사용할 수 있습니다. 다른 변수는 러너가 작업을 실행할 때 사용할 수 있으며, 작업 스크립트에서만 사용할 수 있습니다.
러너가 제공하는 미리 정의된 변수는 트리거 작업나 다음 키워드와 함께 사용할 수 없습니다.
미리 정의된 변수를 덮어쓰기하는 것을 피하십시오. 이렇게하면 파이프라인이 예기치 않게 동작할 수 있습니다.
변수 | 정의 대상 | GitLab | 러너 | 설명 |
---|---|---|---|---|
CHAT_CHANNEL
| 파이프라인 | 10.6 | 모두 | ChatOps 명령을 활성화한 소스 채널입니다. |
CHAT_INPUT
| 파이프라인 | 10.6 | 모두 | ChatOps 명령과 함께 전달된 추가적인 인수입니다. |
CHAT_USER_ID
| 파이프라인 | 14.4 | 모두 | ChatOps 명령을 트리거한 사용자의 챗 서비스 사용자 ID입니다. |
CI
| 파이프라인 | 모두 | 0.4 | CI/CD에서 실행된 모든 작업에 대해 사용할 수 있습니다. 사용 가능한 경우 true 입니다.
|
CI_API_V4_URL
| 파이프라인 | 11.7 | 모두 | GitLab API v4 루트 URL입니다. |
CI_API_GRAPHQL_URL
| 파이프라인 | 15.11 | 모두 | GitLab API GraphQL 루트 URL입니다. |
CI_BUILDS_DIR
| 작업 전용 | 모두 | 11.10 | 작업이 실행되는 빌드의 최상위 디렉터리입니다. |
… | ||||
TRIGGER_PAYLOAD
| 파이프라인 | 13.9 | 모두 | 웹훅 페이로드입니다. 파이프라인이 웹훅을 사용하여 트리거된 경우에만 사용할 수 있습니다. |
머지 요청 파이프라인을 위한 사전 정의된 변수
이러한 변수는 다음 경우에 사용할 수 있습니다:
- 파이프라인이 머지 요청 파이프라인 인 경우
- 머지 요청이 열려 있는 경우
Variable | GitLab | Runner | Description |
---|---|---|---|
CI_MERGE_REQUEST_APPROVED
| 14.1 | all | 머지 요청의 승인 상태. 머지 요청 승인을 사용할 수 있으며 머지 요청이 승인된 경우 true .
|
CI_MERGE_REQUEST_ASSIGNEES
| 11.9 | all | 머지 요청의 담당자의 사용자 이름 디렉터리(쉼표로 구분됨). |
… |
외부 풀 리퀘스트 파이프라인을 위한 사전 정의된 변수
이러한 변수는 오직 다음 경우에 사용할 수 있습니다:
- 파이프라인이 외부 풀 리퀘스트 파이프라인 인 경우
- 풀 리퀘스트가 열려 있는 경우
Variable | GitLab | Runner | Description |
---|---|---|---|
CI_EXTERNAL_PULL_REQUEST_IID
| 12.3 | all | GitHub에서의 풀 리퀘스트 ID. |
CI_EXTERNAL_PULL_REQUEST_SOURCE_REPOSITORY
| 13.3 | all | 풀 리퀘스트의 소스 리포지터리 이름. |
… |
배포 변수
배포 구성을 담당하는 통합은 빌드 환경에서 설정된 자체 사전 정의 변수를 정의할 수 있습니다. 이러한 변수는 배포 작업에만 정의됩니다.
예를 들어, Kubernetes 통합은 해당 통합에서 사용할 수 있는 배포 변수를 정의합니다.
각 통합의 문서에서 해당 통합이 사용 가능한 배포 변수를 설명합니다.
문제 해결
script
명령을 사용하여 작업에 대한 사용 가능한 모든 변수의 값을 출력할 수 있습니다.