בדף הזה מוסבר איך להגדיר שרת קיים של 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
לפני שיוצרים את האשכול, מוסיפים את הקטע
privateRegistryלקובץ התצורה של אשכול האדמין.כשממלאים את הקטע הזה:
כשמריצים את הפקודה
gkectl prepareלפני שיוצרים או משדרגים את האשכול, הפקודה מחלצת את קובצי האימג' מקובץ ה-tar שצוין בשדהbundlePathבקובץ התצורה של אשכול האדמין, ומעבירה את קובצי האימג' לשרת הרישום הפרטי.במהלך היצירה או השדרוג של האשכול, קובצי האימג' של המערכת נשלפים משרת המרשם הפרטי.
אם הרשת שלכם נמצאת מאחורי שרת proxy, מלאו את הקטע
proxy.
Terraform
- כדי למלא את קובץ התצורה של אשכול האדמין, פועלים לפי השלבים בכרטיסייה Terraform במאמר יצירת אשכול אדמין.
מוסיפים את הטקסט הבא לקובץ התצורה של אשכול האדמין:
private_registry_config { address = "ADDRESS" ca_cert = "CA_CERT" }מחליפים את מה שכתוב בשדות הבאים:
ADDRESS: כתובת ה-IP או ה-FQDN (שם דומיין שמוגדר במלואו) של המכונה שמריצה את המרשם הפרטי.
CA_CERT: נתוני אישור ה-CA של המפתח הציבורי, אבל כל השורות החדשות מוחלפות במחרוזת\n.
מריצים את הפקודה הבאה כדי להחליף שורות חדשות ב-
\n:awk 'ORS="\\n" {print}' PUBLIC_KEY_PATHמחליפים את
PUBLIC_KEY_PATHבנתיב למפתח הציבורי.מעתיקים את הפלט של הפקודה הקודמת ומדביקים אותו במשתנה של ה-placeholder
CA_CERT.
אם הרשת שלכם נמצאת מאחורי שרת 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 ונשלחת ישירות ליעד.
ממשיכים לפי השלבים בכרטיסייה Terraform במאמר יצירת אשכול אדמין כדי לאמת את קובץ התצורה והתוכנית של Terraform, ואז יוצרים את אשכול ה-bootstrap.
כשמריצים את הפקודה
gkectl register bootstrap, הכליgkectlמבקש להזין את שם המשתמש ואז את הסיסמה של המרשם הפרטי.
במהלך יצירת האשכול, קובצי האימג' של המערכת נשלפים משרת המרשם הפרטי.
מגבלות על אשכולות מתקדמים ועל החבילה המלאה
יש שתי חבילות זמינות של Google Distributed Cloud: מלאה ורגילה. כדי לדעת איזו חבילה נמצאת בתחנת העבודה של האדמין, בודקים את השדה bundlePath בקובץ התצורה של אשכול האדמין. אם שם הקובץ מסתיים ב--full, החבילה המלאה נמצאת בתחנת העבודה של האדמין. אם שם הקובץ לא מסתיים ב--full, החבילה הרגילה נמצאת בתחנת העבודה של האדמין.
אם יצרתם את תחנת הניהול באמצעות הפקודה gkeadm, הפקודה יוצרת את ה-VM של תחנת הניהול עם החבילה המלאה, ומגדירה את השדה bundlePath בקובץ התצורה של אשכול הניהול.
אם מפעילים את advanced cluster, יש מגבלות על השימוש בחבילה המלאה עם מאגר פרטי, כפי שמתואר בהמשך:
גרסה 1.31: החבילה המלאה לא נתמכת עם מרשם פרטי. כדי להשתמש במרשם פרטי באשכול מתקדם:
- מורידים את החבילה בגודל הרגיל לתחנת העבודה של האדמין.
- מעדכנים את שם הקובץ בשדה
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, כמו שמוסבר בשלבים הבאים:- מתחברים לצומת ובודקים את תוכן הקובץ
/etc/containerd/config.toml. בודקים את השדה
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"] ...אם מאגר ה-mirror של המרשם מופיע בשדה
endpoint, הצומת שולף תמונות ממאגר ה-mirror של המרשם ולא מ-Artifact Registry.
- מתחברים לצומת ובודקים את תוכן הקובץ