Gitlab-CI는 환경 변수를 어떻게 상속합니까?

Gitlab의 변수는 여러 위치에서 설정할 수 있습니다.

1. 그룹 설정에서
2. 프로젝트 설정에서
3. .gitlab-ci.yml 내부

이 경우 그룹 및 프로젝트 설정의 변수를 “파일” 또는 “일반변수”로 설정하고 “보호됨”과 “마스크” 체크박스를 체크하면 됩니다.

간단한 상속부터 시작하면 점차 복잡해집니다.

우선순위 수준의 최종 목록은 문서 끝부분에서 확인할 수 있습니다.

그룹을 통한 상속 [출처]

그룹의 변수는 상속되며, 그룹이 프로젝트에 가까울수록 그 값이 더 중요하다는 규칙을 따릅니다.

변수가 있는 그룹

.gitlab-ci.yml

image: busybox:latest
variables:
  GIT_STRATEGY: none

echo:
  stage: test
  script:
    - echo $MSG

파이프라인 결과

$ echo $MSG
B

그룹 B에 변수가 지정되지 않았다면 A 값이 표시되었을 것입니다.

.gitlab-ci.yml 내부 변수 상속 [출처]

여기에서는 모든 것이 매우 간단합니다. 전역적으로 변수를 설정하거나 작업 내에서 덮어쓸 수 있습니다.

변수가 있는 그룹

.gitlab-ci.yml

이제 2개의 작업을 생성해 보겠습니다. 그 중 하나에는 $MSG가 명시적으로 표시됩니다.

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Custom in global .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Custom in job .gitlab-ci.yml"
  script:
    - echo $MSG

파이프라인 결과

• 에코:

  $ echo $MSG
  Custom in global .gitlab-ci.yml
  Job succeeded

• vars로 에코:

  $ echo $MSG
  Custom in job .gitlab-ci.yml
  Job succeeded

그룹 및 .gitlab-ci.yml 내부 상속 [출처]

앞의 두 가지 예를 결합해 보겠습니다. 그룹 변수는 .gitlab-ci.yml 내부 변수보다 우선합니다.

변수가 있는 그룹

.gitlab-ci.yml

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Custom in global .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Custom in job .gitlab-ci.yml"
  script:
    - echo $MSG

파이프라인 결과

• 에코:

  $ echo $MSG
  Y
  Job succeeded

• vars로 에코:

  $ echo $MSG
  Y
  Job succeeded

프로젝트 설정에서 변수를 지정하여 상속 [출처]

프로젝트 설정의 변수는 항상 가장 높은 우선순위를 가집니다! 그리고 .gitlab-ci.yml 내부에 지정된 변수는 어떤 역할도 하지 않습니다.

변수가 있는 그룹

그룹 변수는 우선순위가 낮습니다.

.gitlab-ci.yml

이전 예제의 파일을 사용해 보겠습니다. 여기서도 .gitlab-ci.yml 내부에 지정된 변수가 있지만 그룹 내부의 변수는 여전히 해당 변수보다 우선합니다.

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Custom in global .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Custom in job .gitlab-ci.yml"
  script:
    - echo $MSG

파이프라인 결과

• 에코:

  $ echo $MSG
  project-3
  Job succeeded

• vars로 에코:

  $ echo $MSG
  project-3
  Job succeeded

빈 값을 사용한 상속 [출처]

빈 값도 값입니다.
빈 값은 Null이 아닙니다.

변수가 있는 그룹

.gitlab-ci.yml

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Custom in global .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Custom in job .gitlab-ci.yml"
  script:
    - echo $MSG

파이프라인 결과

• 에코:

  $ echo $MSG
  Job succeeded

• vars로 에코:

  $ echo $MSG
  Job succeeded

포함 및 그룹을 통한 상속 [출처]

여기서는 프로젝트-2에 프로젝트-3을 포함시키려고 합니다.
이 경우 그룹이 우선순위를 가집니다.

변수가 있는 그룹

.gitlab-ci.yml

그리고 .gitlab-ci.yml에서 전역적으로 변수를 설정합니다.

variables:
 MSG: "With  include  .gitlab-ci.yml"
include:
 - project: how-is-gitlab-ci-inherit-environment-variables/z/y/project-3
   file: '.gitlab-ci.yml'

파이프라인 결과

• 에코:

  $ echo $MSG
  B
  Job succeeded

• vars로 에코:

  $ echo $MSG
  B
  Job succeeded

포함을 통한 상속 [출처]

여기서는 프로젝트-2에 프로젝트-3을 포함시키려고 합니다.
조건은 다음과 같습니다. 그룹이나 프로젝트 자체에는 변수가 없습니다.

변수가 있는 그룹

.gitlab-ci.yml

이전 예와 동일

variables:
 MSG: "With  include  .gitlab-ci.yml"
include:
 - project: how-is-gitlab-ci-inherit-environment-variables/z/y/project-3
   file: '.gitlab-ci.yml'

파이프라인 결과

• 에코:

  $ echo $MSG
  With include .gitlab-ci.yml
  Job succeeded

• vars로 에코:

  $ echo $MSG
  Custom in job .gitlab-ci.yml
  Job succeeded

결과는 다음과 같습니다 우선 순위:

1. 프로젝트 설정의 변수
2. 그룹의 변수
3. 작업 내에서 엄격하게 지정된 변수(포함된 파일 포함)
4. .gitlab-ci.yml 내부의 전역 변수
5. 포함된 파일 내의 전역 변수

결론

가장 명확하지 않은 점은 "변수가 코드에 가까울수록 더 중요하다"는 규칙이 먼저 그룹에 적용되고 그 다음에는 .gitlab-ci.yml 내부의 변수에도 동일한 규칙이 적용된다는 것입니다. 단, 다음 조건에서만 적용됩니다. 그룹의 변수가 지정되지 않았습니다.
다음으로 중요한 점은 기본 및 포함된 .gitlab-ci.yml의 전역 공간이 공통적이라는 점을 이해하는 것입니다. 그리고 포함이 발생한 파일이 우선순위를 가집니다.

출처 : habr.com