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

במאמר הזה מוסבר איך להפעיל כיבוי מבוקר במכונה חדשה או קיימת של Compute Engine.

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

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

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא התהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים האלה:

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.

    gcloud

    1. התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה: 

      gcloud init

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  • הגדרת אזור ותחום כברירת מחדל.

    • REST

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

      התקינו את ה-CLI של Google Cloud.

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות להפעלת כיבוי מבוקר במכונה, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין מכונות של Compute ‏ (v1) (roles/compute.instanceAdmin.v1) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות כדי להפעיל כיבוי מבוקר במכונה של Compute Engine. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

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

  • כדי ליצור מכונות Compute:
    • ‫compute.instances.create בפרויקט
    • כדי להשתמש באימג' בהתאמה אישית ליצירת המכונה הווירטואלית (VM)‏: compute.images.useReadOnly בקובץ אימג'
    • כדי להשתמש ב-snapshot ליצירת המכונה הווירטואלית: compute.snapshots.useReadOnly בקובץ snapshot
    • כדי להשתמש בתבנית של הגדרות מכונה ליצירת המכונה הווירטואלית: compute.instanceTemplates.useReadOnly בתבנית של הגדרות המכונה
    • כדי להקצות רשת מדור קודם למכונה הווירטואלית: ‫compute.networks.use בפרויקט
    • כדי לציין כתובת IP סטטית למכונה הווירטואלית: compute.addresses.use בפרויקט
    • כדי להקצות כתובת IP חיצונית למכונה הווירטואלית כשמשתמשים ברשת מדור קודם: compute.networks.useExternalIp בפרויקט
    • כדי לציין רשת משנה למכונה הווירטואלית: compute.subnetworks.use בפרויקט או ברשת המשנה שנבחרה
    • כדי להקצות כתובת IP חיצונית למכונה הווירטואלית כשמשתמשים ברשת VPC: compute.subnetworks.useExternalIp בפרויקט או ברשת המשנה שנבחרה
    • כדי להגדיר מטא-נתונים של המכונה הווירטואלית: compute.instances.setMetadata בפרויקט
    • כדי להגדיר תגים למכונה הווירטואלית: compute.instances.setTags במכונה הווירטואלית
    • כדי להגדיר תוויות למכונה הווירטואלית: compute.instances.setLabels במכונה הווירטואלית
    • כדי להגדיר חשבון שירות לשימוש של המכונה הווירטואלית: compute.instances.setServiceAccount במכונה הווירטואלית
    • כדי ליצור דיסק חדש למכונה הווירטואלית: compute.disks.create בפרויקט
    • כדי לצרף דיסק קיים במצב קריאה-בלבד או במצב קריאה וכתיבה: compute.disks.use בדיסק
    • כדי לצרף דיסק קיים במצב קריאה-בלבד: compute.disks.useReadOnly בדיסק
  • כדי ליצור תבנית של הגדרות מכונה: ‫compute.instanceTemplates.create בפרויקט
  • כדי להפעיל כיבוי מבוקר במכונה קיימת: compute.instances.update במכונה

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

הפעלת כיבוי מבוקר

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

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

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

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

המסוף

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

    כניסה לדף VM instances

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

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

  4. בקטע Management:

    1. מסמנים את התיבה Gracefully shut down the VM.

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

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

gcloud

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

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

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

  • ‫INSTANCE_NAME: השם של המכונה הווירטואלית.

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

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

REST

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

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

    GET https://compute.googleapis.com/compute/v1/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": {
        "seconds": "MAX_DURATION"
      }
    }
  },
  ...
}

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

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

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

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

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

    PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART

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

למידע נוסף על עדכון המאפיינים של מכונה וירטואלית, ראו עדכון מאפיינים של מכונה וירטואלית.

הפעלת כיבוי מבוקר בזמן יצירת מכונה

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

המסוף

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

    כניסה לדף VM instances

  2. לוחצים על Create instance. נפתח הדף Create an instance.

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

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

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

  6. מרחיבים את הקטע VM provisioning model advanced settings ומבצעים את הפעולות הבאות:

    1. מסמנים את התיבה Gracefully shut down the VM.

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

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

gcloud

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

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

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

  • ‫INSTANCE_NAME: השם של המכונה הווירטואלית.

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

  • ‫MACHINE_TYPE: סוג המכונה שבה משתמשים.

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

REST

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

POST https://compute.googleapis.com/compute/v1/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"
      }
    }
  }
}

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

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

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

  • ‫INSTANCE_NAME: השם של המכונה הווירטואלית.

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

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

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

    • גרסה ספציפית של קובץ האימג' של מערכת ההפעלה, לדוגמה debian-12-bookworm-v20240617.

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

  • ‫MAX_DURATION: משך הזמן המקסימלי של הכיבוי המבוקר, בשניות. הערך צריך להיות בין 1 (שנייה אחת) לבין 21600 (21,600 שניות, או שש שעות).

למידע נוסף על יצירת מכונה, ראו יצירת מכונה של Compute Engine והפעלה שלה.

הפעלת כיבוי מבוקר בזמן יצירת מכונות בכמות גדולה

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

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

gcloud

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

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

gcloud compute instances bulk create \
    --count=COUNT \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --zone=ZONE

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

  • ‫COUNT: מספר המכונות שרוצים ליצור.

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

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

  • ‫NAME_PATTERN: תבנית השם של המכונות. כדי להחליף רצף של מספרים בשם של מכונה, משתמשים ברצף של תווי סולמית (#). לדוגמה, אם משתמשים בתבנית השם instance-#, נוצרים מכונים עם שמות שמתחילים ב-instance-1, ב-instance-2 וכן הלאה, עד למספר המכונים שצוין ב-COUNT.

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

REST

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

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "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"
        }
      }
    }
  }
}

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

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

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

  • ‫COUNT: מספר המכונות שרוצים ליצור.

  • ‫NAME_PATTERN: תבנית השם של המכונות. כדי להחליף רצף של מספרים בשם של מכונה, משתמשים ברצף של תווי סולמית (#). לדוגמה, אם משתמשים בתבנית השם instance-#, נוצרים מכונים עם שמות שמתחילים ב-instance-1, ב-instance-2 וכן הלאה, עד למספר המכונים שצוין ב-COUNT.

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

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

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

    • גרסה ספציפית של קובץ האימג' של מערכת ההפעלה, לדוגמה debian-12-bookworm-v20240617.

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

  • ‫MAX_DURATION: משך הזמן המקסימלי של הכיבוי המבוקר, בשניות. הערך צריך להיות בין 1 (שנייה אחת) לבין 21600 (21,600 שניות, או שש שעות).

במאמר יצירת כמות גדולה של מכונות וירטואליות מפורטות אפשרויות הגדרה נוספות ליצירת כמות גדולה של מכונות.

הפעלת כיבוי מבוקר בזמן יצירת תבנית של הגדרות מכונה

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

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף תבניות של הגדרות מכונה.

    כניסה לדף Instance templates

  2. לוחצים על יצירת תבנית של הגדרות מכונה. מופיע הדף Create an instance template.

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

  4. בקטע Location, בוחרים אם ליצור תבנית של הגדרות מכונה אזורית או גלובלית, בהתאם לתרחיש לדוגמה:

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

      1. לוחצים על אזורי.

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

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

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

  6. מרחיבים את הקטע VM provisioning model advanced settings ומבצעים את הפעולות הבאות:

    1. מסמנים את התיבה Gracefully shut down the VM.

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

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

gcloud

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

לדוגמה, כדי ליצור תבנית של הגדרות מכונה אזורית שמופעל בה כיבוי מבוקר, מריצים את הפקודה הבאה. כדי ליצור תבנית גלובלית של הגדרות מכונה, משתמשים באותה פקודה בלי הדגל --instance-template-region.

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

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

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

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

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

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

REST

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

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

POST https://compute.googleapis.com/compute/v1/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,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

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

  • ‫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: סוג המכונה של המכונות שיוצרים באמצעות התבנית של הגדרות המכונה.

  • ‫MAX_DURATION: משך הזמן המקסימלי של הכיבוי המבוקר, בשניות. הערך צריך להיות בין 1 (שנייה אחת) לבין 21600 (21,600 שניות, או שש שעות).

במאמר יצירת תבניות של הגדרות מכונה מפורטות אפשרויות נוספות להגדרה של תבניות של הגדרות מכונה.

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