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

המסוף

1. נכנסים לדף Instance groups במסוף Cloud de Confiance .

   כניסה לדף Instance groups

2. בוחרים את ה-MIG שרוצים להגדיר לו את ההגדרה לכל המופעים.

3. לוחצים על Edit.

4. לוחצים על Instance template & overrides (תבנית של הגדרות מכונה ושינויים) כדי להרחיב את הקטע.

5. בקטע All-instances configuration (הגדרה לכל המופעים), מבצעים את הפעולות הבאות:

   • כדי להוסיף או לעדכן ערכים של מטא-נתונים, לוחצים על ניהול מטא-נתונים. משלימים את ההגדרה ולוחצים על שמירה.
   • כדי להוסיף או לעדכן תוויות, לוחצים על ניהול תוויות. משלימים את ההגדרה ולוחצים על שמירה.

6. אחרי שמסיימים להגדיר את הנכסים בהגדרה all-instances, לוחצים על שמירה.

   אם סוג העדכון של ה-MIG מוגדר לאוטומטי, ההגדרה all-instances שקבעתם מוחלת באופן מיידי על כל מכונות ה-VM הקיימות. אם סוג העדכון הוא Selective, צריך להחיל את ההגדרה באופן סלקטיבי על מכונות וירטואליות קיימות. מידע נוסף זמין במאמר החלת הגדרה של כל המופעים על מכונות וירטואליות קיימות.

gcloud

כדי להוסיף או לעדכן הגדרה לכל המכונות, משתמשים בפקודה all-instances-config update.

gcloud compute instance-groups managed all-instances-config update INSTANCE_GROUP_NAME \
    --metadata=KEY1=VALUE1,KEY2=VALUE2 \
    --labels=KEY3=VALUE3,KEY4=VALUE4

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

• ‫INSTANCE_GROUP_NAME: השם של ה-MIG.
• ‫KEYS ו-VALUES: צמדי מפתח/ערך של תוויות או מטא-נתונים. אם המפתח לא קיים, פקודת העדכון מוסיפה אותו. למפתחות קיימים, הערכים שלהם מתעדכנים.

חשוב לזכור להחיל את ההגדרה המעודכנת על מכונות וירטואליות קיימות ב-MIG.

REST

כדי להוסיף או לעדכן הגדרה של כל המופעים, שולחים בקשת PATCH ב-MIG אזורי או אזורי.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": "VALUE1",
        ...
      },
      "labels": {
        "KEY2": "VALUE2",
        ...
      },
    }
  }
}

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

• ‫PROJECT_ID: הפרויקט שבו קיימת קבוצת ה-MIG.
• ‫REGION: האזור שבו נמצאת קבוצת ה-MIG. ל-MIG אזורי, מחליפים את regions/REGION ב-zones/ZONE.
• ‫INSTANCE_GROUP_NAME: השם של ה-MIG.
• ‫KEYS ו-VALUES: צמדי מפתח/ערך של תוויות או מטא-נתונים. אם המפתח לא קיים, הוא יתווסף לבקשה. אם המפתח כבר קיים, הערך שלו מתעדכן.

חשוב לזכור להחיל את ההגדרה המעודכנת על מכונות וירטואליות קיימות ב-MIG.

gcloud

אפשר להגדיר עדכונים אוטומטיים (פרואקטיביים) באמצעות הפקודה update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=proactive \
    --update-policy-max-unavailable=MAX_UNAVAILABLE \
    --update-policy-max-surge=MAX_SURGE \
    --update-policy-min-ready=MIN_READY \
    --update-policy-minimal-action=MINIMAL_ACTION \
    --update-policy-replacement-method=REPLACEMENT_METHOD

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

• ‫INSTANCE_GROUP_NAME: השם של ה-MIG.
• ‫MAX_UNAVAILABLE (אופציונלי): מספר המקרים המקסימלי שבהם יכול להיות שהשירות לא יהיה זמין במהלך העדכון. לדוגמה, אם מגדירים את הדגל update-minimal-action לערך restart, הדגל הזה מגביל את מספר המכונות הווירטואליות שמופעלות מחדש בכל פעם. אפשר להגדיר מספר קבוע (לדוגמה, 5) או אחוז מהגודל של קבוצת מופעי מכונה מנוהלים (לדוגמה, 10%).
• ‫MAX_SURGE (אופציונלי): מספר נוסף מקסימלי של מופעים שאפשר ליצור במהלך העדכון. אפשר להגדיר מספר קבוע (לדוגמה, 5) או אחוז מהגודל של קבוצת המופעים המנוהלת (לדוגמה, 10%).
• ‫MIN_READY (אופציונלי): הזמן המינימלי שצריך לחלוף עד שמכונת VM שהופעלה מחדש או הוחלפה תהיה מוכנה להיחשב כזמינה. לדוגמה, 10s למשך 10 שניות. מידע על פורמטים של משך זמן מופיע במאמר gcloud topic datetimes.
• ‫MINIMAL_ACTION (אופציונלי): פעולה לביצוע בכל מופע במהלך עדכון ההגדרות:
  • ‫refresh: החלת ההגדרות החדשות על מופעים פעילים בלי להפעיל אותם מחדש.
  • ‫restart: הפעלה מחדש של מכונות וירטואליות במהלך העדכון. האפשרות הזו שימושית אם האפליקציה קוראת מטא-נתונים רק במהלך הפעלה מחדש.
  • ‫replace: מחיקת מכונות וירטואליות ויצירת מכונות חדשות כדי להחיל את ההגדרה החדשה.
• ‫REPLACEMENT_METHOD (אופציונלי): מציין איזו פעולה משמשת להחלפת מופע:
  • ‫recreate: ממתין למחיקת המכונה הישנה ואז יוצר מכונה חדשה עם אותו שם כמו של המכונה הישנה.
  • ‫substitute: יוצר מכונה עם שם חדש ומוחק את המכונה הישנה

REST

אפשר להגדיר עדכונים אוטומטיים (פרואקטיביים) על ידי שליחת בקשת PATCH ל-MIG אזורי או אזורי.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "PROACTIVE",
    "maxUnavailable": {
      "percent": MAX_UNAVAILABLE
    },
    "maxSurge": {
      "percent": MAX_SURGE
    },
    "minimalAction": MINIMAL_ACTION,
    "replacementMethod": REPLACEMENT_METHOD
  }
}

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

• ‫PROJECT_ID: הפרויקט שבו קיימת קבוצת ה-MIG.
• ‫REGION: האזור שבו נמצאת קבוצת ה-MIG. ל-MIG אזורי, מחליפים את regions/REGION ב-zones/ZONE.
• ‫INSTANCE_GROUP_NAME: שם ה-MIG.
• ‫MAX_UNAVAILABLE (אופציונלי): מספר המקרים המקסימלי שבהם יכול להיות שהשירות לא יהיה זמין במהלך העדכון. לדוגמה, אם מגדירים את הדגל update-minimal-action לערך RESTART, הדגל הזה מגביל את מספר המכונות הווירטואליות שמופעלות מחדש בכל פעם. אפשר להגדיר לתקציב אחוז (לדוגמה, "percent": 80 ל-80%) או מספר קבוע. כדי לציין מספר קבוע, מחליפים את "percent": MAX_UNAVAILABLE ב-"fixed": MAX_UNAVAILABLE.
• ‫MAX_SURGE (אופציונלי): מספר נוסף מקסימלי של מופעים שאפשר ליצור במהלך העדכון. ההנחה יכולה להיות באחוזים או בסכום קבוע.
• ‫MINIMAL_ACTION (אופציונלי): פעולה לביצוע בכל מופע במהלך עדכון ההגדרות:
  • ‫REFRESH: החלת ההגדרות החדשות על מופעים פעילים בלי להפעיל אותם מחדש.
  • ‫RESTART: הפעלה מחדש של מכונות וירטואליות במהלך העדכון. האפשרות הזו שימושית אם האפליקציה קוראת מטא-נתונים רק במהלך הפעלה מחדש.
  • ‫REPLACE: מחיקת מכונות וירטואליות ויצירת מכונות חדשות כדי להחיל את ההגדרה החדשה.
• ‫REPLACEMENT_METHOD (אופציונלי): מציין איזו פעולה משמשת להחלפת מופע:
  • ‫RECREATE: ממתין למחיקת המכונה הישנה ואז יוצר מכונה חדשה עם אותו שם כמו של המכונה הישנה.
  • ‫SUBSTITUTE: יוצר מכונה עם שם חדש ומוחק את המכונה הישנה

gcloud

אפשר להגדיר עדכונים סלקטיביים (אופורטוניסטיים) באמצעות הפקודה update:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=opportunistic

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

החלת הגדרה על מכונות וירטואליות ספציפיות

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

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAMES \
    --minimal-action=MINIMAL_ACTION \
    --most-disruptive-allowed-action=MOST_DISRUPTIVE_ALLOWED_ACTION

החלת ההגדרה על כל המכונות הווירטואליות

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

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --all-instances \
    --minimal-action=MINIMAL_ACTION \
    --most-disruptive-allowed-action=MOST_DISRUPTIVE_ALLOWED_ACTION

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

• ‫INSTANCE_GROUP_NAME: שם ה-MIG.
• ‫INSTANCE_NAMES: רשימה של מופעים שרוצים להחיל עליהם את התבנית.
• ‫MINIMAL_ACTION (אופציונלי): פעולה לביצוע בכל מופע במהלך עדכון ההגדרות שלו:
  • ‫refresh (ברירת מחדל): החלת ההגדרה החדשה על מופעים פעילים בלי להפעיל אותם מחדש.
  • ‫restart: הפעלה מחדש של מכונות וירטואליות במהלך העדכון. האפשרות הזו שימושית אם האפליקציה קוראת מטא-נתונים רק במהלך הפעלה מחדש.
  • ‫replace: מחיקת מכונות וירטואליות ויצירת מכונות חדשות כדי להחיל את ההגדרה החדשה.
• ‫MOST_DISRUPTIVE_ALLOWED_ACTION (אופציונלי): מבצעים לכל היותר את הפעולה הזו בכל מופע. אם עדכון ההגדרה דורש פעולה משבשת יותר מזו שצוינה כאן, העדכון ייכשל ולא יבוצעו שינויים.
  • none: אין פעולה
  • ‫refresh: הפעלת ההגדרה החדשה בלי לעצור את המכונות, אם אפשר. לדוגמה, אפשר להשתמש ב-refresh כדי להחיל שינויים שמשפיעים רק על מטא-נתונים או על דיסקים נוספים.
  • ‫restart: החלת ההגדרה החדשה בלי להחליף מופעים, אם אפשר. לדוגמה, כדי להחיל שינויים בסוג המכונה, מספיק לעצור את המכונות ולהפעיל אותן מחדש.
  • ‫replace: החלפת מופעים ישנים בהתאם לדגל --replacement-method.

REST

כדי להגדיר עדכונים סלקטיביים (אופורטוניסטיים), שולחים בקשה ל-MIG אזורי או אזורי.PATCH

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  }
}

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

החלת הגדרה על מכונות וירטואליות ספציפיות

כדי לעדכן מקרים ספציפיים, משתמשים בבקשה הבאה:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
  ],
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

החלת ההגדרה על כל המכונות הווירטואליות

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances

{
  "allInstances": true,
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

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

• ‫PROJECT_ID: הפרויקט שבו קיימת קבוצת ה-MIG.
• ‫REGION: האזור שבו נמצאת קבוצת ה-MIG. ל-MIG אזורי, מחליפים את regions/REGION ב-zones/ZONE.
• ‫INSTANCE_GROUP_NAME: שם ה-MIG.
• ‫MINIMAL_ACTION (אופציונלי): פעולה לביצוע בכל מופע במהלך עדכון ההגדרות:
  • ‫REFRESH: החלת ההגדרות החדשות על מופעים פעילים בלי להפעיל אותם מחדש.
  • ‫RESTART: הפעלה מחדש של מכונות וירטואליות במהלך העדכון. האפשרות הזו שימושית אם האפליקציה קוראת מטא-נתונים רק במהלך הפעלה מחדש.
  • ‫REPLACE: מחיקת מכונות וירטואליות ויצירת מכונות חדשות כדי להחיל את ההגדרה החדשה.
• ‫MOST_DISRUPTIVE_ALLOWED_ACTION (אופציונלי): מבצעים לכל היותר את הפעולה הזו בכל מופע. אם עדכון ההגדרה דורש פעולה משבשת יותר מזו שצוינה כאן, העדכון ייכשל ולא יבוצעו שינויים.
  • NONE: אין פעולה
  • ‫REFRESH: הפעלת ההגדרה החדשה בלי לעצור את המכונות, אם אפשר. לדוגמה, אפשר להשתמש ב-REFRESH כדי להחיל שינויים שמשפיעים רק על מטא-נתונים או על דיסקים נוספים.
  • ‫RESTART: החלת ההגדרות החדשות בלי להחליף מופעים, אם אפשר. לדוגמה, כדי להחיל שינויים בסוג המכונה, מספיק לעצור את המכונות ולהפעיל אותן מחדש.
  • ‫REPLACE: החלפת מופעים ישנים בהתאם לשדה updatePolicy.replacementMethod של הקבוצה.

המסוף

1. נכנסים לדף Instance groups במסוף Cloud de Confiance .

   כניסה לדף Instance groups

2. בוחרים את ה-MIG שרוצים לראות את ההגדרה של כל המופעים שלו.

3. עוברים לכרטיסייה פרטים.

4. אם ההגדרה האחרונה של כל המכונות הווירטואליות חלה על כל המכונות הווירטואליות, אז בקטע All instances configuration, חותמת הזמן Last modified והשדה Status צריכים להציג את הערכים הבאים:

   • השינוי האחרון: מציג את השעה שבה החלתם את ההגדרה של כל המופעים על כל מכונות ה-VM.
   • סטטוס: מוצג הוחל על כל המכונות הווירטואליות. אם התיוג all-instances לא חל על כל המכונות הווירטואליות, הסטטוס יהיה Pending VM update.

gcloud

משתמשים בפקודה describe וכוללים את הדגל --format כדי לחפש את הערך status.allInstancesConfig.effective.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(status.allInstancesConfig)"

פלט לדוגמה:

status:
  allInstancesConfig:
    currentRevision: 2022-12-02T10:30:15.012345Z
    effective: true

אם הערך של effective מוגדר כ-true, ההגדרה העדכנית ביותר חלה על כל המכונות הווירטואליות. הערך currentRevision מציג את חותמת הזמן של השינוי האחרון שבוצע בהגדרת כל המופעים של הקבוצה.

אם הערך של effective מוגדר כ-false, ההגדרה האחרונה עדיין לא חלה על כל מכונות ה-VM.

כדי לבדוק את הסטטוס של כל מכונה וירטואלית, אפשר לראות רשימה של כל המכונות הווירטואליות בקבוצת ה-MIG או לבדוק כל מכונה וירטואלית בנפרד באמצעות הפקודה describe-instance:

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME

פלט לדוגמה:

allInstancesConfig:
  revision: 2022-12-02T10:30:15.012345Z
currentAction: NONE
id: '8393021473297481188'
instance: .../projects/PROJECT/zones/ZONE/instances/INSTANCE_NAME
instanceStatus: RUNNING
name: INSTANCE_NAME
version:
  instanceTemplate: .../projects/PROJECT/global/instanceTemplates/INSTANCE_TEMPLATE

כדי לראות באילו מכונות וירטואליות הוחלה ההגדרה האחרונה, משווים את חותמת הזמן revision בכל מכונה וירטואלית עם חותמת הזמן currentRevision ב-MIG.

REST

שולחים בקשת GET אל מכונת MIG אזורית או תחומית כדי לבדוק את הערך של הדגל status.allInstancesConfig.effective.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

דוגמה לתשובה:

{
  ...
  "status": {
    "isStable": "true",
    "versionTarget": {
      "isReached": "true"
    },
    "allInstancesConfig": {
      "currentRevision": "2022-12-02T10:30:15.012345Z",
      "effective": "true"
    },
  ...
  },
  ...
}

אם השדה effective מוגדר לערך true, התצורה העדכנית ביותר חלה על כל המכונות הווירטואליות. בשדה currentRevision מוצגת חותמת הזמן של השינוי האחרון בהגדרות של כל המופעים בקבוצה.

אם השדה effective מוגדר לערך false, סימן שההגדרה האחרונה עדיין לא הוחלה על כל המכונות הווירטואליות.

כדי לבדוק את הסטטוס של כל מופע, מציגים רשימה של קבוצות מנוהלות של מופעים (MIG) אזוריות או אזוריות:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

פלט לדוגמה:

{
  "managedInstances": [
    ...
    {
      "instance": ".../zones/ZONE/instances/INSTANCE_NAME",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "allInstancesConfig": {
        "revision": "2022-12-02T10:30:15.012345Z"
      },
      "version": {
        "name": "V1",
        "instanceTemplate": ".../projects/.../instanceTemplates/INSTANCE_TEMPLATE"
      }
    },
    {
      ...
    }
  ]
}

כדי לראות באילו מכונות וירטואליות הוחלה ההגדרה האחרונה, משווים את חותמת הזמן revision בכל מכונה וירטואלית עם חותמת הזמן currentRevision ב-MIG.

המסוף

1. נכנסים לדף Instance groups במסוף Cloud de Confiance .

   כניסה לדף Instance groups

2. בוחרים את ה-MIG שרוצים לראות את ההגדרה של כל המופעים שלו.

3. עוברים לכרטיסייה פרטים.

4. אפשר לעיין בקטע הגדרת כל המופעים.

gcloud

משתמשים בפקודה describe וכוללים את הדגל --format כדי להציג את ערך ההגדרה של כל המופעים של הקבוצה.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(allInstancesConfig)"

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

REST

מגישים בקשת GET ב-MIG אזורי או אזורי ומחפשים את השדה allInstancesConfig.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

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

המסוף

1. נכנסים לדף Instance groups במסוף Cloud de Confiance .

   כניסה לדף Instance groups

2. בוחרים את ה-MIG שממנו רוצים למחוק את ההגדרה של כל המופעים.

3. לוחצים על Edit.

4. לוחצים על Instance template & overrides (תבנית של הגדרות מכונה ושינויים) כדי להרחיב את הקטע.

5. בקטע All-instances configuration (הגדרה לכל המופעים), מבצעים את הפעולות הבאות:

   1. בהתאם למאפיין שרוצים למחוק, לוחצים על ניהול מטא-נתונים או על ניהול תוויות.
   2. בחלונית ניהול מטא נתונים או ניהול תוויות, מעבירים את מצביע העכבר מעל הגדרה כדי להפעיל את אפשרות המחיקה, ואז לוחצים על delete מחיקת הפריט.
   3. לוחצים על Save.

6. לוחצים על שמירה כדי להחיל את השינויים על ה-MIG.

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

gcloud

כדי למחוק מאפיינים, משתמשים בפקודה all-instances-configuration delete ומציינים מפתח אחד או יותר של המאפיינים שרוצים למחוק.

gcloud compute instance-groups managed all-instances-config delete INSTANCE_GROUP_NAME \
    --metadata=KEY1[, KEY1]\
    --labels=KEY1[, KEY1]

חשוב לזכור להחיל את ההגדרה המעודכנת על מכונות וירטואליות קיימות ב-MIG.

REST

כדי למחוק מאפיינים, שולחים בקשת PATCH ב-MIG אזורי או אזורי ומציינים ערך null כמפתח לכל מאפיין שרוצים להסיר.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": null,
        ...
      },
      "labels": {
        "KEY2": null,
        ...
      }
    }
  }
}

חשוב לזכור להחיל את ההגדרה המעודכנת על מכונות וירטואליות קיימות ב-MIG.