הפעלת PMU במכונות Compute Engine

במאמר הזה מוסבר איך להפעיל את יחידת המעקב אחר ביצועים (PMU) במכונות Compute Engine מסוג A4X,‏ C4A,‏ C4 או M4. אחרי שמפעילים את ה-PMU, אפשר להשתמש בו כדי לבצע אופטימיזציה של עומסי עבודה שרגישים לביצועים, כמו מחשוב עתיר ביצועים (HPC) או למידת מכונה (ML), על ידי זיהוי צווארי בקבוק באפליקציה וטיפול בהם.

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

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

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

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

    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 .

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

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

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

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

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

  • כדי ליצור מכונות וירטואליות:
    • ‫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 במכונת החישוב

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

הפעלת ה-PMU במכונות וירטואליות

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

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

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

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

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

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

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

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

    2. אם פלטפורמת CPU נתמכת לא זמינה באזור של מופע Compute, צריך להעביר את מופע Compute לאזור שבו יש פלטפורמת CPU נתמכת.

    3. שינוי סוג המכונה. כדי להפעיל את סוג ה-PMU הארכיטקטוני או הרגיל, אפשר לציין כל סוג מכונה A4X,‏ C4A,‏ C4 או M4. עם זאת, כדי להפעיל את סוג ה-PMU המשופר, צריך לציין אחד מסוגי המכונות הבאים C4 או M4:

      • כל סוג מכונה C4 עם 144 או 288 מעבדי vCPU

      • אחד מסוגי המכונות הבאים מסדרת M4:

        • m4-megamem-112

        • m4-megamem-224

        • m4-ultramem-56

        • m4-ultramem-112

        • m4-ultramem-224

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

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

gcloud

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

  2. כדי לייצא את המאפיינים של מכונת Compute לקובץ ה-YAML שיצרתם, משתמשים בפקודה gcloud compute instances export:

    gcloud compute instances export INSTANCE_NAME \
    --destination=YAML_FILE \
    --zone=ZONE

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

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

    • ‫YAML_FILE: הנתיב לקובץ ה-YAML שיצרתם בשלב הקודם.

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

  3. בקובץ התצורה של YAML, בשדה advancedMachineFeatures מוסיפים את השדה performanceMonitoringUnit. אם השדה advancedMachineFeatures לא קיים, מוסיפים אותו גם כן:

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

    מחליפים את PMU_TYPE באחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: ARCHITECTURAL

    • סוג PMU רגיל: STANDARD

    • סוג משופר של PMU: ENHANCED

  4. כדי לעדכן את מכונת ה-Compute ולהפעיל אותה מחדש, משתמשים בפקודה gcloud compute instances update-from-file עם הדגל --most-disruptive-allowed-action שמוגדר לערך RESTART:

    gcloud compute instances update-from-file INSTANCE_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    מחליפים את YAML_FILE בנתיב לקובץ ה-YAML עם נתוני ההגדרות ששיניתם בשלב הקודם.

REST

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

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

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

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

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

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

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

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

    • בגוף הבקשה, משתמשים בGETפלט הבקשה מהשלב הקודם. אבל בשדה advancedMachineFeatures, צריך להוסיף את השדה performanceMonitoringUnit כדי להפעיל את ה-PMU. אם השדה advancedMachineFeatures לא קיים בפלט של הבקשה, צריך להוסיף אותו גם כן:

    בקשת PUT דומה לבקשה הבאה:

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

{
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  },
  ...
}

    מחליפים את PMU_TYPE באחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: ARCHITECTURAL

    • סוג PMU רגיל: STANDARD

    • סוג משופר של PMU: ENHANCED

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

הפעלת ה-PMU בזמן יצירת מכונת חישוב

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

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

gcloud

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

gcloud compute instances create INSTANCE_NAME \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

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

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

  • ‫MACHINE_TYPE: סוג המכונה של מופע Compute. כדי להפעיל את סוג ה-PMU המשופר במכונה של Compute Engine, צריך להשתמש בסוג מכונה נתמך.

  • ‫PMU_TYPE: סוג ה-PMU שרוצים להפעיל במופע של Compute. מציינים את אחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: architectural

    • סוג PMU רגיל: standard

    • סוג משופר של PMU: enhanced

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

REST

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

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"
    }
  ],
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  }
}

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

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

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

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

  • ‫MACHINE_TYPE: סוג המכונה של מופע Compute. אם רוצים להפעיל את סוג ה-PMU המשופר במופע של Compute, אפשר להפעיל אותו רק אם המופע של Compute משתמש בסוג מכונה נתמך.

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

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

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

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

  • ‫PMU_TYPE: סוג ה-PMU שרוצים להפעיל במכונה הווירטואלית של Compute Engine. מציינים אחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: ARCHITECTURAL

    • סוג PMU רגיל: STANDARD

    • סוג PMU משופר: ENHANCED

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

הפעלת ה-PMU כשיוצרים כמה מופעי מחשוב בו-זמנית

אפשר ליצור כמה מכונות Compute Engine עם PMU מופעל רק באזור שכולל פלטפורמת מעבד נתמכת. ברשימת האזורים והתחומים הזמינים מפורטים המעבדים (CPU) שזמינים בכל תחום.

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

gcloud

כדי ליצור כמות גדולה של מכונות וירטואליות עם PMU מופעל, משתמשים בפקודה gcloud compute instances bulk create עם הדגל --performance-monitoring-unit.

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

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

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

  • ‫COUNT: מספר מופעי Compute שרוצים ליצור.

  • ‫MACHINE_TYPE: סוג המכונה של מופעי Compute. אם רוצים להפעיל את סוג ה-PMU המשופר במופע של Compute, אפשר להפעיל אותו רק אם המופע של Compute משתמש בסוג מכונה נתמך.

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

  • ‫PMU_TYPE: סוג ה-PMU שרוצים להפעיל במופעי Compute. מציינים אחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: architectural

    • סוג PMU רגיל: standard

    • סוג משופר של PMU: enhanced

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

REST

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

לדוגמה, כדי ליצור מכונות וירטואליות בכמות גדולה באזור אחד ולציין תבנית שם, שולחים בקשת 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"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

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

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

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

  • ‫COUNT: מספר מופעי Compute שרוצים ליצור.

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

  • ‫MACHINE_TYPE: סוג המכונה של מכונות ה-Compute. אם רוצים להפעיל את סוג ה-PMU המשופר במופע של Compute, אפשר להפעיל אותו רק אם המופע של Compute משתמש בסוג מכונה נתמך.

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

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

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

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

  • ‫PMU_TYPE: סוג ה-PMU שרוצים להפעיל במכונות הווירטואליות של Compute Engine. מציינים אחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: ARCHITECTURAL

    • סוג PMU רגיל: STANDARD

    • סוג משופר של PMU: ENHANCED

מידע נוסף על יצירת מכונות וירטואליות בכמות גדולה זמין במאמר יצירת מכונות וירטואליות בכמות גדולה.

הפעלת ה-PMU במהלך יצירת תבנית של הגדרות מכונה

אם רוצים ליצור תבנית של הגדרות מכונה אזורית שבה מוגדרת הפעלה של ה-PMU, צריך לוודא שלפחות תחום (zone) אחד בתוך האזור שנבחר מכיל פלטפורמת מעבד נתמכת. רשימת המעבדים הזמינים לפי אזור מופיעה במאמר אזורים ותחומים זמינים.

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

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

gcloud

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

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

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE

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

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

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

  • ‫MACHINE_TYPE: סוג המכונה של מכונות ה-Compute. כדי להפעיל את סוג ה-PMU המשופר במכונה של Compute Engine, צריך להשתמש בסוג מכונה נתמך.

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

    • סוג PMU ארכיטקטוני: architectural

    • סוג PMU רגיל: standard

    • סוג משופר של PMU: enhanced

REST

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

בגוף הבקשה, כוללים את השדה performanceMonitoringUnit.

לדוגמה, כדי ליצור תבנית של הגדרות מכונה אזורית שמציינת הפעלה של PMU, שולחים בקשת 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"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

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

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

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

    • סוג PMU ארכיטקטוני: ARCHITECTURAL

    • סוג PMU רגיל: STANDARD

    • סוג משופר של PMU: ENHANCED

מידע נוסף על יצירת תבנית של הגדרות מכונה זמין במאמר יצירת תבניות של הגדרות מכונה.

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