🥇Kuidas Gitlab-CI pärib keskkonna muutujaid?

Gitlabis saab muutujaid määrata mitmes kohas:

Grupi seadetes
Projektiseadetes
Failis .gitlab-ci.yml

Gruppide ja projektide seadetes saab muutujaid määrata kui „fail“ või „tavaline muutuja“ ning valida kastid „kaitstud“ ja „maskida”.

Alustame lihtsast pärandamisest ja raskendame järk-järgult.

Lõplikku prioriteedi tasemete loendit saab vaadata dokumendi lõpus.

Pärandamine gruppide kaudu [source files]

Rühmadest pärinevad muutujaid rakendatakse reegli järgi, et mida lähemal on grupp projektile, seda tähtsam on selle väärtus.

Muutujatega grupid

.gitlab-ci.yml

image: busybox:latest
variables:
  GIT_STRATEGY: none

echo:
  stage: test
  script:
    - echo $MSG

Pipeliini tulemus

$ echo $MSG
B

Kui muutujat ei oleks määratud grupis B, oleksime näinud väärtust A.

Muudatused muutuja pärimises failis .gitlab-ci.yml [source files]

Siin on kõik üsna lihtne: saab määrata globaalse muutuja või kirjutada selle ümber töö sees.

Muutujatega grupid

.gitlab-ci.yml

Loome nüüd 2 tööd, millest ühes määrame selgelt $MSG.

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Kohandatud globaalne .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Kohandatud töö .gitlab-ci.yml"
  script:
    - echo $MSG

Pipeliini tulemus

echo:

$ echo $MSG
Kohandatud globaalne .gitlab-ci.yml
Töö õnnestus

echo with vars:

$ echo $MSG
Kohandatud töö .gitlab-ci.yml
Töö õnnestus

Pärandamine gruppide kaudu ja faili .gitlab-ci.yml sees [source files]

Proovime kombineerida eelnevaid 2 näidet. Gruppide muutujad on eelistatud võrreldes muudatustega failis .gitlab-ci.yml.

Muutujatega grupid

.gitlab-ci.yml

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Kohandatud globaalne .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Kohandatud töö .gitlab-ci.yml"
  script:
    - echo $MSG

Pipeliini tulemus

echo:
```
$ echo $MSG
Y
Töö õnnestus
```
echo with vars:
```
$ echo $MSG
Y
Töö õnnestus
```

Pärandamine projektide seadetes määratud muutujatega [source files]

Projektide seadetes määratud muutujad on ALATI kõige kõrgema prioriteediga! Ja failis .gitlab-ci.yml määratud muutujatel ei ole mingit tähtsust.

Muutujatega grupid

Grupi muutujatel on madalam prioriteet.

.gitlab-ci.yml

Kasutame eelnevas näites olevat faili. Siin on taas kohal muutujad failis .gitlab-ci.yml, kuid grupi muutujad on endiselt neist kõrgema prioriteediga.

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Kohandatud globaalne .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Kohandatud töö .gitlab-ci.yml"
  script:
    - echo $MSG

Pipeliini tulemus

echo:
```
$ echo $MSG
project-3
Töö õnnestus
```
echo with vars:
```
$ echo $MSG
project-3
Töö õnnestus
```

Pärandamine tühja väärtusega [source files]

Tühi väärtus on samuti väärtus
Tühi väärtus ei ole Null

Muutujatega grupid

.gitlab-ci.yml

image: busybox:latest
variables:
  GIT_STRATEGY: none
  MSG: "Kohandatud globaalne .gitlab-ci.yml"

echo:
  stage: test
  script:
    - echo $MSG

echo with var:
  stage: test
  variables:
    MSG: "Kohandatud töö .gitlab-ci.yml"
  script:
    - echo $MSG

Pipeliini tulemus

echo:
```
$ echo $MSG
Töö õnnestus
```
echo with vars:
```
$ echo $MSG
Töö õnnestus
```

Pärandamine koos kaasamise ja gruppidega [source files]

Siin proovime projektis project-2 kaasata project-3
Gruppidel on sel juhul prioriteet.

Muutujatega grupid

.gitlab-ci.yml

Ja määrame muutuja globaalselt failis .gitlab-ci.yml

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

Pipeliini tulemus

echo:
```
$ echo $MSG
B
Töö õnnestus
```
echo with vars:
```
$ echo $MSG
B
Töö õnnestus
```

Pärandamine koos kaasamisega [source files]

Siin proovime projektis project-2 kaasata project-3.
Kuna tingimusel, et ei rühm ega projekt ei sisalda muutujaid.

Muutujatega grupid

.gitlab-ci.yml

Sama nagu eelnevas näites

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

Pipeliini tulemus

echo:

$ echo $MSG
Sisaldab .gitlab-ci.yml
Töö õnnestus

echo with vars:

$ echo $MSG
Kohandatud töö .gitlab-ci.yml
Töö õnnestus

Saame järgmised prioriteedid:

Muutujad projekti seadetes
Muutujad rühmades
Muutujad, mis on rangelt määratud töö sees (kaasa arvatud kaasatud failid)
Globaalne muutujad .gitlab-ci.yml sees
Globaalne muutujad kaasatud failides

Kokkuvõte

Kohaneb kõige vähem ilmselge, et reegel 'mida lähemal muutuja koodile, seda olulisem' kehtib kõigepealt rühmadele ning seejärel sama reegel ka .gitlab-ci.yml failides, kuid tingimusel, et rühmades ei ole muutujaid määratud.
Oluline koht on ka mõista, et globaalne ruum põhjaliku ja kaasatud .gitlab-ci.yml jaoks on ühisosa. Ja see fail, kuhu toimub kaasamine, omab prioriteeti.

Allikas: habr.com