הגדרה של מאגר פרטי של קונטיינרים

בדף הזה מוסבר איך להגדיר שרת קיים של Container Registry לתוכנת Google Distributed Cloud ל-VMware בלבד.

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

סקירה כללית

כברירת מחדל, במהלך יצירה או שדרוג של אשכול, Google Distributed Cloud שולף קובצי אימג' של המערכת מ-gcr.io/gke-on-prem-release באמצעות חשבון השירות לגישה לרכיבים. אם רוצים, אפשר לספק שרת משלכם ל-Container Registry, כדי שקובצי האימג' של המערכת יישלפו משרת ה-Container Registry הפרטי שלכם.

‫Google Distributed Cloud לא תומך במאגרי קונטיינרים לא מאובטחים. כשמפעילים את שרת Container Registry, צריך לספק אישור ומפתח. האישור יכול להיות חתום על ידי רשות אישורים (CA) ציבורית, או שהוא יכול להיות בחתימה עצמית.

יצירת שרת של Container Registry

כדי ללמוד איך ליצור שרת Container Registry, קראו את המאמר הפעלת מאגר עם גישה חיצונית במסמכי התיעוד של Docker.

הגדרת המאגר

כדי להשתמש ב-Container Registry פרטי, אתם יכולים להשתמש בכלי שורת הפקודה gkectl או ב-Terraform.

gkectl

  1. לפני שיוצרים את האשכול, מוסיפים את הקטע privateRegistry לקובץ התצורה של אשכול האדמין.

    כשממלאים את הקטע הזה:

    • כשמריצים את הפקודה gkectl prepare לפני שיוצרים או משדרגים את האשכול, הפקודה מחלצת את קובצי האימג' מקובץ ה-tar שצוין בשדה bundlePath בקובץ התצורה של אשכול האדמין, ומעבירה את קובצי האימג' לשרת הרישום הפרטי.

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

  2. אם הרשת שלכם נמצאת מאחורי שרת proxy, מלאו את הקטע proxy.

Terraform

  1. כדי למלא את קובץ התצורה של אשכול האדמין, פועלים לפי השלבים בכרטיסייה Terraform במאמר יצירת אשכול אדמין.

  1. מוסיפים את הטקסט הבא לקובץ התצורה של אשכול האדמין:

    private_registry_config {
      address = "ADDRESS"
      ca_cert = "CA_CERT"
    }
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫ADDRESS: כתובת ה-IP או ה-FQDN (שם דומיין שמוגדר במלואו) של המכונה שמריצה את המרשם הפרטי.

    • ‫CA_CERT: נתוני אישור ה-CA של המפתח הציבורי, אבל כל השורות החדשות מוחלפות במחרוזת \n.

    1. מריצים את הפקודה הבאה כדי להחליף שורות חדשות ב-\n:

      awk 'ORS="\\n" {print}' PUBLIC_KEY_PATH
      

      מחליפים את PUBLIC_KEY_PATH בנתיב למפתח הציבורי.

    2. מעתיקים את הפלט של הפקודה הקודמת ומדביקים אותו במשתנה של ה-placeholder‏ CA_CERT.

  2. אם הרשת שלכם נמצאת מאחורי שרת proxy, הוסיפו את הפרטים הבאים:

    proxy {
      url: "PROXY_SERVER_ADDRESS"
      no_proxy: "BYPASS_LIST"
    }
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROXY_SERVER_ADDRESS: כתובת ה-HTTP של שרת ה-proxy. צריך לכלול את מספר היציאה גם אם הוא זהה ליציאת ברירת המחדל של הסכימה.

    • ‫BYPASS_LIST: רשימה מופרדת בפסיקים של כתובות IP, טווחי כתובות IP, שמות מארחים ושמות דומיינים שלא אמורים לעבור דרך שרת ה-proxy.

    דוגמה:

    url: "http://my-proxy.example.local:80"
    no_proxy: "192.0.2.0/24,my-host.example.local,198.51.100.0"
    

    כש-Google Distributed Cloud שולח בקשה לאחת מהכתובות, המארחים או הדומיינים האלה, הבקשה עוקפת את שרת ה-proxy ונשלחת ישירות ליעד.

  1. ממשיכים לפי השלבים בכרטיסייה Terraform במאמר יצירת אשכול אדמין כדי לאמת את קובץ התצורה והתוכנית של Terraform, ואז יוצרים את אשכול ה-bootstrap.

  2. כשמריצים את הפקודה gkectl register bootstrap, הכלי gkectl מבקש להזין את שם המשתמש ואז את הסיסמה של המרשם הפרטי.

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

מגבלות על אשכולות מתקדמים ועל החבילה המלאה

יש שתי חבילות זמינות של Google Distributed Cloud: מלאה ורגילה. כדי לדעת איזו חבילה נמצאת בתחנת העבודה של האדמין, בודקים את השדה bundlePath בקובץ התצורה של אשכול האדמין. אם שם הקובץ מסתיים ב--full, החבילה המלאה נמצאת בתחנת העבודה של האדמין. אם שם הקובץ לא מסתיים ב--full, החבילה הרגילה נמצאת בתחנת העבודה של האדמין.

אם יצרתם את תחנת הניהול באמצעות הפקודה gkeadm, הפקודה יוצרת את ה-VM של תחנת הניהול עם החבילה המלאה, ומגדירה את השדה bundlePath בקובץ התצורה של אשכול הניהול.

אם מפעילים את advanced cluster, יש מגבלות על השימוש בחבילה המלאה עם מאגר פרטי, כפי שמתואר בהמשך:

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

    1. מורידים את החבילה בגודל הרגיל לתחנת העבודה של האדמין.
    2. מעדכנים את שם הקובץ בשדה bundlePath בקובץ התצורה של אשכול האדמין.
  • גרסה 1.32: אפשר להשתמש בחבילה המלאה, אבל הפקודה gkectl prepare שולפת קובצי אימג' מ-gcr.io/gke-on-prem-release במקום מקובץ ה-tar. עם זאת, הפקודה מעבירה את קובצי האימג' ל-registry הפרטי, כך שקובצי האימג' של המערכת נשלפים מה-registry הפרטי במהלך היצירה או השדרוג של האשכול.

ההבדלים בין אשכולות רגילים לאשכולות מתקדמים

יש כמה הבדלים עיקריים בין אשכולות מתקדמים לאשכולות רגילים:

  • כשמשתמשים במרשם פרטי, נראה שהתמונות נשלפות מ-gcr.io ולא משם המארח של המרשם הפרטי. השינוי הזה צפוי, למרות שהתמונות נשלפות בפועל משרת המרשם הפרטי שלכם.
  • שליפות של תמונות משתמשות בפרטי הכניסה מהקובץ /etc/containerd/config.toml בכל מכונה שמתחברת למאגר הפרטי, במקום מהסוד private-registry-creds בתוך האשכול.
  • בכל קובצי האימג' של gcr.io, האשכול מנסה קודם לשלוף מהמרשם הפרטי. אם התמונה לא נמצאת במרשם הפרטי, המערכת שולפת אותה מ-gcr.io דרך האינטרנט. כדי להפסיק את החלופה הזו, צריך להגדיר את noProxy או להשתמש בכללים של חומת האש כדי לחסום את התנועה של gcr.io.

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

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

הדרך שבה מוודאים שהתמונות נשלפות משרת הרישום תלויה בשאלה אם האשכול המתקדם מופעל.

  • אם האשכול המתקדם לא מופעל, מריצים את הפקודה הבאה:

    kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get pods \
        --all-namespaces -o jsonpath="{.items[*].spec['initContainers', 'containers'][*].image}"
    

    מחליפים את ADMIN_CLUSTER_KUBECONFIG בנתיב של קובץ ה-kubeconfig של אשכול האדמין.

    הפלט של הפקודה הזו מציג את כל התמונות באשכול. אתם יכולים לוודא שכל קובצי האימג' של Google Distributed Cloud מגיעים משרת המרשם שלכם.

  • אם התכונה "אשכול מתקדם" מופעלת, מבצעים את הפעולות הבאות:

    כדי לבדוק אם containerd שולף תמונות מהמרשם המקומי, בודקים את התוכן של קובץ בשם config.toml, כמו שמוסבר בשלבים הבאים:

    1. מתחברים לצומת ובודקים את תוכן הקובץ /etc/containerd/config.toml.
    2. בודקים את השדה plugins."io.containerd.grpc.v1.cri".registry.mirrors בקובץ config.toml כדי לראות אם שרת המרשם מופיע בשדה endpoint.

      הקטע הבא הוא דוגמה לקובץ config.toml.

      version = 2
      root = "/var/lib/containerd"
      state = "/run/containerd"
      ...
      [plugins."io.containerd.grpc.v1.cri".registry]
      [plugins."io.containerd.grpc.v1.cri".registry.configs]
      [plugins."io.containerd.grpc.v1.cri".registry.configs."gcr.io"]
      [plugins."io.containerd.grpc.v1.cri".registry.configs."privateregistry2.io".tls]
      ca_file = '/etc/containerd/certs.d/privateregistry2.io/ca.crt'
      [plugins."io.containerd.grpc.v1.cri".registry.mirrors]
      [plugins."io.containerd.grpc.v1.cri".registry.mirrors."gcr.io"]
      endpoint = ["http://privateregistry.io", "http://privateregistry2.io"]
      ...
      
    3. אם מאגר ה-mirror של המרשם מופיע בשדה endpoint, הצומת שולף תמונות ממאגר ה-mirror של המרשם ולא מ-Artifact Registry.