הגדרת כתובות IP עם שמירת מצב בקבוצות MIG

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

אפשר לשמור כתובות IPv4 פנימיות וחיצוניות. אפשר להגדיר הקצאה אוטומטית של כתובות IP או להקצות כתובות IP ספציפיות לכל מכונה וירטואלית בקבוצת MIG.

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

מגבלות

לקבוצת MIG עם כתובות IP לשמירת מצב יש את המגבלות הבאות:

  • אין תמיכה בכתובות IPv6.

  • אין תמיכה בכתובות IP פנימיות ברשתות שאין בהן רשתות משנה, למשל רשתות מדור קודם.

לקבוצת MIG עם הגדרות לשמירת מצב (stateful) – קבוצת MIG לשמירת מצב – יש את המגבלות הבאות:

  • אי אפשר להשתמש בהתאמה אוטומטית לעומס או בתזמוני התאמה לעומס אם לקבוצת ה-MIG יש הגדרה של שמירת מצב. כדי לתזמן פעולות התחלה ועצירה של קבוצות MIG עם שמירת מצב, אפשר להשתמש בתהליך עבודה אוטומטי חיצוני. לדוגמה, אפשר להשתמש ב-Cloud Scheduler כדי להפעיל פונקציות Cloud Run שקוראות ל-methods‏ stopInstances ו-startInstances הספציפיות ל-MIG.
  • אם רוצים להשתמש בעדכונים אוטומטיים בהדרגה (rolling), צריך להגדיר את שיטת ההחלפה ל-RECREATE.
  • בקבוצות MIG אזוריות עם שמירת מצב, צריך להשבית את החלוקה מחדש היזומה (להגדיר את סוג החלוקה מחדש ל-NONE) כדי למנוע מחיקה של מכונות עם שמירת מצב על ידי חלוקה מחדש אוטומטית בין אזורים.
  • אם משתמשים בהגדרות לכל המכונות כדי לשנות את המאפיינים של תבנית של הגדרות מכונה, אי אפשר לציין את המאפיינים האלה בהגדרות לכל מכונה בנפרד וגם בהגדרות לכל המכונות בקבוצה.

תמחור

החיוב על כתובות IP חיצוניות הוא בהתאם למחירי הרשת.

מתי להשתמש בכתובות IP עם שמירת מצב

שמירה על כתובות ה-IP של המכונות שימושית בתרחישים הבאים:

  • לאפליקציה נדרשת כתובת IP שתישאר סטטית אחרי שהיא הוקצתה, למשל Kafka.
  • הגדרת האפליקציה תלויה בכתובות IP ספציפיות, למשל שרת DNS.
  • משתמשים, כולל אפליקציות אחרות, ניגשים לשרת שלכם דרך כתובת IP סטטית ייעודית – לדוגמה, שרת קבצים.
  • אתם צריכים להעביר עומסי עבודה קיימים בלי לשנות את הגדרות הרשת.

הגדרת כתובות IP עם שמירת מצב לכל המכונות הווירטואליות בקבוצה

הגדרת כתובות IP עם שמירת מצב לכל המכונות הווירטואליות בקבוצת מכונות מנוהלת שימושית בתרחישים הבאים:

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

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

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

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

    "accessConfigs": [
      {
        "kind": "compute#accessConfig",
        "name": "External NAT",
        "natIP": "XX.XX.XX.XX",
        "networkTier": "PREMIUM",
        "type": "ONE_TO_ONE_NAT"
      }
    ]
    

כדי לשמור כתובת IP סטטית, קבוצת ה-MIG יוצרת משאב Address.

הגדרת כתובות IP עם שמירת מצב בזמן יצירת קבוצת מכונות מנוהלת (MIG)

אפשר להשתמש במסוף Google Cloud , ב-CLI של gcloud, ב-Terraform או ב-REST.

המסוף

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

    כניסה לדף Instance groups

  2. בוחרים את הפרויקט ולוחצים על המשך.

  3. לוחצים על Create instance group.

  4. בוחרים באפשרות New managed instance group (stateful).

  5. מציינים שם לקבוצת המכונות.

  6. בוחרים תבנית של הגדרות מכונה.

  7. בקטע Number of instances, מציינים את מספר המכונות שרוצים לכלול בקבוצת המכונות המנוהלת.

  8. בקטע Stateful configuration, מרחיבים את הקטעים כתובת IP חיצונית ו-כתובת IP פנימית כדי להגדיר את סוגי כתובות ה-IP האלה כ-stateful.

    1. בקטע Stateful, בוחרים באפשרות Yes.
    2. ברשימה On permanent instance deletion, בוחרים את הפעולה שרוצים לבצע בכתובת ה-IP עם המצב כשמוחקים את המכונה הווירטואלית. האפשרויות הזמינות הן:
      • ניתוק כתובת ה-IP: (ברירת המחדל). ביטול ההקצאה של הכתובת במחיקת המכונה ושמירת הכתובת.
      • ‫Delete IP: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.
    3. אחרי שמסיימים להגדיר את התצורה עם שמירת המצב, לוחצים על Done.
  9. לוחצים על יצירה.

gcloud

כשיוצרים קבוצת MIG, כדי לציין אילו כתובות IP בממשקי הרשת מתבנית של הגדרות המכונה צריכות להיות עם שמירת מצב, משתמשים באחד או יותר מהדגלים הבאים עם הפקודה gcloud compute instance-groups managed create:

  • ‫--stateful-internal-ip כדי לסמן כתובת IP פנימית של ממשק רשת נתון כ-stateful.
  • ‫--stateful-external-ip כדי לסמן כתובת IP חיצונית של ממשק רשת נתון כ-stateful.
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --instance-redistribution-type NONE \
    --stateful-internal-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE]

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

  • ‫INSTANCE_GROUP_NAME: השם של קבוצת ה-MIG שרוצים ליצור.
  • ‫INSTANCE_TEMPLATE: השם של התבנית של הגדרות המכונה שבה משתמשים כשיוצרים מכונות חדשות.
  • ‫SIZE: המספר הראשוני של המכונות שצריך בקבוצה הזו.
  • ‫NI_NAME: (אופציונלי) שם ממשק הרשת. אם לא מציינים את האפשרות הזו, צריך לציין את האפשרות enabled, וממשק הרשת הראשי שנקרא nic0 נבחר כברירת מחדל. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין את הדגל הזה לכל כתובת IP בכל ממשק רשת.
  • ‫DELETE_RULE: (אופציונלי) מגדירה מה קורה למשאב Address הסטטי המשויך כשמוחקים מכונת VM באופן סופי. אלה האפשרויות הזמינות:

    • ‫never: (ברירת המחדל) אל תמחקו את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫on-permanent-instance-deletion: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.

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

דוגמה

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

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

gcloud compute instance-groups managed create example-group \
    --region us-east1 \
    --template node-template \
    --base-instance-name node \
    --instance-redistribution-type NONE \
    --size 3 \
    --stateful-internal-ip interface-name=nic0,auto-delete=on-permanent-instance-deletion
    --stateful-internal-ip interface-name=nic1,auto-delete=on-permanent-instance-deletion
    --stateful-external-ip enabled,auto-delete=on-permanent-instance-deletion

כתובות ה-IP הפנימיות בממשקי הרשת nic0 ו-nic1 וכתובת ה-IP החיצונית בממשק הרשת nic0 מוגדרות כ-stateful לכל המכונות בקבוצה. הקבוצה שומרת באופן אוטומטי כתובות IP פנימיות וכתובות IP חיצוניות סטטיות לכל מכונה. מכיוון שהדגל auto-delete מוגדר לערך on-permanent-instance-deletion, הקבוצה תמחק באופן אוטומטי את ההזמנות של כתובות ה-IP הסטטיות כשתמחקו את המכונות המשויכות או את הקבוצה כולה.

כדי לוודא שכתובות ה-IP הפנימיות בממשקי הרשת nic0 ו-nic1 וכתובת ה-IP החיצונית בממשק הרשת nic0 מוגדרות כ-stateful, מריצים את הפקודה הבאה:

gcloud compute instance-groups managed describe example-group \
    --zone us-east1-c

הפלט אמור להיראות כך:

baseInstanceName: node
...
name: example-group
...
statefulPolicy:
  preservedState:
    internalIPs:
      nic0:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
      nic1:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    externalIPs:
      nic0:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
...

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

Terraform

אם עדיין לא יצרתם תבנית של הגדרות מכונה, שבה מצוינים סוג המכונה, קובץ האימג' של דיסק האתחול, הרשת ומאפיינים אחרים של ה-VM שאתם רוצים לכל VM ב-MIG, צרו תבנית של הגדרות מכונה.

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

  • ‫stateful_internal_ip כדי לסמן כתובת IP פנימית של ממשק רשת נתון כ-stateful.
  • ‫stateful_external_ip כדי לסמן כתובת IP חיצונית של ממשק רשת נתון ככתובת עם שמירת מצב.

בדוגמה הבאה מוגדרות כתובות IP עם שמירת מצב כשיוצרים קבוצת MIG אזורית. למידע נוסף על המשאב שנעשה בו שימוש בדוגמה, ראו משאב google_compute_region_instance_group_manager.

resource "google_compute_region_instance_group_manager" "default" {
  name               = "example-group"
  base_instance_name = "node"
  target_size        = 3
  region             = "us-east1"

  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
  update_policy {
    type                         = "OPPORTUNISTIC"
    minimal_action               = "REFRESH"
    instance_redistribution_type = "NONE"
    max_unavailable_fixed        = 3
  }
  stateful_internal_ip {
    interface_name = "nic0"
    delete_rule    = "ON_PERMANENT_INSTANCE_DELETION"
  }
  stateful_internal_ip {
    interface_name = "nic1"
    delete_rule    = "ON_PERMANENT_INSTANCE_DELETION"
  }
  stateful_external_ip {
    interface_name = "nic0"
    delete_rule    = "ON_PERMANENT_INSTANCE_DELETION"
  }
}

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

REST

כשיוצרים קבוצת MIG, כדי לציין אילו כתובות IP בממשקי הרשת מתבנית של הגדרות המכונה צריכות להיות עם שמירת מצב, צריך לכלול אותן בשדה statefulPolicy בגוף הבקשה של ה-method‏ instanceGroupManagers.insert או regionInstanceGroupManagers.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceGroupManagers

{
  "name": "INSTANCE_GROUP_NAME",
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE"
    }
  ],
  "targetSize": SIZE,
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      },
      "externalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  }
}

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

  • ‫PROJECT: מזהה הפרויקט של הבקשה.
  • ‫REGION: בקבוצות MIG אזוריות, האזור שבו נמצאת הקבוצה. בקבוצות MIG של אזור, מחליפים את regions/REGION ב-zones/ZONE ומציינים את האזור שבו נמצאת קבוצת ה-MIG.
  • ‫NAME: השם של קבוצת ה-MIG שרוצים ליצור.
  • ‫INSTANCE_TEMPLATE: השם של תבנית של הגדרות מכונה שבה משתמשים כשיוצרים מכונות חדשות.
  • ‫SIZE: המספר הראשוני של המכונות שצריך בקבוצה הזו.
  • ‫NI_NAME: (אופציונלי) שם ממשק הרשת. אם לא מציינים את האפשרות הזו, צריך לציין את האפשרות enabled, וממשק הרשת הראשי שנקרא nic0 נבחר כברירת מחדל. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.
  • ‫DELETE_RULE: (אופציונלי) קובע מה יקרה למשאב Address סטטי משויך כשמכונה וירטואלית נמחקת באופן סופי. אלה האפשרויות הזמינות:

    • ‫NEVER: (ברירת המחדל) אף פעם לא למחוק את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫ON_PERMANENT_INSTANCE_DELETION: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.

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

דוגמה

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

כדי ליצור את הקבוצה, משתמשים ב-method‏ regionInstanceGroupManagers.insert:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers

{
  "name": "example-group",
  "baseInstanceName": "node",
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/node-template"
    }
  ],
  "targetSize": 3,
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" },
        "nic1": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
      "externalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
    }
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  }
}

כתובות ה-IP הפנימיות בממשקי הרשת nic0 ו-nic1 וכתובות ה-IP החיצוניות בממשק הרשת nic0 מוגדרות כ-stateful לכל המכונות בקבוצה. הקבוצה שומרת באופן אוטומטי כתובות IP פנימיות וכתובות IP חיצוניות סטטיות לכל מכונה. בגלל שהשדה auto-delete מוגדר לערך ON_PERMANENT_INSTANCE_DELETION, הקבוצה תמחק באופן אוטומטי את ההקצאות של כתובות ה-IP הסטטיות כשתמחקו את המכונות המשויכות או את הקבוצה כולה.

משתמשים בשיטה regionInstanceGroupManagers.get כדי לוודא שכתובות ה-IP הפנימיות בממשקי הרשת nic0 ו-nic1 וכתובות ה-IP החיצוניות בממשק הרשת nic0 מוגדרות במדיניות לשמירת המצב של המשאב החדש regionInstanceGroupManagers:

GET https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group

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

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" },
        "nic1": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
      "externalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
    }
  }
  ...
}

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

הגדרה ועדכון של הגדרות שמירת מצב לכתובות IP בקבוצת MIG קיימת

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

אם מגדירים מדיניות לשמירת מצב לכתובות IP בקבוצת MIG קיימת, אפשר לבצע את הפעולות הבאות:

  • מגדירים את כתובות ה-IP כ-stateful לכל המכונות הקיימות והעתידיות בקבוצה. הפעולה הזו מקדמת את כתובות ה-IP הארעיות התואמות של כל המכונות הקיימות לכתובות IP סטטיות.
  • מעדכנים את ההגדרה הקיימת של כתובות ה-IP.

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

המסוף

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

    כניסה לדף Instance groups

  2. לוחצים על השם של קבוצת המכונות שרוצים לציין לה כתובות IP עם שמירת מצב.

  3. לוחצים על Edit כדי לשנות את קבוצת המכונות המנוהלת.

  4. לוחצים על Stateful & per-instance configuration כדי להרחיב את הקטע.

  5. בקטע Group config, לוחצים על כתובת IP חיצונית ועל כתובת IP פנימית שרוצים להגדיר כ-עם שמירת מצב.

    1. בקטע Stateful, בוחרים באפשרות Yes.
    2. ברשימה On permanent instance deletion, בוחרים את הפעולה שרוצים לבצע בכתובת ה-IP עם המצב כשמוחקים את המכונה הווירטואלית. האפשרויות הזמינות הן:
      • ניתוק כתובת ה-IP: (ברירת המחדל). ביטול ההקצאה של הכתובת במחיקת המכונה ושמירת הכתובת.
      • ‫Delete IP: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.
    3. אחרי שמעדכנים את ההגדרה של שמירת המצב, לוחצים על Done.
    4. כדי להשלים את העדכון, לוחצים על שמירה.

gcloud

כדי לציין אילו כתובות IP צריכות להיות עם שמירת מצב, או כדי לעדכן את הגדרת כתובות ה-IP עם שמירת המצב בקבוצת MIG קיימת, משתמשים בדגל אחד או יותר של --stateful-internal-ip או --stateful-external-ip עם הפקודה gcloud compute instance-groups managed update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --stateful-internal-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE]

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

  • ‫INSTANCE_GROUP_NAME: השם של קבוצת ה-MIG שרוצים לעדכן.
  • ‫NI_NAME: (אופציונלי) שם ממשק הרשת. אם לא מציינים את האפשרות הזו, צריך לציין את האפשרות enabled, וממשק הרשת הראשי שנקרא nic0 נבחר כברירת מחדל. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין את הדגל הזה לכל כתובת IP בכל ממשק רשת.
  • ‫DELETE_RULE: (אופציונלי) מגדיר מה צריך לקרות למשאב Address סטטי משויך כשמכונת VM נמחקת באופן סופי. אלה האפשרויות הזמינות:

    • ‫never: (ברירת המחדל) אל תמחקו את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫on-permanent-instance-deletion: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.

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

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

דוגמה

אתם צריכים לחשוף שרת קבצים שפועל בקבוצת מכונות מנוהלת (MIG) עם שמירת מצב בשם example-fs-group למשתמשים חיצוניים, באמצעות כתובות IP חיצוניות סטטיות. למכונות בקבוצה יש כתובות IP חיצוניות זמניות. אתם צריכים לוודא שכתובות ה-IP נשמרות במהלך תיקון התוכנה האוטומטי (autohealing) והעדכונים של המכונה, כדי שלמשתמשים חיצוניים תהיה גישה רציפה לשרתים דרך כתובות ה-IP שפורסמו. כדי לשמור על רציפות במקרה של מחיקה לא מכוונת של הקבוצה, צריך גם לשמור את כתובות ה-IP שהוקצו.

כדי לעדכן את ה-MIG כך שכתובות ה-IP החיצוניות יוגדרו עם שמירת מצב, משתמשים בפקודה הבאה:

gcloud compute instance-groups managed update example-fs-group \
    --stateful-external-ip enabled

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

כתובות ה-IP החיצוניות נשמרות עכשיו באירועים של תיקון אוטומטי, עדכון ויצירה מחדש של מכונות. ההקצאות המשויכות של כתובות ה-IP הסטטיות לא מוקצות ונשמרות במחיקת המכונה, כי הכלל הלא מוגדר auto-delete מוגדר כ-never כברירת מחדל.

כדי לוודא שכתובת ה-IP החיצונית עם שמירת המצב מוגדרת במדיניות עם שמירת המצב, מריצים את הפקודה gcloud compute instance-groups managed describe example-fs-group.

REST

כדי לציין אילו כתובות IP צריכות להיות עם שמירת מצב, או כדי לעדכן את הגדרת ה-IP עם שמירת המצב של קבוצת MIG קיימת, משתמשים ב-method‏ instanceGroupManagers.patch או ב-method‏ regionInstanceGroupManagers.patch:

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

{
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      },
      "externalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

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

  • ‫PROJECT: מזהה הפרויקט של הבקשה.
  • ‫REGION: בקבוצות MIG אזוריות, האזור שבו נמצאת הקבוצה. בקבוצות MIG של אזור, מחליפים את regions/REGION ב-zones/ZONE ומציינים את האזור שבו נמצאת קבוצת ה-MIG.
  • ‫NAME: השם של קבוצת ה-MIG שרוצים ליצור.
  • ‫NI_NAME: (חובה) השם של ממשק הרשת. ממשק הרשת הראשי נקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.
  • ‫DELETE_RULE: (אופציונלי) קובע מה יקרה למשאב Address סטטי משויך כשמכונה וירטואלית נמחקת באופן סופי. אלה האפשרויות הזמינות:

    • ‫NEVER: (ברירת המחדל) אף פעם לא למחוק את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫ON_PERMANENT_INSTANCE_DELETION: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.

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

אם כתובת IP מסוימת כבר מוגדרת במדיניות לשמירת המצב, השיטה מתקנת את ההגדרה.

דוגמה

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

מתקנים את ה-MIG כדי להגדיר את כתובות ה-IP החיצוניות כ-stateful:

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-fs-group

{
  "statefulPolicy": {
    "preservedState": {
      "externalIPs": {
        "nic0": {"autoDelete": "NEVER" }
      }
    }
  }
}

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

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

כדי לוודא שכתובת ה-IP החיצונית מוגדרת במדיניות לשמירת המצב, בודקים את המשאב regionInstanceGroupManagers שמוחזר על ידי ה-method‏ regionInstanceGroupManagers.get.

הצהרה על כתובות IP שהיו בעבר עם שמירת מצב ככתובות ללא שמירת מצב

יכול להיות שתצטרכו להגדיר כתובת IP קבועה כזמנית, למשל מהסיבות הבאות:

  • אתם משנים את הארכיטקטורה של האפליקציה כך שהיא לא תסתמך יותר על כתובות IP סטטיות.
  • הגדרתם בטעות את כתובת ה-IP כ-stateful ואתם רוצים לבטל את ההגדרה.

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

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

מידע נוסף זמין במאמרים הבאים:

המסוף

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

    כניסה לדף Instance groups

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

  3. לוחצים על Edit כדי לשנות את קבוצת המכונות המנוהלת.

  4. לוחצים על Stateful & per-instance configuration כדי להרחיב את הקטע.

  5. בקטע Group config, מרחיבים את כתובת IP חיצונית ואת כתובת IP פנימית שרוצים להפוך לבלי שמירת מצב.

    1. משנים את האפשרות Stateful ל-No.
    2. לוחצים על סיום.
  6. אחרי שמבצעים את השינויים, לוחצים על שמירה.

gcloud

כדי לציין אילו כתובות IP ממדיניות שמירת המצב של קבוצת MIG יהיו זמניות, משתמשים בדגל --remove-stateful-internal-ips או --remove-stateful-external-ips עם הפקודה gcloud compute instance-groups managed update:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --remove-stateful-internal-ips NI_NAME[,NI_NAME,...] \
    --remove-stateful-external-ips NI_NAME[,NI_NAME,...]

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

  • ‫INSTANCE_GROUP_NAME: השם של קבוצת ה-MIG שרוצים לעדכן.
  • ‫NI_NAME: (חובה) שם ממשק הרשת. ממשק הרשת הראשי נקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.

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

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --stateful-internal-ip disabled \
    --stateful-external-ip disabled

דוגמה

האפליקציה שלכם נחשפה למשתמשים דרך כתובות IP חיצוניות סטטיות שפורסמו של המכונות הווירטואליות בקבוצת מכונות מנוהלת (MIG) שנקראת example-group. שיניתם את הארכיטקטורה של השירות על ידי פריסת מאזן עומסים לפני ה-MIG, וניתוב התנועה למכונות הווירטואליות המנוהלות דרכו. אתם לא צריכים יותר לתחזק את כתובות ה-IP החיצוניות הסטטיות, ואתם רוצים להפוך את כתובות ה-IP החיצוניות של המכונות הווירטואליות לזמניות.

כדי להפוך את כתובות ה-IP החיצוניות עם שמירת המצב של המכונות הווירטואליות בקבוצת MIG לזמניות, מריצים את הפקודה הבאה:

gcloud compute instance-groups managed update example-group \
    --remove-stateful-external-ips nic0

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

REST

כדי לציין אילו כתובות IP ממדיניות שמירת המצב של קבוצת ה-MIG יהיו זמניות, צריך להסיר את ההגדרה של כל כתובת IP ממדיניות שמירת המצב של קבוצת ה-MIG באמצעות השיטה instanceGroupManagers.patch או regionInstanceGroupManagers.patch:

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

{
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "NI_NAME": null
      },
      "externalIPs": {
        "NI_NAME": null
      }
    }
  }
}

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

  • ‫PROJECT: מזהה הפרויקט של הבקשה.
  • ‫REGION: בקבוצות MIG אזוריות, האזור שבו נמצאת הקבוצה. בקבוצות MIG של אזור, מחליפים את regions/REGION ב-zones/ZONE ומציינים את האזור שבו נמצאת קבוצת ה-MIG.
  • ‫INSTANCE_GROUP_NAME: השם של קבוצת ה-MIG שרוצים ליצור.
  • ‫NI_NAME: (חובה) השם של ממשק הרשת. ממשק הרשת הראשי נקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.

דוגמה

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

כדי להפוך את כתובות ה-IP החיצוניות עם שמירת המצב של המכונות הווירטואליות בקבוצת ה-MIG לזמניות, צריך לתקן את קבוצת ה-MIG:

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group

{
  "statefulPolicy": {
    "preservedState": {
      "externalIPs": {
        "nic0": null
      }
    }
  }
}

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

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

הגדרה של כתובות IP לשמירת מצב (stateful) באופן נפרד למכונות וירטואליות בקבוצת MIG שימושית בתרחישים הבאים:

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

הגדרת כתובות IP סטטיות ביצירת מכונה וירטואלית ב-MIG

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

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

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

gcloud

כדי ליצור מכונה עם כתובת IP סטטית שהוגדרה מראש, משתמשים בפקודה gcloud compute instance-groups managed create-instance עם אחד או יותר מהדגלים הבאים:

  • --stateful-internal-ip כדי להגדיר כתובת IP פנימית סטטית של ממשק רשת נתון.
  • ‫--stateful-external-ip כדי להגדיר כתובת IP חיצונית סטטית של ממשק רשת נתון.
gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE]

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

  • ‫INSTANCE_GROUP_NAME: השם של ה-MIG.
  • ‫INSTANCE_NAME: השם של המכונה שרוצים ליצור.
  • ‫NI_NAME: (אופציונלי) שם ממשק הרשת. אם לא מציינים ממשק, כברירת מחדל המערכת משתמשת בממשק הרשת הראשי שנקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין את הדגל הזה לכל כתובת IP בכל ממשק רשת.
  • ‫ADDRESS: (חובה) כתובת IP סטטית להקצאה למכונה, באחד מהפורמטים הבאים:

    • כתובת. כתובת ה-URL של שמירת כתובת IP סטטית, לדוגמה: "projects/example-project/regions/us-east1/addresses/example-ip-name".
    • מילולי – לדוגמה: "130.211.181.55".
      • אם כתובת ה-IP שצוינה עדיין לא שמורה, קבוצת ה-MIG יוצרת באופן אוטומטי שמירה של כתובת IP תואמת.
      • אם כתובת ה-IP שצוינה שמורה, קבוצת ה-MIG מקצה את השמירה למכונה.
  • ‫DELETE_RULE: (אופציונלי) קובע מה יקרה למשאב Address סטטי משויך כשמכונת VM נמחקת באופן סופי. אלה האפשרויות הזמינות:

    • ‫never: (ברירת המחדל) אל תמחקו את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫on-permanent-instance-deletion: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.

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

דוגמה

אתם צריכים להוסיף עוד מכונה וירטואלית אחת לאשכול של שרת ה-proxy, שפועל בקבוצת מכונות מנוהלת בשם proxy-cluster. יצרתם הקצאה של כתובת IP פנימית סטטית בשם proxy-node-03-ip, ואתם צריכים להקצות אותה לצומת החדש. אתם רוצים לשמור את הקצאת כתובת ה-IP גם אם תחליטו למחוק את הצומת בעתיד.

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

gcloud compute instance-groups managed create-instance proxy-cluster \
    --instance proxy-node-03 \
    --stateful-internal-ip address="projects/example-project/regions/us-east1/addresses/proxy-node-03-ip",auto-delete=never

הפקודה יוצרת מכונה בשם proxy-node-03, מקצה למכונה את כתובת ה-IP הפנימית הסטטית שצוינה בשם proxy-node-03-ip, ושומרת את ההגדרות של כתובת ה-IP בהגדרות של המכונה. מכיוון שהדגל auto-delete מוגדר כ-never, כתובת ה-IP נשארת שמורה אם מוחקים את המכונה מאוחר יותר.

Terraform

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

  • ‫preserved_state.internal_ip כדי לסמן כתובת IP פנימית של ממשק רשת נתון כ-stateful.
  • ‫preserved_state.external_ip כדי לסמן כתובת IP חיצונית של ממשק רשת נתון כ-stateful.

בדוגמה הבאה מוגדרות כתובות IP סטטיות ביצירת VM בקבוצת MIG אזורית. למידע נוסף על המשאב שנעשה בו שימוש בדוגמה, ראו משאב google_compute_region_per_instance_config. לקבוצת MIG אזורית, משתמשים במשאב google_compute_per_instance_config.

resource "google_compute_region_per_instance_config" "default" {
  region_instance_group_manager = google_compute_region_instance_group_manager.default.name
  region                        = google_compute_region_instance_group_manager.default.region
  name                          = "proxy-node-03-ip"
  preserved_state {
    internal_ip {
      interface_name = "nic0"
      auto_delete    = "NEVER"
      ip_address {
        address = google_compute_address.default.id
      }
    }
  }
}

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

REST

כדי ליצור מכונה אחת או כמה מכונות ב-MIG, להגדיר שמות בהתאמה אישית למכונות ולהקצות להן כתובות IP סטטיות שהוגדרו מראש, משתמשים ב-method‏ instanceGroupManagers.createInstances או ב-method‏ regionInstanceGroupManagers.createInstances.

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

{
  "instances": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        "externalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        ...
      }
    },
    ...
  ]
}

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

  • ‫PROJECT_ID: מזהה הפרויקט של הבקשה.
  • ‫NAME: השם של ה-MIG.
  • ‫REGION: בקבוצות MIG אזוריות, האזור שבו נמצאת הקבוצה. בקבוצות MIG של אזור, מחליפים את regions/REGION ב-zones/ZONE ומציינים את האזור שבו נמצאת קבוצת ה-MIG.
  • ‫INSTANCE_NAME: השם של המכונה שרוצים ליצור.
  • ‫NI_NAME: (חובה) שם ממשק הרשת. ממשק הרשת הראשי נקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.
  • ‫ADDRESS: (אופציונלי) כתובת IP סטטית להקצאה למכונה, בפורמט של כתובת URL של כתובת IP סטטית שמורה. לדוגמה: "projects/example-project/regions/us-east1/addresses/example-ip-name". כשמקצים כתובת IP סטטית, צריך להגדיר רק שדה אחד בכל פעם, address או literal.
  • ‫LITERAL: (אופציונלי) כתובת IP סטטית שצריך להקצות למכונה בפורמט המילולי – לדוגמה: "130.211.181.55". כשמקצים כתובת IP סטטית, צריך להגדיר רק שדה אחד בכל פעם, address או literal.
    • אם כתובת ה-IP המילולית שצוינה עדיין לא שמורה, קבוצת ה-MIG יוצרת באופן אוטומטי שמירה של כתובת IP תואמת.
    • אם כתובת ה-IP המילולית שצוינה שמורה, ה-MIG מקצה את המקום השמור למכונה.
  • ‫DELETE_RULE: (אופציונלי) קובע מה יקרה למשאב Address סטטי משויך כשמכונת VM נמחקת באופן סופי. אלה האפשרויות הזמינות:

    • ‫NEVER: (ברירת המחדל) אל תמחקו את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫ON_PERMANENT_INSTANCE_DELETION: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.

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

דוגמה

אתם צריכים להוסיף עוד מכונה וירטואלית אחת לאשכול של שרת ה-proxy, שפועל ב-MIG בשם proxy-cluster. יצרתם הקצאה של כתובת IP פנימית סטטית בשם proxy-node-03-ip, ואתם צריכים להקצות אותה לצומת החדש. אתם רוצים לשמור את הקצאת כתובת ה-IP גם אם תחליטו למחוק את הצומת בעתיד.

מפעילים את ה-method‏ regionInstanceGroupManagers.createInstances כדי ליצור מכונה נוספת:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/proxy-cluster/createInstances

{
  "instances": [
    {
      "name": "proxy-node-03",
      "preservedState" : {
        "internalIPs": {
          "nic0" : {
            "ipAddress": {
              "address": "projects/example-project/regions/us-east1/addresses/proxy-node-03-ip"
            },
            "autoDelete": "NEVER"
          }
        }
      }
    }
  ]
}

השיטה יוצרת מכונה בשם proxy-node-03, מקצה למכונה את כתובת ה-IP הפנימית הסטטית שצוינה בשם proxy-node-03-ip, ושומרת את ההגדרה של שמירת המצב של כתובת ה-IP בהגדרה המתאימה לכל מכונה. מכיוון שהשדה autoDelete מוגדר לערך NEVER, כתובת ה-IP נשארת שמורה אם מוחקים את המכונה מאוחר יותר.

הגדרת כתובות IP סטטיות למכונה וירטואלית קיימת ב-MIG

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

  • הקצאת כתובת IP סטטית למכונה קיימת ב-MIG. בכתובות IP חיצוניות סטטיות, הפעולה הזו דורשת רענון של המכונה, ובכתובות IP פנימיות סטטיות, היא דורשת יצירה מחדש של המכונה.
  • עדכון כלל המחיקה של כתובת IP סטטית שכבר הוקצתה. אפשר לבצע את הפעולה הזו בלי להפריע למכונה שפועלת.

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

"accessConfigs": [
  {
    "kind": "compute#accessConfig",
    "name": "External Nat",
    "natIP": "XX.XX.XX.XX",
    "networkTier": "PREMIUM",
    "type": "ONE_TO_ONE_NAT"
  }
]

gcloud

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

אם עדיין לא קיימת הגדרה לכל מכונה, משתמשים בפקודה gcloud compute instance-groups managed instance-configs create עם אחד או יותר מהדגלים הבאים:

  • --stateful-internal-ip כדי להגדיר כתובת IP פנימית סטטית של ממשק רשת נתון.
  • ‫--stateful-external-ip כדי להגדיר כתובת IP חיצונית סטטית של ממשק רשת נתון.
gcloud compute instance-groups managed instance-configs create INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    [--no-update-instance | --update-instance]
    [--instance-update-minimal-action MINIMAL_ACTION]

אם כבר קיימת הגדרה לכל מכונה, משתמשים בפקודה gcloud compute instance-groups managed instance-configs update עם דגל אחד או יותר של --stateful-internal-ip או --stateful-external-ip:

gcloud compute instance-groups managed instance-configs update INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    [--no-update-instance | --update-instance]
    [--instance-update-minimal-action MINIMAL_ACTION]

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

  • ‫INSTANCE_GROUP_NAME: השם של ה-MIG.
  • ‫INSTANCE_NAME: השם של המכונה שבה רוצים להגדיר כתובות IP עם שמירת מצב.
  • ‫NI_NAME: (אופציונלי) שם ממשק הרשת. אם לא מציינים ממשק, כברירת מחדל המערכת משתמשת בממשק הרשת הראשי שנקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין את הדגל הזה לכל כתובת IP בכל ממשק רשת.
  • ‫ADDRESS: כתובת IP סטטית שצריך להקצות למכונה באחד מהפורמטים הבאים:
    • כתובת. כתובת ה-URL של שמירת כתובת IP סטטית, לדוגמה: "projects/example-project/regions/us-east1/addresses/example-ip-name".
    • מילולי. לדוגמה: "130.211.181.55".
      • אם כתובת ה-IP שצוינה עדיין לא שמורה, קבוצת ה-MIG יוצרת באופן אוטומטי שמירה של כתובת IP תואמת.
      • אם כתובת ה-IP שצוינה שמורה, קבוצת ה-MIG מקצה את השמירה למכונה.
    • הדגל המשני הזה הוא אופציונלי אם הכתובת כבר מוגדרת בהגדרות של המכונה. אחרת, חובה להזין אותו.
    • אם משמיטים את הפרמטר הזה, הכתובת שהוגדרה לא משתנה.
  • ‫DELETE_RULE: (אופציונלי) קובע מה יקרה למשאב Address סטטי משויך כשמכונת VM נמחקת באופן סופי. אלה האפשרויות הזמינות:

    • ‫never: (ברירת המחדל) אל תמחקו את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫on-permanent-instance-deletion: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.
    • אם משמיטים את הפרמטר, ערך ברירת המחדל מוגדר להגדרת IP חדשה עם שמירת מצב. הערך לא משתנה בהגדרה קיימת.

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

  • ‫--update-instance: (אופציונלי. Default.) החלת השינויים באופן מיידי על המכונה. אם משתמשים בדגל --no-update-instance, השינויים לא מוחלים ויוחלו כשיוצרים מחדש את המכונה או מחילים עליה את העדכון מאוחר יותר.

  • ‫MINIMAL_ACTION: (אופציונלי) ביצוע הפעולה שצוינה לפחות, כשמחילים עדכון הגדרות אישיות לכל מכונה במכונה. צריך להשתמש בו יחד עם הדגל --update-instance. הערך חייב להיות אחד מהבאים:

    • ‫none: לא תתבצע פעולה.
    • ‫refresh: החלת עדכונים שאפשר להחיל בלי לעצור את המכונה.
    • ‫restart: עוצרים את המכונה ומפעילים אותה מחדש.
    • ‫replace: יוצרים מחדש את המכונה.

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

דוגמה

יש לכם מכונה של שרת קבצים בשם file-server, שהיא מכונה יחידה בקבוצת MIG עם שמירת מצב בשם fs-group. לקבוצה יש הגדרה תואמת לכל מכונה, שבה מוגדר דיסק נתונים עם שמירת מצב. עד עכשיו, הגישה לשרת הקבצים הייתה רק פנימית, אבל עכשיו יש משתמשים שצריכים לגשת אליו באופן חיצוני דרך כתובת IP סטטית. שמרתם את כתובת ה-IP החיצונית הסטטית על ידי יצירת שמירת כתובת file-server-ip. עכשיו צריך להקצות את כתובת ה-IP הזו למכונה של שרת הקבצים.

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

gcloud compute instance-groups managed instance-configs update fs-group \
    --instance file-server \
    --stateful-external-ip interface-name=nic0,address="projects/example-project/regions/us-east1/addresses/file-server-ip",auto-delete=never \
    --update-instance

הפקודה מבצעת את הפעולות הבאות:

  1. מעדכנים את ההגדרה לכל מכונה במכונה file-server:
    1. הוספת הגדרה של כתובת IP חיצונית עם שמירת מצב, שמפנה לכתובת ה-IP השמורה file-server-ip.
    2. הגדרת דיסק הנתונים עם שמירת המצב הקיימת לא משתנה.
  2. הפקודה הזו מחילה מיד את עדכון ההגדרות לכל מכונה על המכונה file-server, כי הדגל --update-instance נכלל: היא מרעננת את המכונה ומקצה את כתובת ה-IP החיצונית הסטטית מההזמנה file-server-ip.

REST

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

אם עדיין לא קיימות הגדרות לכל מכונה במכונות הנתונות, משתמשים בשיטה instanceGroupManagers.updatePerInstanceConfigs או בשיטה regionInstanceGroupManagers.updatePerInstanceConfigs עם הגדרה של שמירת מצב לכתובת IP אחת או יותר:

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

{
  "perInstanceConfigs": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        "externalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        ...
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

אם כבר קיימות הגדרות לכל מכונה במכונות הנתונות, משתמשים ב-method instanceGroupManagers.patchPerInstanceConfigs או ב-method regionInstanceGroupManagers.patchPerInstanceConfigs עם הגדרה לשמירת מצב (stateful) לכתובת IP אחת או יותר:

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

{
  "perInstanceConfigs": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        "externalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        ...
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

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

  • ‫PROJECT_ID: מזהה הפרויקט של הבקשה.
  • ‫NAME: השם של ה-MIG.
  • ‫REGION: בקבוצות MIG אזוריות, האזור שבו נמצאת הקבוצה. בקבוצות MIG של אזור, מחליפים את regions/REGION ב-zones/ZONE ומציינים את האזור שבו נמצאת קבוצת ה-MIG.
  • ‫INSTANCE_NAME: (חובה) שם המכונה שרוצים להגדיר לה כתובות IP עם שמירת מצב.
  • ‫NI_NAME: (חובה) שם ממשק הרשת. ממשק הרשת הראשי נקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.
  • ‫ADDRESS: (אופציונלי) כתובת IP סטטית להקצאה למכונה, בפורמט של כתובת URL של כתובת IP סטטית שמורה. לדוגמה: "projects/example-project/regions/us-east1/addresses/example-ip-name". כשמקצים כתובת IP סטטית, צריך להגדיר רק שדה אחד בכל פעם – כתובת או מחרוזת.
  • ‫LITERAL: (אופציונלי) כתובת IP סטטית שצריך להקצות למכונה בפורמט המילולי. לדוגמה: "130.211.181.55". כשמקצים כתובת IP סטטית, צריך להגדיר רק שדה אחד בכל פעם, או address או literal.
    • אם כתובת ה-IP המילולית שצוינה עדיין לא שמורה, קבוצת ה-MIG יוצרת באופן אוטומטי שמירה של כתובת IP תואמת.
    • אם כתובת ה-IP המילולית שצוינה שמורה, ה-MIG מקצה את המקום השמור למכונה.
  • ‫DELETE_RULE: (אופציונלי) קובע מה יקרה למשאב Address סטטי משויך כשמכונת VM נמחקת באופן סופי. אלה האפשרויות הזמינות:

    • ‫NEVER: (ברירת המחדל) אל תמחקו את כתובת ה-IP הסטטית. במקום זאת, בטלו את הקצאת הכתובת כשאתם מוחקים את המכונה, והשאירו את הכתובת שמורה.
    • ‫ON_PERMANENT_INSTANCE_DELETION: מחיקת ההקצאה של כתובת ה-IP הסטטית כשמכונה נמחקת באופן סופי מקבוצת המכונות – לדוגמה, כשמוחקים מכונה באופן ידני או מקטינים את גודל הקבוצה.
    • אם משמיטים את הפרמטר, ערך ברירת המחדל מוגדר להגדרת IP חדשה עם שמירת מצב. הערך לא משתנה בהגדרה קיימת.

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

  • ‫FINGERPRINT: (אופציונלי) טביעת האצבע של ההגדרה הנתונה, אם היא כבר קיימת. משמש לנעילה אופטימית. הפעולה תיכשל אם טביעת האצבע שונה מזו שסופקה, כי זה מצביע על כך שההגדרות האישיות של המכונה השתנו מאז הפעם האחרונה שהן נקראו. כדי לראות את טביעת האצבע האחרונה, צריך לבדוק את הפלט של השיטה listPerInstanceConfigs בקבוצת MIG אזורית או בתוך אזור. אם משמיטים את fingerprint, הפעולה ממשיכה בלי השוואת טביעות אצבע.

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

דוגמה

יש לכם מכונה של שרת קבצים בשם file-server, שהיא מכונה יחידה בקבוצת MIG עם שמירת מצב בשם fs-group. לקבוצה יש הגדרה תואמת לכל מכונה, שבה מוגדר דיסק נתונים עם שמירת מצב. עד עכשיו, הגישה לשרת הקבצים הייתה רק פנימית, אבל עכשיו יש משתמשים שצריכים לגשת אליו באופן חיצוני דרך כתובת IP סטטית. שמרתם את כתובת ה-IP החיצונית הסטטית על ידי יצירת שמירת כתובת file-server-ip. עכשיו צריך להקצות את כתובת ה-IP הזו למכונה של שרת הקבצים.

כדי לעדכן את ההגדרות של כל מכונה ב-file-server עם כתובת ה-IP החיצונית החדשה עם שמירת המצב, מפעילים את ה-method‏ patchPerInstanceConfigs:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/fs-group/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "file-server",
      "preservedState" : {
        "externalIPs": {
          "nic0" : {
            "ipAddress": {
              "address": "projects/example-project/regions/us-east1/addresses/file-server-ip"
            },
            "autoDelete": "NEVER"
          }
        }
      }
    }
  ]
}

השיטה מתקנת את ההגדרות לכל מכונה של file-server:

  1. הוספת הגדרה של כתובת IP חיצונית עם שמירת מצב, שמפנה לכתובת השמורה file-server-ip.
  2. הגדרת דיסק הנתונים עם שמירת המצב הקיימת לא משתנה.

עדכון ההגדרות עדיין לא הוחל על המכונה הווירטואלית file-server. ה-MIG יחיל את עדכון ההגדרות כשתצרו מחדש את המכונה או כשתחילו את העדכון על המכונה מאוחר יותר.

כדי להחיל את העדכון של הגדרת המכונה על מכונה וירטואלית אחת (file-server), מפעילים את ה-method‏ regionInstanceGroupManagers.applyUpdatesToInstances על המכונה:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/gs-group/applyUpdatesToInstances

{
  "instances": ["/zones/us-east1-b/instances/file-server"]
}

השיטה מקצה למכונה המנוהלת את כתובת ה-IP החיצונית הסטטית שהוגדרה מההזמנה של file-server-ip. השיטה מרעננת את המכונה file-server כדי להקצות כתובת IP חיצונית.

מכיוון שהערך של autoDelete מוגדר כ-NEVER בהגדרת ה-IP עם שמירת המצב, כתובת ה-IP תישאר שמורה אם תמחקו את המכונה מאוחר יותר.

ביטול השיוך של כתובות IP סטטיות ממכונה וירטואלית קיימת ב-MIG

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

  • אתם משנים את הארכיטקטורה של האפליקציה כך שהיא לא תסתמך יותר על כתובות IP סטטיות.
  • הגדרתם בטעות את כתובת ה-IP כ-stateful ואתם רוצים לבטל את ההגדרה.

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

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

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

למידע נוסף, קראו את המאמרים הבאים:

gcloud

כדי להסיר הגדרת כתובת IP עם שמירת מצב מההגדרה המשויכת לכל מכונה, משתמשים בפקודה gcloud compute instance-groups managed instance-configs update עם הדגלים --remove-stateful-internal-ips או --remove-stateful-external-ips:

gcloud compute instance-groups managed instance-configs update INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --remove-stateful-internal-ips NI_NAME[,NI_NAME,...] \
    --remove-stateful-external-ips NI_NAME[,NI_NAME,...]
    [--no-update-instance | --update-instance] \
    [--instance-update-minimal-action MINIMAL_ACTION]

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

  • ‫INSTANCE_GROUP_NAME: השם של ה-MIG.
  • ‫INSTANCE_NAME: (חובה) שם המכונה שממנה רוצים להסיר את הגדרת ה-IP עם שמירת המצב.
  • ‫NI_NAME: (חובה) שם ממשק הרשת. ממשק הרשת הראשי נקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.
  • ‫--update-instance: (אופציונלי. Default.) החלת השינויים באופן מיידי על המכונה. אם משתמשים בדגל --no-update-instance, השינויים לא מוחלים ויוחלו כשיוצרים מחדש את המכונה או מחילים עליה את העדכון מאוחר יותר.
  • ‫MINIMAL_ACTION: (אופציונלי) ביצוע הפעולה שצוינה לפחות, כשמחילים עדכון הגדרות אישיות לכל מכונה במכונה. אפשר להשתמש בדגל הזה רק יחד עם הדגל --update-instance. הערך של הפרמטר צריך להיות אחד מהבאים:

    • ‫none: לא תתבצע פעולה.
    • ‫refresh: החלת עדכונים שאפשר להחיל בלי לעצור את המכונה.
    • ‫restart: עוצרים את המכונה ומפעילים אותה מחדש.
    • ‫replace: יוצרים מחדש את המכונה.

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

דוגמה

האפליקציה שלכם נחשפה למשתמשים דרך כתובות IP חיצוניות סטטיות ספציפיות שפורסמו של המכונות הווירטואליות בקבוצת מכונות מנוהלת (MIG) בשם example-group. שיניתם את הארכיטקטורה של השירות על ידי פריסת מאזן עומסים לפני קבוצת ה-MIG וניתוב התנועה למכונות הווירטואליות המנוהלות דרכו. אתם לא צריכים יותר לתחזק את כתובות ה-IP החיצוניות הסטטיות, ואתם רוצים להפוך את כתובות ה-IP החיצוניות של המכונות הווירטואליות לזמניות.

כדי להפוך את כתובות ה-IP החיצוניות של המכונות הווירטואליות בקבוצת MIG לזמניות, מריצים את הפקודה הבאה לכל מכונה, לדוגמה, ל-node-1:

gcloud compute instance-groups managed instance-configs update example-group \
    --instance node-1 \
    --remove-stateful-external-ips nic0 \
    --update-instance

הפקודה מבצעת את הפעולות הבאות:

  1. הסרת ההגדרה של שמירת המצב של כתובת ה-IP החיצונית בממשק הרשת nic0 מההגדרה לכל מכונה של node-1.
  2. העדכון של ההגדרה לכל מכונה חל על מכונה וירטואלית אחת (node-1) באופן מיידי, כי הדגל --update-instance נכלל. מכונת ה-VM לא מופרעת וממשיכה להגיש מאותה כתובת IP, שכבר לא שומרת מצב. קבוצת ה-MIG מסירה את ההפניה לכתובת ה-IP הסטטית השמורה מה-preservedStateFromConfig של המכונה המנוהלת, ומתייחסת לכתובת ה-IP החיצונית ככתובת ארעית. קבוצת ה-MIG תקצה באופן אוטומטי כתובת IP חיצונית באירועים הבאים של יצירה מחדש, עדכון או תיקון אוטומטי של מכונות.
  3. אחרי ביטול ההקצאה, כתובת ה-IP הסטטית המקורית נשארת שמורה. אם אתם לא צריכים יותר את כתובת ה-IP, אתם יכולים לשחרר אותה.

REST

כדי להסיר הגדרת IP עם שמירת מצב מההגדרה המשויכת לכל מכונה, משתמשים ב-method instanceGroupManagers.patchPerInstanceConfigs או ב-method regionInstanceGroupManagers.patchPerInstanceConfigs:

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

{
  "perInstanceConfigs": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : null
        },
        "externalIPs": {
          "NI_NAME" : null
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

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

  • ‫PROJECT_ID: מזהה הפרויקט של הבקשה.
  • ‫NAME: השם של ה-MIG.
  • ‫REGION: בקבוצות MIG אזוריות, האזור שבו נמצאת הקבוצה. בקבוצות MIG של אזור, מחליפים את regions/REGION ב-zones/ZONE ומציינים את האזור שבו נמצאת קבוצת ה-MIG.
  • ‫INSTANCE_NAME: (חובה) שם המכונה שממנה רוצים להסיר את הגדרת ה-IP עם שמירת המצב.
  • ‫NI_NAME: (חובה) שם ממשק הרשת. ממשק הרשת הראשי נקרא nic0. אם יש לכם כמה ממשקי רשת, אתם יכולים לציין כמה ערכים של NI_NAMES.
  • ‫FINGERPRINT: (אופציונלי) טביעת האצבע של ההגדרה הנתונה, אם היא כבר קיימת. משמש לנעילה אופטימית. הפעולה תיכשל אם טביעת האצבע שונה מזו שסופקה, כי זה מצביע על כך שההגדרות האישיות של המכונה השתנו מאז הפעם האחרונה שהן נקראו. כדי לראות את טביעת האצבע האחרונה, צריך לבדוק את הפלט של השיטה listPerInstanceConfigs בקבוצת MIG אזורית או בתוך אזור. אם משמיטים את fingerprint, הפעולה ממשיכה בלי השוואת טביעות אצבע.

ה-method‏ patchPerInstanceConfigs מעדכנת את ההגדרות האישיות שצוינו לכל מכונה, אבל לא מחילה את עדכוני ההגדרות האישיות על המכונות המנוהלות המשויכות. השינויים חלים על מכונה כשה-MIG מקבל הוראה ליצור מחדש או לעדכן את המכונה. כדי להחיל את השינויים על מכונה, אפשר להחיל את העדכון באופן ידני.

דוגמה

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

כדי להפוך את כתובות ה-IP החיצוניות עם שמירת המצב של המכונות הווירטואליות בקבוצת MIG לזמניות, מריצים את השיטה הבאה לכל מכונה, למשל ל-node-1, ומספקים את הערך null להגדרת שמירת המצב של ממשק הרשת:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "node-1",
      "preservedState" : {
        "externalIPs": {
          "nic0" : null
        }
      }
    }
  ]
}

השיטה מסירה את ההגדרות של כתובת ה-IP עם המצב בממשק הרשת nic0 מההגדרות לכל מכונה של node-1. עדכון ההגדרות עדיין לא הוחל על המכונה הווירטואלית node-1. קבוצת המכונות המנוהלת תחיל את עדכון ההגדרות בפעם הבאה שהמכונה תיווצר מחדש או תעודכן.

כדי להחיל את עדכון ההגדרות לכל מכונה על המכונה הווירטואלית node-1, מריצים את ה-method‏ regionInstanceGroupManagers.applyUpdatesToInstances במכונה:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group/applyUpdatesToInstances

{
  "instances": ["/zones/us-east1-c/instances/node-1"]
}

קבוצת ה-MIG מסירה את ההפניה להקצאת כתובת ה-IP הסטטית מהשדה preservedStateFromConfig של המכונה node-1, ומתייחסת לכתובת ה-IP ככתובת ארעית. קבוצת ה-MIG תקצה באופן אוטומטי כתובת IP חיצונית באירועים הבאים של יצירה מחדש, עדכון או תיקון אוטומטי של מכונות.

אחרי ביטול ההקצאה, כתובת ה-IP הסטטית המקורית נשארת שמורה. אם אתם לא צריכים יותר את כתובת ה-IP, אתם יכולים לשחרר אותה.

הסרת הגדרות עם שמירת מצב

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

כדי להסיר הגדרה מתוך הגדרה לכל מכונה של VM ספציפי ב-MIG, עיינו במסמכים הבאים:

ניקוי כתובות IP סטטיות שלא בשימוש

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

  • כדי לשחרר באופן אוטומטי את כתובות ה-IP הסטטיות השמורות כשמוחקים מכונות באופן סופי, מגדירים את הפרמטר autoDelete לערך ON_PERMANENT_INSTANCE_DELETION.
  • כדי לשחרר ידנית את ההקצאות של כתובות ה-IP הסטטיות, מגדירים את הפרמטר autoDelete לערך NEVER. כדי לנקות כתובות IP סטטיות שמורות שלא בשימוש, למשל כדי להימנע מחיובים מיותרים, אפשר להיעזר במאמרים הבאים:

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

משוב

נשמח לשמוע על תרחישי השימוש שלכם, על האתגרים שבהם נתקלתם ועל המשוב שלכם לגבי קבוצות MIG עם שמירת מצב. אתם יכולים לשלוח משוב לצוות שלנו בכתובת mig-discuss@google.com.

המאמרים הבאים