כיצד 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 [מקורות]

בואו ננסה לשלב את 2 הדוגמאות הקודמות. משתני קבוצה מקבלים עדיפות על משתנים בתוך .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

ירושה עם include וקבוצות [מקורות]

כאן ננסה לכלול את פרויקט-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

ירושה עם include [מקורות]

כאן ננסה לכלול את פרויקט-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 הראשי והכלול הוא נפוץ. ולקובץ שבו מתרחשת ההכללה יש עדיפות.

מקור: www.habr.com