יצירת קובצי תצורה מאשכול

במאמר הזה נסביר איך ליצור קבוצה של קובצי תצורה מאשכול קיים.

אחת הדרכים ליצור אשכול היא להשתמש בכלי שורת הפקודה gkectl. קודם יוצרים קבוצה של קובצי תצורה לאשכול. ואז מריצים אחת מהפקודות הבאות:

• ‫gkectl create admin כדי ליצור אשכול אדמין
• gkectl create cluster כדי ליצור אשכול משתמשים

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

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

אם אתם חושדים שקובצי התצורה המקוריים לא מסונכרנים עם האשכול, או אם אין לכם קובצי תצורה, אתם יכולים להשתמש בפקודה gkectl get-config כדי ליצור קבוצה חדשה של קובצי תצורה שמייצגים במדויק את המצב הנוכחי של האשכול.

אתם יכולים להשתמש ב-gkectl get-config עם:

• אשכולות של משתמשים
• אשכולות אדמין

הערה: gkectl get-config לא תומך באשכולות שמשתמשים בדומיינים של טופולוגיה. המגבלה הזו חלה על אשכול אדמין שמוגדר בו infraConfigFilePath בקובץ התצורה, ועל כל אשכולות המשתמשים שאשכול האדמין מנהל. אם תריצו את הפקודה gkectl get-config באשכולות האלה, היא תיכשל. במקום זאת, צריך לשמור את קובצי התצורה שמשמשים ליצירה ולעדכון של האשכולות האלה, כולל קובץ התצורה של תשתית vSphere וקובצי בלוק ה-IP.

יצירת קובצי תצורה

כדי ליצור קבוצה חדשה של קובצי תצורה לאשכול משתמש:

gkectl get-config cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --cluster-name USER_CLUSTER_NAME

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

• ‫ADMIN_CLUSTER_KUBECONFIG: הנתיב לקובץ kubeconfig של אשכול האדמין

• ‫USER_CLUSTER_NAME: השם של אשכול המשתמשים

כדי ליצור קבוצה חדשה של קובצי תצורה לאשכול אדמין:

gkectl get-config admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --bundle-path BUNDLE

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

• ‫ADMIN_CLUSTER_KUBECONFIG: קובץ ה-kubeconfig של אשכול האדמין

• ‫BUNDLE: הנתיב של קובץ החבילה של Google Distributed Cloud. קובץ החבילה נמצא בתחנת העבודה של האדמין, בדרך כלל בנתיב /var/lib/gke/bundles/gke-onprem-vsphere-VERSION-full.tgz. אם עדיין אין לכם קובץ חבילה, אתם יכולים להוריד אחד.

כברירת מחדל, קובצי התצורה שנוצרים נכתבים בספריית משנה של הספרייה הנוכחית. באשכול משתמש, ספריית הפלט נקראת user-cluster-config-output. באשכול אדמין, ספריית הפלט נקראת admin-cluster-config-output.

אם אתם מעדיפים שהקבצים שנוצרו יהיו בספרייה אחרת, אתם יכולים להשתמש בפרמטר --output-dir כדי לציין את הנתיב של ספריית הפלט. לדוגמה:

gkectl get-config cluster --kubeconfig my-kubeconfig \
    --cluster-name my-cluster \
    --output-dir /home/me/configuration/generated-files

אם כבר יש קבצים בספריית הפלט שמוגדרת כברירת מחדל או בספריית פלט שצוינה, צריך לכלול את הדגל --force כדי שהקבצים החדשים שנוצרו יחליפו את הקבצים הקיימים. אחרת, הפקודה תיכשל. לדוגמה:

gkectl get-config cluster --kubeconfig my-kubeconfig \
    --cluster-name my-cluster \
    --output-dir /home/me/configuration/generated-files
    --force

קבצים שנוצרו לאשכול אדמין

שם קובץ	תיאור
admin-cluster.yaml	קובץ תצורה של אשכול אדמין נוצר תמיד
admin-cluster-creds.yaml	קובץ פרטי הכניסה של האשכול נוצר תמיד
component-access-key.json	קובץ מפתח JSON של חשבון השירות לגישה לרכיבים נוצר תמיד
vcenter-ca-cert.pem	אישור בסיס לשרת vCenter נוצר תמיד
admin-cluster-ipblock.yaml	קובץ בלוק IP לצומתי אשכול נוצר אם צומתי האשכול משתמשים בכתובות IP סטטיות
connect-register-key.json	קובץ מפתח JSON של חשבון השירות לרישום ב-Connect נוצר תמיד
private-registry-ca.crt	אישור הבסיס (root) לשרת המרשם הפרטי נוצר אם האשכול משתמש במרשם פרטי
stackdriver-key.json	קובץ מפתח JSON של חשבון השירות למעקב אחרי רישום ביומן נוצר אם האשכול מוגדר לייצא יומנים ומדדים אל Cloud Logging ואל Cloud Monitoring (הקטע stackdriver בקובץ התצורה של האשכול)
audit-logging-key.json	קובץ מפתח JSON של חשבון השירות של יומן הביקורת נוצר אם האשכול משתמש ביומני הביקורת של Cloud

קבצים שנוצרו לאשכול משתמשים

שם קובץ	תיאור
user-cluster.yaml	קובץ תצורה של אשכול משתמש נוצר תמיד
user-cluster-creds.yaml	קובץ פרטי הכניסה של האשכול נוצר אם האשכול לא משתמש בפרטי כניסה מוכנים
vcenter-ca-cert.pem	אישור בסיס לשרת vCenter נוצר תמיד
user-cluster-ipblock.yaml	קובץ בלוקים של כתובות IP לצומתי אשכול נוצר אם צומתי האשכול משתמשים בכתובות IP סטטיות
private-registry-ca.crt	אישור הבסיס לשרת המרשם הפרטי נוצר אם האשכול משתמש במרשם פרטי
component-access-key.json	קובץ מפתח JSON של חשבון השירות עם גישה לרכיבים נוצר אם האשכול לא משתמש במרשם פרטי
connect-register-key.json	קובץ מפתח JSON של חשבון השירות לרישום ב-Connect נוצר תמיד
stackdriver-key.json	קובץ מפתח JSON של חשבון השירות למעקב אחרי רישום ביומן נוצר אם האשכול מוגדר לייצא יומנים ומדדים אל Cloud Logging ואל Cloud Monitoring (הקטע stackdriver בקובץ התצורה של האשכול)
audit-logging-key.json	קובץ מפתח JSON של חשבון השירות של יומן הביקורת נוצר אם האשכול משתמש ביומני הביקורת של Cloud
usage-metering-key.json	קובץ מפתח JSON של חשבון השירות למדידת השימוש נוצר אם האשכול מאחסן נתוני שימוש במערך נתונים ב-BigQuery
secrets.yaml	קובץ תצורה של סודות נוצר אם האשכול משתמש בפרטי כניסה מוכנים כדי שהקובץ הזה ייווצר, צריך לכלול את הדגל --export-secrets-config בפקודה gkectl get-config cluster.
sni-cert.pem	אישור נוסף להצגה לשרת ה-API של Kubernetes נוצר אם האשכול מוגדר להשתמש ב- Server Name Indication (SNI)
sni-key.json	קובץ מפתח פרטי לאישור הנוסף להצגת מודעות נוצר אם האשכול מוגדר לשימוש ב-SNI