Docker Compose: מפיתוח לייצור

תרגום תמלול הפודקאסט שהוכן לקראת תחילת הקורס "מנהל לינוקס"

Docker Compose הוא כלי מדהים ליצירת עבודה
סביבה עבור המחסנית המשמשת ביישום שלך. זה מאפשר לך להגדיר
כל רכיב של היישום שלך, בעקבות תחביר ברור ופשוט ב YAML-
קבצים.

עם כניסתו של docker compose v3 ניתן להשתמש בקבצי YAML אלה ישירות בסביבת הייצור בעת עבודה עם
אֶשׁכּוֹל נחיל דוקר.

אבל האם זה אומר שאתה יכול להשתמש באותו קובץ docker-compose ב
תהליך הפיתוח ובסביבת הייצור? או השתמש באותו קובץ עבור
הַצָגָה? ובכן, באופן כללי, כן, אבל עבור הפונקציונליות הזו אנחנו צריכים את הדברים הבאים:

• אינטרפולציה משתנים: שימוש במשתני סביבה עבור חלק
  ערכים המשתנים בכל סביבה.
• עקיפה של תצורה: יכולת להגדיר שנייה (או כל
  קובץ נוסף עוקב) docker-compose שישנה משהו לגבי
  ראשית, ו-docker compose ידאג למיזוג שני הקבצים.

הבדלים בין קבצי פיתוח לייצור

במהלך הפיתוח, סביר להניח שתרצה לבדוק שינויים בקוד
זמן אמת. לשם כך, בדרך כלל נפח האחסון עם קוד המקור מותקן
מיכל המכיל זמן ריצה עבור היישום שלך. אבל לסביבת ייצור
שיטה זו אינה מתאימה.

בייצור, יש לך אשכול עם צמתים רבים, והנפח הוא מקומי
ביחס לצומת שעליו פועל המכולה (או השירות) שלך, אז אתה לא עושה זאת
אתה יכול להעלות את קוד המקור ללא פעולות מורכבות הכוללות
סנכרון קוד, אותות וכו'.

במקום זאת, אנו בדרך כלל רוצים ליצור תמונה עם גרסה ספציפית של הקוד שלך.
נהוג לסמן בתג המתאים (אפשר להשתמש בסמנטיקה
ניהול גרסאות או מערכת אחרת לפי שיקול דעתך).

ביטול תצורה

בהתחשב בהבדלים ושהתלות שלך עשויה להיות שונה בתרחישים
פיתוח וייצור, ברור שנצטרך קבצי תצורה שונים.

Docker compose תומך במיזוג קבצי חיבור שונים
להשיג את התצורה הסופית. איך זה עובד ניתן לראות בדוגמה:

$ cat docker-compose.yml
version: "3.2"

services:
  whale:
    image: docker/whalesay
    command: ["cowsay", "hello!"]
$ docker-compose up
Creating network "composeconfigs_default" with the default driver
Starting composeconfigs_whale_1
Attaching to composeconfigs_whale_1
whale_1  |  ________
whale_1  | < hello! >
whale_1  |  --------
whale_1  |     
whale_1  |      
whale_1  |       
whale_1  |                     ##        .
whale_1  |               ## ## ##       ==
whale_1  |            ## ## ## ##      ===
whale_1  |        /""""""""""""""""___/ ===
whale_1  |   ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
whale_1  |        ______ o          __/
whale_1  |                     __/
whale_1  |           __________/
composeconfigs_whale_1 exited with code 0

כאמור, docker compose תומך בשילוב חיבורים מרובים -
קבצים, זה מאפשר לך לעקוף פרמטרים שונים בקובץ השני. לדוגמה:

$ cat docker-compose.second.yml
version: "3.2"
services:
  whale:
    command: ["cowsay", "bye!"]

$ docker-compose -f docker-compose.yml -f docker-compose.second.yml up
Creating composeconfigs_whale_1
Attaching to composeconfigs_whale_1
whale_1  |  ______
whale_1  | < bye! >
whale_1  |  ------
whale_1  |     
whale_1  |      
whale_1  |       
whale_1  |                     ##        .
whale_1  |               ## ## ##       ==
whale_1  |            ## ## ## ##      ===
whale_1  |        /""""""""""""""""___/ ===
whale_1  |   ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
whale_1  |        ______ o          __/
whale_1  |                     __/
whale_1  |           __________/
composeconfigs_whale_1 exited with code 0

תחביר זה אינו נוח במיוחד במהלך הפיתוח, כאשר הפקודה
יצטרך להיעשות פעמים רבות.

למרבה המזל, docker compose מחפש אוטומטית קובץ מיוחד בשם
docker-compose.override.yml לעקוף ערכים docker-compose.ym. אם
שנה את שם הקובץ השני, אתה מקבל את אותה תוצאה, רק באמצעות הפקודה המקורית:

$ mv docker-compose.second.yml docker-compose.override.yml
$ docker-compose up
Starting composeconfigs_whale_1
Attaching to composeconfigs_whale_1
whale_1  |  ______
whale_1  | < bye! >
whale_1  |  ------
whale_1  |     
whale_1  |      
whale_1  |       
whale_1  |                     ##        .
whale_1  |               ## ## ##       ==
whale_1  |            ## ## ## ##      ===
whale_1  |        /""""""""""""""""___/ ===
whale_1  |   ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
whale_1  |        ______ o          __/
whale_1  |                     __/
whale_1  |           __________/
composeconfigs_whale_1 exited with code 0

אוקיי, קל יותר לזכור את זה.

אינטרפולציה של משתנים

תמיכה בקבצי תצורה שִׁרבּוּב
משתנים וערכי ברירת מחדל. כלומר, אתה יכול לעשות את הפעולות הבאות:

services:
  my-service:
    build:
      context: .
    image: private.registry.mine/my-stack/my-service:${MY_SERVICE_VERSION:-latest}
...

ואם כן בניית docker-compose (או דחיפה) ללא משתנה סביבה
$MY_SERVICE_VERSION, הערך ישמש האחרוןאבל אם תגדיר
הערך של משתנה הסביבה לפני הבנייה, הוא ישמש בעת בנייה או דחיפה
לפנקס private.registry.mine.

העקרונות שלי

הגישות שעובדות בשבילי עשויות לעבוד גם בשבילך. אני עוקב אחר אלה
כללים פשוטים:

• כל הערימות שלי לייצור, פיתוח (או סביבות אחרות) מוגדרות דרך
  קבצי docker-compose
• קבצי תצורה הדרושים כדי לכסות את כל הסביבות שלי, ככל האפשר
  למנוע כפילות.
• אני צריך פקודה אחת פשוטה כדי לעבוד בכל סביבה.
• התצורה הראשית מוגדרת בקובץ docker-compose.ym.
• משתני סביבה משמשים להגדרת תגי תמונה או אחרים
  משתנים שעשויים להשתנות מסביבה לסביבה (ביימה, אינטגרציה,
  הפקה).
• הערכים של משתני ייצור משמשים כערכים עבור
  כברירת מחדל, זה ממזער את הסיכונים אם הערימה מושקת בייצור ללא
  הגדר משתנה סביבה.
• כדי להפעיל שירות בסביבת ייצור, השתמש בפקודה docker stack deploy - חיבור-קובץ docker-compose.yml -with-registry-auth-my-stack-name.
• סביבת העבודה מתחילה באמצעות הפקודה docker-compose למעלה.

בואו נסתכל על דוגמה פשוטה.

# docker-compose.yml
...
services:
  my-service:
    build:
      context: .
    image: private.registry.mine/my-stack/my-service:${MY_SERVICE_VERSION:-latest}
    environment:
      API_ENDPOINT: ${API_ENDPOINT:-https://production.my-api.com}
...

И

# docker-compose.override.yml
...
services:
  my-service:
    ports: # This is needed for development!
      - 80:80
    environment:
      API_ENDPOINT: https://devel.my-api.com
    volumes:
      - ./:/project/src
...

אני יכול להשתמש docker-compose (docker-compose up)להפעיל את הערימה פנימה
מצב פיתוח עם קוד מקור מותקן /project/src.

אני יכול להשתמש באותם קבצים בייצור! ואני בהחלט יכול להשתמש
אותו קובץ docker-compose.ym לבימוי. כדי להרחיב את זה ל
ייצור, אני רק צריך לבנות ולשלוח את התמונה עם תג מוגדר מראש
בשלב CI:

export MY_SERVICE_VERSION=1.2.3
docker-compose -f docker-compose.yml build
docker-compose -f docker-compose.yml push

בייצור, ניתן להפעיל את זה באמצעות הפקודות הבאות:

export MY_SERVICE_VERSION=1.2.3
docker stack deploy my-stack --compose-file docker-compose.yml --with-registry-auth

ואם אתה רוצה לעשות את אותו הדבר על הבמה, אתה רק צריך להגדיר
משתני סביבה נחוצים לעבודה בסביבת הבמה:

export MY_SERVICE_VERSION=1.2.3
export API_ENDPOINT=http://staging.my-api.com
docker stack deploy my-stack --compose-file docker-compose.yml --with-registry-auth

כתוצאה מכך, השתמשנו בשני קבצי docker-compose שונים, אשר ללא
ניתן להשתמש בתצורות כפולות עבור כל סביבה שיש לך!

למידע נוסף על הקורס "מנהל לינוקס"

מקור: www.habr.com