ניהול אשכולות ממסוף Google Cloud

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

חברי הצי והמסוף

כל אשכולות התוכנה של Google Distributed Cloud ל-VMware חייבים להיות חברים בfleet – דרך אחידה להצגה ולניהול של כמה אשכולות ועומסי העבודה שלהם. כל קבוצת אשכולות משויכת לפרויקט מארח של קבוצת אשכולות.

בתוכנת Google Distributed Cloud ל-VMware בלבד, אשכול אדמין רשום ל-fleet בזמן היצירה על ידי ציון הפרויקט המארח של ה-fleet בקטע gkeConnect של קובץ התצורה של האשכול. תוכנת Google Distributed Cloud software only for VMware משתמשת במידע הזה כדי לרשום את האשכול לפרויקט ה-fleet שצוין. אם הרישום נכשל, אפשר לנסות שוב על ידי הפעלת gkectl update credentials register.

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

בתוכנת Google Distributed Cloud ל-VMware בלבד, אשכול משתמש רשום ל-fleet בזמן היצירה:

  • כשיוצרים אשכול משתמשים באמצעות gkectl, מציינים את הפרויקט המארח של ה-Fleet בקטע gkeConnect של קובץ התצורה של האשכול. תוכנת Google Distributed Cloud ל-VMware בלבד משתמשת במידע הזה כדי לרשום את האשכול לפרויקט ה-fleet שצוין.

  • כשיוצרים אשכול משתמש באמצעות כלי רגיל (המסוף, Google Cloud CLI או Terraform), האשכול הופך באופן אוטומטי לחבר ב-fleet בפרויקט שציינתם.

חברים ב-Fleet מחוץ ל- Google Cloud , כמו תוכנת Google Distributed Cloud ל-VMware בלבד, מוצגים במסוף בפרויקט המארח של ה-Fleet, יחד עם אשכולות אחרים של Fleet כמו GKE ב- Google Cloud. היקף הניהול של תוכנת Google Distributed Cloud ל-VMware בלבד מהמסוף תלוי בגורמים הבאים:

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

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

הצגת אשכולות רשומים

כל האשכולות ב-fleet מוצגים בדף Google Kubernetes Engine clusters overview במסוף. כך תוכלו לראות סקירה כללית של כל המכשירים בארגון, ובתוכנת Google Distributed Cloud ל-VMware בלבד, תוכלו לראות אילו אשכולות מנוהלים על ידי GKE On-Prem API.

כדי לראות את האשכולות ב-Fleet:

  1. נכנסים לדף Google Kubernetes Engine clusters overview במסוף.

    כניסה לאשכולות GKE

  2. בוחרים את הפרויקט Google Cloud .

    • אם בעמודה Type מופיע הערך vm Google Distributed Cloud, האשכול מנוהל על ידי GKE On-Prem API.

    • אם בעמודה Type מופיע הערך External, האשכול לא מנוהל על ידי GKE On-Prem API.

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

מגדירים אימות

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

  • זהות ב-Google: האפשרות הזו מאפשרת למשתמשים להתחבר באמצעות הזהות שלהם ב-Google Cloud , שהיא כתובת האימייל שמשויכת לחשבוןGoogle Cloud . כדאי להשתמש באפשרות הזו אם למשתמשים כבר יש גישה אלGoogle Cloud באמצעות Google Identity שלהם. אם יצרתם את האשכול במסוף, אתם יכולים להתחבר לאשכול באמצעות זהות Google שלכם, אבל תצטרכו להגדיר אימות למשתמשים אחרים.

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

  • ‫OpenID Connect (OIDC): האפשרות הזו מאפשרת למשתמשים להתחבר לאשכולות מהמסוף באמצעות הזהות שלהם מספק זהויות OIDC של צד שלישי, כמו Okta או Microsoft AD FS. כדאי להשתמש באפשרות הזו אם למשתמשים שלכם כבר יש שמות משתמש, סיסמאות וחברויות בקבוצות אבטחה מהספק. במדריכים הבאים מוסבר איך להגדיר אימות OIDC של צד שלישי לאשכולות:

  • טוקן למוכ"ז: אם הפתרונות הקודמים ש-Google מספקת לא מתאימים לארגון שלכם, אתם יכולים להגדיר אימות באמצעות חשבון שירות של Kubernetes ולהשתמש בטוקן למוכ"ז שלו כדי להתחבר. פרטים נוספים זמינים במאמר הגדרה באמצעות טוקן למוכ"ז.

מתן התפקידים הנדרשים

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

  • כדי לאפשר למשתמשים לגשת למסוף, צריך להקצות להם לפחות את התפקידים הבאים:

    • roles/container.viewer. התפקיד הזה מאפשר למשתמשים לראות את הדף GKE Clusters ומשאבים אחרים של קונטיינרים במסוף. במאמר תפקידים ב-Kubernetes Engine שבמסמכי התיעוד של IAM מפורטות ההרשאות שכלולות בתפקיד הזה, ומוסבר איך להקצות תפקיד עם הרשאות קריאה/כתיבה.

    • ‫roles/gkehub.viewer. התפקיד הזה מאפשר למשתמשים לראות אשכולות מחוץ ל-Google Cloud במסוף. לפרטים על ההרשאות שכלולות בתפקיד הזה, או כדי להקצות תפקיד עם הרשאות קריאה/כתיבה, קראו את המאמר תפקידים ב-GKE Hub במסמכי התיעוד של IAM.

  • כדי לאפשר למשתמשים לנהל את מחזור החיים של האשכול במסוף, צריך להקצות את התפקיד roles/gkeonprem.admin ב-IAM. התפקיד roles/gkeonprem.admin נותן למשתמשים הרשאת אדמין ל-GKE On-Prem API, שבו המסוף משתמש כדי לנהל את מחזור החיים של האשכול. במסמכי התיעוד של IAM, במאמר תפקידים ב-GKE on-prem, מפורטות ההרשאות שכלולות בתפקיד הזה.

הפקודות הבאות מראות איך להקצות את התפקידים המינימליים שנדרשים כדי לנהל את מחזור החיים של האשכול במסוף:

gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
    --member=MEMBER \
    --role=roles/container.viewer

gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
    --member=MEMBER \
    --role=roles/gkehub.viewer

gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
    --member=MEMBER \
    --role=roles/gkeonprem.admin

כאשר:

  • ‫FLEET_HOST_PROJECT_ID הוא הפרויקט המארח של ה-Fleet. באשכולות שנוצרו באמצעות gkectl, זה הפרויקט שהגדרתם בקטע gkeConnect של קובץ התצורה של אשכול המשתמש. באשכולות שנוצרו במסוף, זה הפרויקט שבחרתם כשהאשכול נוצר.

  • ‫MEMBER היא כתובת האימייל של המשתמש בפורמט user:emailID, לדוגמה: user:alice@example.com

הפעלת ניהול מחזור החיים של אשכולות במסוף

אשכולות של משתמשים שנוצרו באמצעות כלים רגילים (המסוף, ה-CLI של gcloud או Terraform) רשומים באופן אוטומטי ב-GKE On-Prem API, ומאפשרים לבצע משימות של ניהול מחזור החיים של האשכולות במסוף. כדי להפעיל את התכונה הזו באשכולות של משתמשים שנוצרו באמצעות gkectl, צריך לפעול לפי השלבים שמפורטים במאמר הגדרת אשכול של משתמשים לניהול באמצעות GKE On-Prem API. כשהניהול של מחזור החיים של האשכול מופעל, אפשר לבצע את המשימות הבאות מהמסוף:

הגדרת אימות זהות של Google

כדי לאפשר למשתמשים להתחבר לאשכול באמצעות Google Identity שלהם, צריך להגדיר את הפרטים הבאים:

הגדרת הרשאת RBAC

שרת ה-API של Kubernetes בכל אשכול צריך להיות מסוגל לאשר בקשות שמגיעות מהמסוף. כדי להגדיר הרשאה, צריך להגדיר כללי מדיניות של בקרת גישה מבוססת-תפקידים (RBAC) ב-Kubernetes בכל אשכול.

אם השתמשתם בכלי רגיל כדי ליצור את אשכול המשתמשים, יכול להיות שכבר הוקצו לכם כללי המדיניות המתאימים של RBAC, שמעניקים לכם הרשאת אדמין מלאה לאשכול. ‫GKE On-Prem API מוסיף את חשבון Google שלכם באופן אוטומטי כאדמין במקרים הבאים:

  • יצרתם את אשכול המשתמשים במסוף.

  • יצרתם את אשכול המשתמש באמצעות ה-CLI של gcloud, וחשבון Google שלכם צוין בדגל --admin-users בפקודה ליצירת האשכול.

  • יצרתם את אשכול המשתמש באמצעות Terraform וחשבון Google שלכם צוין בשדה authorization.admin_users.username.

אשכולות של משתמשים שנוצרו באמצעות gkectl לא מעניקים לכם את כללי המדיניות של RBAC לניהול האשכול באמצעות המסוף. תצטרכו להוסיף את עצמכם אחרי שהאשכול ייווצר. לא משנה באיזה כלי השתמשתם כדי ליצור את האשכול, אתם יכולים להוסיף משתמשים אחרים כאדמינים אחרי שהאשכול נוצר.

אתם יכולים להשתמש בכל אחת מהדרכים הבאות כדי לתת הרשאת אדמין לאשכול. יש שתי פקודות gcloud שונות.

  • צריך להריץ את הפקודה gcloud ... generate-gateway-rbac בתחנת העבודה של האדמין, כי הפקודה דורשת גישה ל-kubeconfig ולהקשר של האשכול (שבדרך כלל נמצאים רק בתחנת העבודה של האדמין). הפקודה generate-gateway-rbac מאפשרת להתאים אישית את כללי המדיניות של RBAC, אבל כתובות האימייל של המשתמשים לא יוצגו כאדמינים בקטע Cluster Details במסוף.

  • אפשר להריץ את הפקודה gcloud ... update בתחנת העבודה של האדמין או בכל מחשב שיש לו גישה ל-GKE On-Prem API.

generate-gateway-rbac

  1. מתחברים לתחנת עבודה אדמין.

  2. מריצים את הפקודה הבאה כדי לעדכן את הרכיבים:

    gcloud components update
    
  3. יוצרים את כללי המדיניות של RBAC ומחילים אותם על האשכול בשביל המשתמשים וחשבונות השירות:

    gcloud container fleet memberships generate-gateway-rbac  \
        --membership=MEMBERSHIP_NAME \
        --role=ROLE \
        --users=USERS \
        --project=FLEET_HOST_PROJECT_ID \
        --kubeconfig=KUBECONFIG_PATH \
        --context=KUBECONFIG_CONTEXT \
        --apply
    

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

    • ‫MEMBERSHIP_NAME: השם שמשמש לייצוג ייחודי של האשכול ב-fleet שלו. רק בתוכנת Google Distributed Cloud ל-VMware, שם המינוי ושם האשכול זהים.
    • ‫ROLE: התפקיד ב-Kubernetes שרוצים לתת למשתמשים באשכול. כדי לתת למשתמשים גישה מלאה לכל משאב באשכול בכל מרחבי השמות, מציינים את הערך clusterrole/cluster-admin. כדי לתת גישה לקריאה בלבד, מציינים את הערך clusterrole/view. אתם יכולים גם ליצור תפקיד בהתאמה אישית, לדוגמה: role/mynamespace/namespace-reader. התפקיד בהתאמה אישית כבר צריך להיות קיים לפני שמריצים את הפקודה.
    • ‫USERS: כתובות האימייל של המשתמשים (חשבונות משתמשים או חשבונות שירות) שרוצים לתת להם את ההרשאות, כרשימה מופרדת בפסיקים. לדוגמה: --users=foo@example.com,test-acct@test-project.iam.gserviceaccount.com.
    • ‫FLEET_HOST_PROJECT_ID: מזהה הפרויקט המארח של ה-Fleet.
    • ‫KUBECONFIG_PATH: הנתיב המקומי שבו מאוחסן קובץ ה-kubeconfig שמכיל רשומה של האשכול.
    • ‫KUBECONFIG_CONTEXT: ההקשר של האשכול כפי שהוא מופיע בקובץ kubeconfig. כדי לקבל את ההקשר הנוכחי משורת הפקודה, מריצים את הפקודה kubectl config current-context. בין שאתם משתמשים בהקשר הנוכחי ובין שלא, ודאו שהוא פועל לגישה לאשכול על ידי הפעלת פקודה פשוטה כמו:

      kubectl get namespaces \
        --kubeconfig=KUBECONFIG_PATH \
        --context=KUBECONFIG_CONTEXT

    אחרי שמריצים את הפקודה gcloud container fleet memberships generate-gateway-rbac, בסוף הפלט אמור להופיע משהו כמו הדוגמה הבאה, שקוצרה כדי שיהיה קל יותר לקרוא אותה:

    Validating input arguments.
    Specified Cluster Role is: clusterrole/cluster-admin
    Generated RBAC policy is:
    --------------------------------------------
    ...
    Applying the generate RBAC policy to cluster with kubeconfig: /usr/local/google/home/foo/.kube/config, context: kind-kind
    Writing RBAC policy for user: foo@example.com to cluster.
    Successfully applied the RBAC policy to cluster.
    

    זהו ההקשר לגישה לאשכול דרך שער Connect.

    למידע נוסף על הפקודה generate-gateway-rbac, קראו את מדריך העזר ל-CLI של gcloud.

update

  1. מריצים את הפקודה הבאה כדי לעדכן את הרכיבים:

    gcloud components update
    
  2. לכל משתמש שצריך להקצות לו את התפקיד clusterrole/cluster-admin, כוללים את הדגל --admin-users ומריצים את הפקודה הבאה. אי אפשר לציין ריבוי משתמשים בדגל אחד. חשוב לכלול את חשבון Google שלכם בפקודה, כי הפקודה מחליפה את רשימת ההרשאות במשתמשים שציינתם בפקודה.

    gcloud container vmware clusters update USER_CLUSTER_NAME \
      --admin-users YOUR_GOOGLE_ACCOUNT \
      --admin-users ADMIN_GOOGLE_ACCOUNT_1
    

בנוסף להקצאת התפקיד clusterrole/cluster-admin ב-Kubernetes, הפקודה מקצה את כללי המדיניות של RBAC שהמשתמשים צריכים כדי לגשת לאשכול דרך שער Connect.

המסוף

כדי להחיל את כללי המדיניות של RBAC על משתמשים, מבצעים את השלבים הבאים במסוף:

  1. נכנסים לדף Google Kubernetes Engine clusters overview במסוף.

    כניסה לאשכולות GKE

  2. בוחרים את הפרויקט ב- Google Cloud שבו נמצא אשכול המשתמשים.

  3. ברשימת האשכולות, לוחצים על שם האשכול כדי להציג את הפרטים שלו.

  4. בקטע הרשאה, לוחצים על לחצן העריכה של משתמשים עם הרשאת אדמין.

  5. בחלונית Edit authorization, מזינים את כתובת האימייל של המשתמש שרוצים להוסיף כאדמין של האשכול. כדי להוסיף עוד משתמשים עם הרשאת אדמין, לוחצים על הוספת משתמש עם הרשאת אדמין.

  6. כשמסיימים להוסיף משתמשים, לוחצים על שמירת השינויים.

מידע נוסף