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

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

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

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

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

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

  gcloud

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

     gcloud init

     הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.
• הגדרת אזור ותחום כברירת מחדל.

REST

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

התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

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

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

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

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

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

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

• כדי ליצור מכונות:
  • ‫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 בזמן יצירת מכונה
• הפעלת ה-PMU בזמן יצירת מכונות בכמות גדולה
• הפעלת ה-PMU בזמן יצירת תבנית של הגדרות מכונה

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

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

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

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

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

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

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

  2. אם פלטפורמת המעבד (CPU) הנתמכת לא זמינה באזור של המכונה, העבירו את המכונה לאזור שיש בו פלטפורמת מעבד (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

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

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

gcloud

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

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

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

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

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

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

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

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

   advancedMachineFeatures:
     performanceMonitoringUnit: PMU_TYPE
   

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

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

   • סוג PMU רגיל: STANDARD

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

4. כדי לעדכן את המכונה ולהפעיל אותה מחדש, משתמשים בפקודה 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./compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
   

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

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

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

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

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

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

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

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

   PUT https://compute./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 בזמן יצירת מכונה

אפשר ליצור מכונה עם PMU רק באזור שכולל פלטפורמת מעבד (CPU) נתמכת. ברשימת האזורים והתחומים הזמינים מפורטים המעבדים (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: השם של המכונה.

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

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

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

  • סוג PMU רגיל: standard

  • סוג ה-PMU המשופר: enhanced

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

REST

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

POST https://compute./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: מזהה הפרויקט שבו רוצים ליצור את המכונה.

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

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

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

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

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

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

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

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

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

  • סוג PMU רגיל: STANDARD

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

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

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

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

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

gcloud

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

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

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

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

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

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

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

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

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

  • סוג PMU רגיל: standard

  • סוג ה-PMU המשופר: enhanced

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

REST

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

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

POST https://compute./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: האזור שבו יוצרים את המכונות בכמות גדולה.

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

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

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

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

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

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

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

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

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

  • סוג PMU רגיל: STANDARD

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

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

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

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

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

• כדי להפעיל את ה-PMU במכונות של קבוצת מופעי מכונה מנוהלים (MIG):

  • יצירת MIG

  • החלת הגדרות חדשות של מכונות ב-MIG

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

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

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

  • סוג PMU רגיל: standard

  • סוג ה-PMU המשופר: enhanced

REST

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

• כדי ליצור תבנית של הגדרות מכונה גלובלית: ה-method‏ instanceTemplates.insert.

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

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

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

POST https://compute./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 המשופר במכונה, אפשר להפעיל אותו רק אם המכונה משתמשת בסוג מכונה נתמך.

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

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

  • סוג PMU רגיל: STANDARD

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

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

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

• התחברות למכונה

• שינוי סוג ה-PMU במכונה או השבתת ה-PMU