הגדרת אשכול לניהול על ידי GKE On-Prem API

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

רישום אשכול הוא תהליך נפרד מרישום אשכול ל-fleet. כל האשכולות של Google Distributed Cloud נרשמים באופן אוטומטי לפרויקט מארח של Fleet בזמן היצירה. במסוף Google Cloud , אשכולות רשומים שמנוהלים על ידי GKE On-Prem API מופיעים כ-VMware בעמודה Type, ואשכולות לא רשומים מופיעים כ-External.

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

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

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

  1. במסוף, נכנסים לדף אשכולות GKE.
    כניסה לאשכולות GKE
  2. בוחרים את הפרויקט Google Cloud .
    • אם הערך VMware מופיע בעמודה Type, האשכול מנוהל על ידי GKE On-Prem API.
    • אם בעמודה Type מופיע הערך External, האשכול לא מנוהל על ידי GKE On-Prem API.

דרישות

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

  • אשכולות אדמין חייבים להיות בגרסה 1.13 ואילך.

  • אם אתם לא Project Owner, אתם צריכים לקבל לפחות את התפקיד roles/gkeonprem.admin בניהול הזהויות והרשאות הגישה (IAM) בפרויקט. במאמר תפקידים ב-GKE on-prem שבמסמכי התיעוד של IAM מפורטות ההרשאות שכלולות בתפקיד הזה.

לפני שמתחילים

  1. אם צריך, מגדירים את ה-CLI של gcloud.

    1. אם אתם צריכים להתקין את ה-CLI של gcloud, תוכלו להיעזר במסמכי התיעוד של ה-CLI של gcloud.

    2. מעדכנים את רכיבי ה-CLI של gcloud, אם צריך:

      gcloud components update

  2. כדי להפעיל את GKE On-Prem API ולהשתמש בו:

    1. מפעילים את ה-API בפרויקט:

      gcloud services enable \
    --project PROJECT_ID \
    gkeonprem.googleapis.com

      מחליפים את PROJECT_ID במזהה הפרויקט המארח של ה-fleet. זהו מזהה הפרויקט שהוגדר בקטע gkeconnect בקובץ התצורה של אשכול האדמין או בקובץ התצורה של אשכול המשתמש.

      אם מופיעה השגיאה PERMISSION_DENIED, צריך לבדוק שוב את מזהה הפרויקט שהזנתם. אם מזהה הפרויקט נכון, מריצים את הפקודה gcloud auth login כדי להיכנס ל-Google Cloud CLI באמצעות החשבון שיש לו גישה לפרויקט.

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

      gcloud container vmware clusters query-version-config \
    --project=PROJECT_ID \
    --location=REGION

      מחליפים את REGION ב-us-west1 או באזור נתמך אחר.

  3. אם הארגון שלכם הגדיר רשימת היתרים שמאפשרת לתנועה מ-Google APIs ומכתובות אחרות לעבור דרך שרת ה-proxy, הוסיפו את הכתובות הבאות לרשימת ההיתרים:

    • gkeonprem.googleapis.com
    • gkeonprem.mtls.googleapis.com

    אלה שמות השירותים של GKE On-Prem API.

רישום אשכול משתמשים

‫CLI של gcloud

  1. מציגים את החברויות ב-Fleet של האשכולות הרשומים:

    gcloud container fleet memberships list \
    --project=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט המארח של ה-fleet.

    שימו לב לאזור שבו נמצא אשכול האדמין שמנהל את אשכול המשתמש, כי תצטרכו אותו בשלב הבא.

  2. רושמים את האשכול ב-GKE On-Prem API:

    gcloud container vmware clusters enroll USER_CLUSTER_NAME \
    --project=<var>PROJECT_ID</var> \
    --admin-cluster-membership=projects/PROJECT_ID/locations/MEMBERSHIP_REGION/memberships/ADMIN_CLUSTER_NAME \
    --location=REGION

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

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

    • ‫PROJECT_ID: מזהה הפרויקט המארח של ה-Fleet.

    • ‫MEMBERSHIP_REGION: האזור שבו נמצא אשכול האדמין שמנהל את אשכול המשתמש. המיקום יכול להיות global או אזור של Google Cloud .

    • ‫ADMIN_CLUSTER_NAME: השם של אשכול האדמין שמנהל את אשכול המשתמש.

      השדות ADMIN_CLUSTER_NAME,‏ MEMBERSHIP_REGION ו-PROJECT_ID יוצרים את שם האשכול שצוין במלואו לדגל --admin-cluster-membership.

    • ‫REGION: האזור Google Cloud שבו ה-GKE On-Prem API פועל ומאחסן את המטא-נתונים של האשכול. צריך לציין את us-west1 או אזור נתמך אחר. אי אפשר לשנות את האזור אחרי שרושמים את האשכול.

gkectl

מבצעים את השלבים הבאים בתחנת העבודה של האדמין.

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

    gkeOnPremAPI:
  enabled:true
  location:REGION

    מחליפים את REGION באזור Google Cloud שבו GKE On-Prem API פועל ומאחסן את המטא-נתונים של האשכול. מציינים את us-west1 או אזור נתמך אחר. אי אפשר לשנות את האזור אחרי שרושמים את האשכול.

  2. מעדכנים את האשכול:

    gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

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

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

    • ‫USER_CLUSTER_CONFIG_FILE: הנתיב של קובץ התצורה של אשכול המשתמש.

רישום של אשכול אדמין

‫CLI של gcloud

  1. מציגים את החברויות ב-Fleet של האשכולות הרשומים:

    gcloud container fleet memberships list \
    --project=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט המארח של ה-fleet.

    שימו לב לאזור שבו נמצא אשכול האדמין, כי תצטרכו אותו בשלב הבא.

  2. רושמים את אשכול האדמין ב-GKE On-Prem API:

    gcloud container vmware admin-clusters enroll ADMIN_CLUSTER_NAME \
    --project=PROJECT_ID \
    --admin-cluster-membership=projects/PROJECT_ID/locations/MEMBERSHIP_REGION/memberships/ADMIN_CLUSTER_NAME \
    --location=REGION

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

  • ‫ADMIN_CLUSTER_NAME: השם של אשכול האדמין שרוצים לרשום.

  • ‫PROJECT_ID מזהה הפרויקט המארח של ה-fleet.

  • ‫MEMBERSHIP_REGION: האזור שבו נמצא אשכול האדמין. המיקום יכול להיות global או אזור Google Cloud .

    הערכים ADMIN_CLUSTER_NAME,‏ MEMBERSHIP_REGION ו-PROJECT_ID יוצרים את השם המלא של האשכול לדגל --admin-cluster-membership.

  • ‫REGION: האזור ב- Google Cloud שבו GKE On-Prem API פועל ומאחסן את המטא-נתונים של האשכול. צריך לציין את us-west1 או אזור נתמך אחר. מומלץ להשתמש באותו אזור שמוגדר ב-stackdriver.clusterLocation בקובץ התצורה של אשכול האדמין. אי אפשר לשנות את האזור אחרי שרושמים את האשכול.

gkectl

מבצעים את השלבים הבאים בתחנת העבודה של האדמין.

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

    gkeOnPremAPI:
  enabled:true
  location:REGION

    מחליפים את REGION באזור Google Cloud שבו GKE On-Prem API פועל ומאחסן את המטא-נתונים של האשכול. מציינים את us-west1 או אזור נתמך אחר. מומלץ להשתמש באותו אזור שמוגדר ב-stackdriver.clusterLocation. אי אפשר לשנות את האזור אחרי שרושמים את האשכול.

  2. מעדכנים את האשכול:

    gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

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

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

    • ‫ADMIN_CLUSTER_CONFIG_FILE: הנתיב של קובץ התצורה של אשכול האדמין.

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

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

אשכול משתמשים

  • כדי לתאר אשכול משתמשים:
gcloud container vmware clusters describe USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION
  • כדי להציג רשימה של אשכולות המשתמשים:
gcloud container vmware clusters list \
  --project=PROJECT_ID \
  --location=-

כשמגדירים את --location=-, המשמעות היא שכל האשכולות בכל האזורים יופיעו ברשימה. אם אתם צריכים לצמצם את הרשימה, הגדירו את --location לאזור שציינתם כששייכתם את האשכול.

אשכול אדמין

  • כדי לתאר אשכול אדמין:
gcloud container vmware admin-clusters describe ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION
  • כדי להציג את רשימת אשכולות הניהול:
gcloud container vmware admin-clusters list \
  --project=PROJECT_ID \
  --location=-

כשמגדירים את --location=-, המשמעות היא שכל האשכולות בכל האזורים יופיעו ברשימה. אם אתם צריכים לצמצם את הרשימה, הגדירו את --location לאזור שציינתם כששייכתם את האשכול.

התחברות לאשכול

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