הפעלת כיבוי מבוקר במכונה של Compute Engine

המסוף

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

   כניסה לדף VM instances

2. בעמודה Name (שם), לוחצים על השם של המכונה שבה רוצים להפעיל כיבוי מבוקר.

   ייפתח דף הפרטים של המופע.

3. לוחצים על edit עריכה.

4. בקטע ניהול, מבצעים את הפעולות הבאות:

   1. מסמנים את תיבת הסימון Gracefully shut down the VM (כיבוי תקין של המכונה הווירטואלית).

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

5. לוחצים על Save.

gcloud

כדי להפעיל כיבוי מבוקר במכונה קיימת, משתמשים בפקודה gcloud beta compute instances update עם הדגל --graceful-shutdown:

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --zone=ZONE

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

• ‫INSTANCE_NAME: השם של המכונה.

• ‫ZONE: האזור שבו נמצאת המכונה.

אפשר גם לציין תקופה מותאמת אישית לכיבוי מבוקר באמצעות הדגל --graceful-shutdown-max-duration:

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --zone=ZONE

מחליפים את MAX_DURATION במשך הזמן של תקופת ההשבתה. הערך צריך להיות בפורמט של מספר השעות, הדקות או השניות, ואחריו h, m או s בהתאמה. לדוגמה, מציינים 1h לשעה אחת או 20m10s ל-20 דקות ו-10 שניות.

REST

1. יוצרים קובץ JSON ריק.

2. כדי לראות את המאפיינים של מכונה קיימת, שולחים בקשת GET אל ה-method‏ instances.get בגרסת הבטא:

   GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
   

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

   • ‫PROJECT_ID: מזהה הפרויקט שבו נמצא המופע.

   • ‫ZONE: האזור שבו נמצאת המכונה.

   • ‫INSTANCE_NAME: השם של מופע קיים.

3. בקובץ ה-JSON הריק שיצרתם בשלבים הקודמים, מבצעים את הפעולות הבאות:

   1. מזינים את פרטי ההגדרה של המופע מתוך הפלט של בקשת GET.

   2. בשדה scheduling, מוסיפים את השדה gracefulShutdown באופן הבא:

      {
        ...
        "scheduling": {
          ...
          "gracefulShutdown": {
            "enabled": true
          }
        },
        ...
      }
      

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

      {
        ...
        "scheduling": {
          ...
          "gracefulShutdown": {
            ...
            "enabled": true,
            "maxDuration": {
              "seconds": "MAX_DURATION"
            }
          }
        },
        ...
      }
      

      מחליפים את MAX_DURATION במשך הזמן בשניות של תקופת הכיבוי המבוקר. הערך צריך להיות בין 1 ל-3600, כלומר 3,600 שניות (שעה).

4. כדי לעדכן את המכונה ולהפעיל אותה מחדש, שולחים בקשת PUT אל ה-method‏ instances.update בגרסת הבטא. בבקשה, מבצעים את הפעולות הבאות:

   • בכתובת ה-URL של הבקשה, כוללים את פרמטר השאילתה mostDisruptiveAllowedAction שמוגדר לערך RESTART.

   • בגוף הבקשה, כוללים את מאפייני המופע מקובץ ה-JSON שיצרתם ועדכנתם בשלבים הקודמים.

   בקשת PUT לעדכון המופע דומה לבקשה הבאה:

   PUT https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART
   
   {
     ...
     "scheduling": {
       ...
       "gracefulShutdown": {
         "enabled": true
       }
     },
     ...
   }
   

המסוף

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

   כניסה לדף VM instances

2. לוחצים על Create instance.

   ייפתח הדף Create an instance.

3. מציינים שם למכונה.

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

5. מציינים את סוג המכונה של המופע.

6. בתפריט הניווט, לוחצים על מתקדם.

7. מרחיבים את הקטע expand_more VM provisioning model advanced settings (הגדרות מתקדמות של מודל הקצאת מכונות וירטואליות) ומבצעים את הפעולות הבאות:

   1. מסמנים את תיבת הסימון Gracefully shut down the VM (כיבוי תקין של המכונה הווירטואלית).

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

8. לוחצים על יצירה.

gcloud

כדי ליצור מכונה עם השבתה הדרגתית, משתמשים בפקודה gcloud beta compute instances create עם הדגל --graceful-shutdown:

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

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

• ‫INSTANCE_NAME: השם של המכונה.

• ‫MACHINE_TYPE: סוג המכונה שבה רוצים להשתמש עבור המופע.

• ‫ZONE: האזור שבו רוצים ליצור את המכונה.

אפשר גם לציין תקופה מותאמת אישית לכיבוי מבוקר באמצעות הדגל --graceful-shutdown-max-duration:

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

מחליפים את MAX_DURATION במשך הזמן של תקופת ההשבתה ההדרגתית. הערך צריך להיות בפורמט של מספר השעות, הדקות או השניות, ואחריו h, m או s בהתאמה. לדוגמה, אפשר לציין 1h לשעה אחת, או 20m10s ל-20 דקות ו-10 שניות.

REST

כדי ליצור מכונה עם הפעלה של כיבוי תקין, שולחים בקשת POST אל ה-method‏ beta.instances.insert. בגוף הבקשה, כוללים את השדה gracefulShutdown:

POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "gracefulShutdown": {
      "enabled": true
    }
  }
}

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

• ‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את המכונה.

• ‫ZONE: האזור שבו רוצים ליצור את המכונה.

• ‫INSTANCE_NAME: השם של המכונה.

• ‫MACHINE_TYPE: סוג המכונה של המופע.

• ‫IMAGE_PROJECT: פרויקט התמונה שמכיל את התמונה, לדוגמה debian-cloud. מידע נוסף על פרויקטים של תמונות נתמכות זמין במאמר תמונות ציבוריות.

• ‫IMAGE: מציינים אחת מהאפשרויות הבאות:

  • גרסה ספציפית של תמונת מערכת ההפעלה – לדוגמה, debian-12-bookworm-v20240617.

  • משפחת תמונות, שצריכה להיות בפורמט family/IMAGE_FAMILY. הפורמט הזה מציין את תמונת מערכת ההפעלה העדכנית ביותר שלא הוצאה משימוש. לדוגמה, אם מציינים family/debian-12, נעשה שימוש בגרסה האחרונה במשפחת קובצי האימג' של Debian 12. מידע נוסף על שימוש במשפחות של תמונות זמין במאמר בנושא שיטות מומלצות לשימוש במשפחות של תמונות.

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

POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  }
}

מחליפים את MAX_DURATION במשך הזמן בשניות של תקופת הכיבוי המבוקר. הערך צריך להיות בין 1 ל-3600, כלומר 3,600 שניות (שעה).

המסוף

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

   כניסה לדף Instance templates

2. לוחצים על Create instance template.

   ייפתח הדף יצירת תבנית של הגדרות מכונה.

3. בשדה Name, מזינים שם לתבנית של הגדרות מכונה.

4. בוחרים את המיקום באופן הבא:

   • כדי לצמצם את התלות בין אזורים על ידי יצירת תבנית של מופע אזורי:

     1. בוחרים באפשרות Regional (אזורי), אם היא לא מסומנת.

     2. בשדה אזור, בוחרים את האזור שבו רוצים ליצור את תבנית של הגדרות מכונה.

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

5. בקטע Machine configuration, מציינים את סוג המכונה.

6. מרחיבים את הקטע expand_more VM provisioning model advanced settings (הגדרות מתקדמות של מודל הקצאת מכונות וירטואליות) ומבצעים את הפעולות הבאות:

   1. מסמנים את תיבת הסימון Gracefully shut down the VM (כיבוי תקין של המכונה הווירטואלית).

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

7. לוחצים על יצירה.

gcloud

כדי ליצור תבנית של הגדרות מכונה שמופעל בה כיבוי מבוקר, משתמשים בפקודה gcloud beta compute instance-templates create עם הדגל --graceful-shutdown.

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

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

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

• ‫INSTANCE_TEMPLATE_NAME: השם של תבנית הגדרות המכונה.

• ‫REGION: האזור שבו רוצים ליצור את תבנית הגדרות המכונה.

• ‫MACHINE_TYPE: סוג המכונה של המכונות שנוצרו באמצעות תבנית של הגדרות מכונה.

אפשר גם לציין תקופת השבתה מדורגת בהתאמה אישית באמצעות הדגל --graceful-shutdown-max-duration.

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

מחליפים את MAX_DURATION במשך הזמן של תקופת ההשבתה. הערך צריך להיות בפורמט של מספר השעות, הדקות או השניות, ואחריו h, m או s בהתאמה. לדוגמה, מציינים 1h לשעה אחת או 20m10s ל-20 דקות ו-10 שניות.

REST

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

• כדי ליצור תבנית של הגדרות מכונה גלובלית: שיטה instanceTemplates.insert בגרסת בטא.

• כדי ליצור תבנית של הגדרות מכונה אזורית: שיטה regionInstanceTemplates.insert בטא.

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

POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

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

• ‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את תבנית של הגדרות מכונה.

• ‫REGION: האזור שבו רוצים ליצור את תבנית המכונה.

• ‫INSTANCE_TEMPLATE_NAME: השם של תבנית הגדרות המכונה.

• ‫IMAGE_PROJECT: פרויקט התמונה שמכיל את התמונה, לדוגמה debian-cloud. מידע נוסף על פרויקטים של תמונות נתמכות זמין במאמר תמונות ציבוריות.

• ‫IMAGE: מציינים אחת מהאפשרויות הבאות:

  • גרסה ספציפית של תמונת מערכת ההפעלה – לדוגמה, debian-12-bookworm-v20240617.

  • משפחת תמונות, שצריכה להיות בפורמט family/IMAGE_FAMILY. הפורמט הזה מציין את תמונת מערכת ההפעלה העדכנית ביותר שלא הוצאה משימוש. לדוגמה, אם מציינים family/debian-12, נעשה שימוש בגרסה האחרונה במשפחת קובצי האימג' של Debian 12. מידע נוסף על שימוש במשפחות של תמונות זמין במאמר בנושא שיטות מומלצות לשימוש במשפחות של תמונות.

• ‫MACHINE_TYPE: סוג המכונה של המכונות שנוצרו באמצעות תבנית של הגדרות מכונה.

אם רוצים לציין תקופת השבתה הדרגתית בהתאמה אישית, צריך לכלול את השדה maxDuration בגוף הבקשה.

POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

מחליפים את MAX_DURATION במשך הזמן בשניות של תקופת ההשבתה. הערך צריך להיות בין 1 ל-3600, כלומר 3,600 שניות (שעה אחת).