יצירה וניהול של אשכולות

המסוף

1. נכנסים לדף Clusters במסוף Google Cloud .

   מעבר אל Clusters

2. לוחצים על יצירת אשכול.

3. בדף Create a cluster, לוחצים על הכרטיסייה On-premises.

4. לצד האפשרות Distributed Cloud Edge, לוחצים על Configure.

5. בדף Cluster basics (יסודות האשכול), מספקים את הפרטים הבאים:

   • ‫Name: שם ייחודי שמזהה את האשכול הזה. השם הזה צריך להיות תואם ל-RFC 1213, והוא יכול לכלול רק תווים אלפאנומריים באותיות קטנות ומקפים (-). הוא חייב להתחיל ולהסתיים בתו אלפאנומרי.
   • מיקום: Google Cloud האזור שבו רוצים ליצור את האשכול הזה.
   • Default max pods per node (ברירת מחדל של מספר הפודים המקסימלי לכל צומת): המספר המקסימלי הרצוי של פודים של Kubernetes להפעלה בכל צומת באשכול הזה.
   • תוויות: לוחצים על addהוספת תווית כדי להוסיף תווית אחת או יותר לאשכול הזה.

6. בחלונית הניווט הימנית, לוחצים על Networking (רשת).

7. בדף Networking, מספקים את הפרטים הבאים:

   • טווח כתובות ברירת המחדל של Pod באשכול: בלוק ה-CIDR הרצוי של IPv4 עבור Pods של Kubernetes שפועלים באשכול הזה.
   • טווח כתובות שירות: בלוק ה-CIDR הרצוי של IPv4 עבור שירותי Kubernetes שפועלים באשכול הזה.

   מידע נוסף זמין במאמר בנושא הקצאת כתובות של רשתות שירותים ו-Distributed Cloud Pod מבוזר.

8. בחלונית הניווט הימנית, לוחצים על הרשאה.

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

10. בחלונית הניווט הימנית, לוחצים על מדיניות תחזוקה.

11. בדף Maintenance policy, מספקים את הפרטים הבאים:

    • הפעלת חלון זמן לתחזוקה: מסמנים את התיבה הזו כדי להגדיר חלון זמן לתחזוקה לאשכול. כדי למנוע זמן השבתה לא צפוי שנגרם מעדכוני תוכנה של Distributed Cloud, מומלץ מאוד להגדיר תמיד חלון זמן לתחזוקה לכל אשכול Distributed Cloud שיוצרים. מידע נוסף זמין במאמר בנושא הסבר על עדכוני תוכנה וחלונות תחזוקה.
    • שעת התחלה: התאריך והשעה הרצויים שבהם מתחיל חלון התחזוקה של האשכול הזה.
    • תאריך סיום: התאריך והשעה הרצויים שבהם חלון התחזוקה של האשכול הזה מסתיים.
    • RRule: התדירות של חלון זמן לתחזוקה בפורמט FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
      • הערך של FREQ יכול להיות DAILY או WEEKLY.
      • ‫BYDAY: רשימה מופרדת בפסיקים של ימים שבהם יכולה להתבצע תחזוקה אם הערך של FREQ הוא WEEKLY. אם לא מציינים את הפרמטר BYDAY ‎, Google בוחרת את היום בשבוע בשבילכם.
      • אם מגדירים את FREQ ל-DAILY, חלונות הזמן לתחזוקה מתרחשים כל יום בשעות שצוינו.

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

    • כדי להקצות מאגר צמתים קיים לאשכול הזה, בקטע Node pools (מאגרי צמתים) בתפריט הניווט הימני, בוחרים את מאגר הצמתים הקיים ומוודאים שהגדרת מאגר הצמתים בדף Node pool details (פרטי מאגר הצמתים) נכונה.
    • כדי ליצור מאגר צמתים חדש להקצאה לאשכול הזה, לוחצים על הוספת מאגר צמתים ומזינים את הפרטים הבאים בדף פרטי מאגר הצמתים:
      add_box
      • שם מאגר הצמתים: שם ייחודי שמזהה את מאגר הצמתים הזה.
      • תוויות של מאגר צמתים: לוחצים על addהוספת תווית כדי להוסיף תווית אחת או יותר למאגר הצמתים הזה.
      • העדפה של צמתי Worker: בוחרים את הצמתים של Distributed Cloud להקצאה למאגר הצמתים הזה.

13. כדי ליצור את אשכול Distributed Cloud, לוחצים על Create.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters create:

gcloud edge-cloud container clusters create CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --fleet-project=FLEET_PROJECT_ID \
    --cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
    --services-ipv4-cidr=SERVICE_IPV4_CIDR_BLOCK \
    --default-max-pods-per-node=MAX_PODS_PER_NODE \
    --release-channel RELEASE_CHANNEL \
    --control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
    --control-plane-node-location=CONTROL_PLANE_LOCATION \
    --control-plane-node-count=CONTROL_PLANE_NODE_COUNT \
    --control-plane-machine-filter=CONTROL_PLANE_NODE_FILTER \
    --control-plane-shared-deployment-policy=CONTROL_PLANE_NODE_SHARING \
    --external-lb-ipv4-address-pools=IPV4_DATA_PLANE_ADDRESSES \
    --version SOFTWARE_VERSION

 

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

• ‫CLUSTER_ID: שם ייחודי שמזהה את האשכול הזה. השם צריך להיות תואם ל-RFC 1213, ולהכיל רק תווים אלפאנומריים באותיות קטנות ומקפים (-). הוא צריך להתחיל ולהסתיים בתו אלפאנומרי.
• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: האזור Google Cloud שבו נוצר האשכול ושבו מוקצה מישור הבקרה של Kubernetes לאשכול.
• ‫FLEET_PROJECT_ID: המזהה של פרויקט המארח של ה-Fleet שבו האשכול רשום. אם לא מציינים את הדגל הזה, פרויקט האשכול של Distributed Cloud משמש כפרויקט המארח של ה-Fleet.
• ‫CLUSTER_IPV4_CIDR_BLOCK: חסימת ה-CIDR של IPv4 הרצויה עבור Kubernetes Pods שפועלים באשכול הזה.
• ‫SERVICE_IPV4_CIDR_BLOCK: בלוק ה-CIDR של IPv4 הרצוי לשירותי Kubernetes שפועלים באשכול הזה.
• ‫MAX_PODS_PER_NODE (אופציונלי): המספר המקסימלי הרצוי של Kubernetes Pods להפעלה בכל צומת באשכול הזה.
• ‫RELEASE_CHANNEL: (אופציונלי): מציין את ערוץ ההפצה של גרסת התוכנה של Distributed Cloud שרוצים שהאשכול הזה יפעל. הערכים התקינים הם REGULAR (הפעלה של שדרוגים אוטומטיים של אשכולות) ו-NONE (השבתה של שדרוגים אוטומטיים של אשכולות). אם לא מציינים ערך, ברירת המחדל היא REGULAR.

• ‫CONTROL_PLANE_KMS_KEY (אופציונלי): הנתיב המלא למפתח Cloud KMS שבו רוצים להשתמש עם צומת מישור הבקרה של האשכול הזה. לדוגמה:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  הדגל הזה רלוונטי רק אם שילבתם את Distributed Cloud עם Cloud Key Management Service, כמו שמתואר במאמר הפעלת תמיכה במפתחות הצפנה בניהול הלקוח (CMEK) לאחסון מקומי.

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

• ‫CONTROL_PLANE_LOCATION: הוראה ל-Distributed Cloud לפרוס את עומסי העבודה של מישור הבקרה עבור האשכול הזה באופן מקומי. הערך הוא השם של אזור היעד ב-Distributed Cloud.
• ‫CONTROL_PLANE_NODE_COUNT (אופציונלי): מציין את מספר הצמתים שבהם יופעלו עומסי העבודה של מישור הבקרה המקומי. הערכים החוקיים הם 3 לזמינות גבוהה ו-1 לפעולה רגילה. אם לא מציינים ערך, ברירת המחדל היא 3.
• ‫CONTROL_PLANE_NODE_FILTER (אופציונלי): מציין רשימה בפורמט regex של צמתים שמריצים את עומסי העבודה של מישור הבקרה המקומי. אם לא מציינים, Distributed Cloud בוחר את הצמתים באופן אוטומטי באקראי.
• ‫CONTROL_PLANE_NODE_SHARING: (אופציונלי) מציין אם עומסי עבודה של אפליקציות יכולים לפעול בצמתים שמריצים את עומסי העבודה של מישור הבקרה המקומי. הערכים החוקיים הם DISALLOWED ו-ALLOWED. אם לא מציינים ערך, ברירת המחדל היא DISALLOWED.
• ‫IPV4_DATA_PLANE_ADDRESSES: מציין רשימה מופרדת בפסיקים של כתובות IPv4, טווחי כתובות או רשתות משנה לתעבורת נתונים נכנסת (ingress) לשירותים שפועלים מאחורי איזון העומסים של Distributed Cloud כשהאשכול פועל במצב זמינות.
• ‫SOFTWARE_VERSION: מציין את גרסת התוכנה של Distributed Cloud שבה רוצים שהאשכול הזה יפעל בפורמט 1.X.Y, כאשר X היא גרסת המשנה ו-Y היא גרסת התיקון, לדוגמה 1.5.0. אם לא מציינים גרסה, ברירת המחדל היא גרסת התוכנה שמוגדרת בשרת, שבדרך כלל היא הגרסה העדכנית ביותר של Distributed Cloud. כדי לראות את גרסאות התוכנה שזמינות ליצירת אשכול, כולל גרסת ברירת המחדל של השרת, אפשר לעיין במאמר בנושא קבלת גרסאות התוכנה שזמינות לאשכול.

API

שולחים בקשת POST אל ה-method‏ projects.locations.clusters:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&requestId=REQUEST_ID&fleetId=FLEET_PROJECT_ID

{
  "labels": { LABELS,
  },
  "authorization": {
    "adminUsers": {
      "username": "USERNAME"
    }
  },
  "fleet": {
    "project": "FLEET_PROJECT_ID"
  },
  "networking": {
    "clusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
    "servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
      },
  "defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
  "releaseChannel": "RELEASE_CHANNEL",
  "controlPlaneEncryption": {
   "kmsKey": CONTROL_PLANE_KMS_KEY,
  },      
  "controlPlane": {
    "local": {
      "nodeLocation": "CONTROL_PLANE_LOCATION",
      "nodeCount": CONTROL_PLANE_NODE_COUNT,
      "machineFilter": "CONTROL_PLANE_NODE_FILTER",
      "sharedDeploymentPolicy": "CONTROL_PLANE_NODE_SHARING"
    }
  },
  "externalLoadBalancerIpv4AddressPools": [
    "IPV4_DATA_PLANE_ADDRESSES"
  ],
  "targetVersion": "SOFTWARE_VERSION",
}

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: האזור Google Cloud שבו נוצר אשכול היעד של Distributed Cloud.
• ‫CLUSTER_ID: שם ייחודי שמזהה את האשכול הזה. השם צריך להיות תואם ל-RFC 1213, ולהכיל רק תווים אלפאנומריים באותיות קטנות ומקפים (-). הוא צריך להתחיל ולהסתיים בתו אלפאנומרי.
• ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.
• ‫FLEET_PROJECT_ID: המזהה של פרויקט המארח של ה-Fleet שבו האשכול רשום. זה יכול להיות פרויקט נפרד או פרויקט Distributed Cloud שאליו האשכול הזה שייך (PROJECT_ID). חובה לרשום את האשכול ב-Fleet.
• ‫LABELS: רשימת תוויות להחלה על משאב האשכול הזה.
• ‫USERNAME: השם של חשבון המשתמש בפרויקט Google Cloud היעד שקיבל הרשאה לשנות משאבי אשכול.
• ‫CLUSTER_IPV4_CIDR_BLOCK: חסימת ה-CIDR של IPv4 הרצויה עבור Kubernetes Pods שפועלים באשכול הזה.
• ‫SERVICE_IPV4_CIDR_BLOCK: בלוק ה-CIDR של IPv4 הרצוי לשירותי Kubernetes שפועלים באשכול הזה.
• ‫MAX_PODS_PER_NODE: המספר המקסימלי הרצוי של פודים של Kubernetes להפעלה בכל צומת באשכול הזה.
• ‫RELEASE_CHANNEL: מציין את ערוץ ההפצה של גרסת התוכנה של Distributed Cloud שרוצים שהאשכול הזה יפעל בה. הערכים התקינים הם REGULAR ו-NONE. אם לא מציינים ערך, ברירת המחדל היא REGULAR.

• ‫CONTROL_PLANE_KMS_KEY (אופציונלי): הנתיב המלא למפתח Cloud KMS שבו רוצים להשתמש עם צומת מישור הבקרה של האשכול הזה. לדוגמה:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  הפרמטר הזה רלוונטי רק אם שילבתם את Distributed Cloud עם Cloud Key Management Service, כמו שמתואר במאמר בנושא הפעלת תמיכה במפתחות הצפנה בניהול הלקוח (CMEK) לאחסון מקומי.

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

• ‫CONTROL_PLANE_LOCATION: הוראה ל-Distributed Cloud לפרוס את עומסי העבודה של מישור הבקרה עבור האשכול הזה באופן מקומי. הערך הוא השם של אזור היעד ב-Distributed Cloud.
• ‫CONTROL_PLANE_NODE_COUNT: מציין את מספר הצמתים שבהם יופעלו עומסי העבודה של מישור הבקרה המקומי. הערכים האפשריים הם 3 לזמינות גבוהה ו-1 להפעלה רגילה.
• ‫CONTROL_PLANE_NODE_FILTER (אופציונלי): מציין רשימה בפורמט regex של צמתים שמריצים את עומסי העבודה של מישור הבקרה המקומי. אם לא מציינים, Distributed Cloud בוחר את הצמתים באופן אוטומטי באקראי.
• ‫CONTROL_PLANE_NODE_SHARING: מציין אם עומסי עבודה של אפליקציות יכולים לפעול בצמתים שמריצים את עומסי העבודה של מישור הבקרה המקומי. הערכים החוקיים הם DISALLOWED ו-ALLOWED. אם לא מציינים ערך, ברירת המחדל היא DISALLOWED.
• ‫IPV4_DATA_PLANE_ADDRESSES: מציין רשימה מופרדת בפסיקים של כתובות IPv4, טווחי כתובות או רשתות משנה לתעבורת נתונים נכנסת (ingress) לשירותים שפועלים מאחורי מאזן העומסים של Distributed Cloud באשכול של מישור בקרה מקומי. לא רלוונטי לאשכולות של מישור הבקרה ב-Cloud.
• ‫SOFTWARE_VERSION: מציין את גרסת התוכנה של Distributed Cloud שבה רוצים שהאשכול הזה יפעל בפורמט 1.X.Y, כאשר X היא גרסת המשנה ו-Y היא גרסת התיקון, לדוגמה 1.5.0. אם לא מציינים גרסה, ברירת המחדל היא גרסת התוכנה שמוגדרת בשרת, שבדרך כלל היא הגרסה העדכנית ביותר של Distributed Cloud. כדי לראות את גרסאות התוכנה שזמינות ליצירת אשכול, כולל גרסת ברירת המחדל של השרת, אפשר לעיין במאמר בנושא קבלת גרסאות התוכנה שזמינות לאשכול.

המסוף

1. נכנסים לדף Clusters במסוף Google Cloud .

   מעבר אל Clusters

2. בודקים את רשימת האשכולות.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters list:

gcloud edge-cloud container clusters list \
    --project=PROJECT_ID \
    --location=REGION

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: האזור Google Cloud שבו יצרתם את אשכול Distributed Cloud.

API

שולחים בקשת GET אל ה-method‏ projects.locations.clusters.list:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.
• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫FILTER: ביטוי שמגביל את התוצאות שמוחזרות לערכים ספציפיים.
• ‫PAGE_SIZE: מספר התוצאות שיוחזרו בכל דף.
• ‫SORT_BY: רשימה מופרדת בפסיקים של שמות שדות שלפיהם ימוינו התוצאות שיוחזרו. סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. כדי להגדיר סדר יורד, מוסיפים את התו ~ לפני השדה הרצוי.
• ‫PAGE_TOKEN: אסימון שמתקבל בתגובה לבקשת הרשימה האחרונה בשדה nextPageToken בתגובה. שולחים את האסימון הזה כדי לקבל דף תוצאות.

המסוף

1. נכנסים לדף Clusters במסוף Google Cloud .

   מעבר אל Clusters

2. בוחרים את האשכול הרצוי.

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

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters describe:

gcloud edge-cloud container clusters describe CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

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

• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו יצרתם את אזור Google Distributed Cloud.

API

שולחים בקשת GET אל ה-method‏ projects.locations.clusters.get:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.
• ‫CLUSTER_ID: השם של אשכול היעד.

gcloud

משתמשים בפקודה gcloud edge-cloud container get-server-config:

gcloud edge-cloud container get-server-config --location=REGION

מחליפים את REGION באזור שבו יצרתם את התחום של Distributed Cloud. Google Cloud

API

שולחים בקשת GET אל ה-method‏ projects.locations.serverConfig:

GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters upgrade:

gcloud edge-cloud container clusters upgrade CLUSTER_ID \
   --location=REGION \
   --project=PROJECT_ID \
   --schedule=UPGRADE_SCHEDULE \
   --version=SOFTWARE_VERSION

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

• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫REGION: האזור Google Cloud שבו נוצר אשכול היעד של Distributed Cloud.
• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫UPGRADE_SCHEDULE: מציין מתי להפעיל את שדרוג התוכנה. הערך התקין היחיד הוא IMMEDIATELY.
• ‫SOFTWARE_VERSION: מציין את גרסת התוכנה של Distributed Cloud שבה רוצים שהאשכול הזה יפעל בפורמט 1.X.Y, כאשר X היא גרסת המשנה ו-Y היא גרסת התיקון, לדוגמה 1.5.1. כדי לראות את גרסאות התוכנה שזמינות ליצירת אשכול, כולל גרסת ברירת המחדל של השרת, אפשר לעיין במאמר בנושא קבלת גרסאות התוכנה שזמינות לאשכול.

API

שולחים בקשת POST אל ה-method‏ projects.locations.clusters.upgrade:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:upgrade?requestId=REQUEST_ID
{
  "name": "projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID",
  "targetVersion": "SOFTWARE_VERSION",
    "schedule": "UPGRADE_SCHEDULE",
}

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.
• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.
• ‫UPGRADE_SCHEDULE: מציין מתי להפעיל את שדרוג התוכנה. הערך התקין היחיד הוא IMMEDIATELY.
• ‫SOFTWARE_VERSION: מציין את גרסת התוכנה של Distributed Cloud שבה רוצים שהאשכול הזה יפעל בפורמט 1.X.Y, כאשר X היא גרסת המשנה ו-Y היא גרסת התיקון, לדוגמה 1.5.1. כדי לראות את גרסאות התוכנה שזמינות ליצירת אשכול, כולל גרסת ברירת המחדל של השרת, אפשר לעיין במאמר בנושא קבלת גרסאות התוכנה שזמינות לאשכול.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters get-credentials:

gcloud edge-cloud container clusters get-credentials CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

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

• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.

API

שולחים בקשת GET אל ה-method‏ projects.locations.clusters:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אזור היעד של Distributed Cloud.
• ‫CLUSTER_ID: השם של אשכול היעד.

המסוף

אם אתם משתמשים במסוף Google Cloud , אתם יכולים לציין חלון זמן לתחזוקה רק כשיוצרים אשכול. כדי לציין חלון זמן לתחזוקה באשכול קיים, צריך להשתמש ב-Google Cloud CLI או ב-Distributed Cloud Edge Container API.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --maintenance-window-start=MAINTENANCE_START \
    --maintenance-window-end=MAINTENANCE_END \
    --maintenance-window-recurrence=MAINTENANCE_FREQUENCY

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

• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.
• ‫MAINTENANCE_START: שעת ההתחלה של חלון התחזוקה בפורמט YYYY-MM-DDTHH:MM:SSZ.
• ‫MAINTENANCE_END: שעת הסיום של חלון זמן לתחזוקה בפורמט YYYY-MM-DDTHH:MM:SSZ.
• ‫MAINTENANCE_FREQUENCY: התדירות של חלון התחזוקה בפורמט FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
  • ‫BYDAY: רשימה מופרדת בפסיקים של ימים שבהם יכולה להתבצע תחזוקה אם הערך של FREQ הוא WEEKLY. אם לא מציינים את הפרמטר BYDAY,‏ Google בוחרת את היום בשבוע בשבילכם.
  • אם מגדירים את האפשרות FREQ לערך daily, חלונות הזמן לתחזוקה מתרחשים כל יום בשעות שצוינו.

API

שולחים בקשת PATCH אל ה-method‏ projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": {
   "window": {
     "recurring_window": {
       "window": {
         "start_time": "MAINTENANCE_START",
         "end_time": "MAINTENANCE_END"
         },
       "recurrence": "MAINTENANCE_FREQUENCY"
     }
   }
 }
}

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: האזור Google Cloud שבו נוצר אשכול היעד של Distributed Cloud.
• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫UPDATE_MASK: רשימה מופרדת בפסיקים של שמות שדות מוגדרים במלואם לעדכון בבקשה הזו בפורמט FieldMask.
• ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.
• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫USERNAME: השם של חשבון המשתמש בפרויקט Google Cloud היעד שקיבל הרשאה לשנות משאבי אשכול.
• ‫MAINTENANCE_START: שעת ההתחלה של חלון התחזוקה בפורמט YYYY-MM-DDTHH:MM:SSZ.
• ‫MAINTENANCE_END: שעת הסיום של חלון זמן לתחזוקה בפורמט YYYY-MM-DDTHH:MM:SSZ.
• ‫MAINTENANCE_FREQUENCY: התדירות של חלון התחזוקה בפורמט FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
  • הערך של FREQ יכול להיות DAILY או WEEKLY.
  • ‫BYDAY: רשימה מופרדת בפסיקים של ימים שבהם יכולה להתבצע תחזוקה אם הערך של FREQ הוא WEEKLY. אם לא מציינים את הפרמטר BYDAY,‏ Google בוחרת את היום בשבוע בשבילכם.
  • אם מגדירים את האפשרות FREQ לערך daily, חלונות הזמן לתחזוקה מתרחשים כל יום בשעות שצוינו.

מידע נוסף זמין במאמר משאב: אשכול.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --clear-maintenance-window

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

• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: האזור Google Cloud שבו נוצר אשכול היעד של Distributed Cloud.

API

שולחים בקשת PATCH אל ה-method‏ projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": null
}

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: האזור Google Cloud שבו נוצר אשכול היעד של Distributed Cloud.
• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫UPDATE_MASK: רשימה מופרדת בפסיקים של שמות שדות מוגדרים במלואם לעדכון בבקשה הזו בפורמט FieldMask.
• ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.
• ‫USERNAME: השם של חשבון המשתמש בפרויקט Google Cloud היעד שקיבל הרשאה לשנות משאבי אשכול.

מידע נוסף זמין במאמר משאב: אשכול.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters delete:

gcloud edge-cloud container clusters delete CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

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

• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.

API

שולחים בקשת DELETE אל ה-method‏ projects.locations.clusters.delete:

DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?requestId=REQUEST_ID

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

• ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
• ‫REGION: Google Cloud האזור שבו נוצר אשכול היעד של Distributed Cloud.
• ‫CLUSTER_ID: השם של אשכול היעד.
• ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.