הפחתת זמן האחזור באמצעות מדיניות למיקום קומפקטי

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

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

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

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

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

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

  • כדי ליצור כללי מדיניות מיקום: ‫compute.resourcePolicies.create בפרויקט
  • כדי להחיל מדיניות מיקום על מכונות קיימות: compute.instances.addResourcePolicies בפרויקט
  • כדי ליצור מכונות:
    • ‫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.reservations.create בפרויקט
  • כדי ליצור תבנית של הגדרות מכונה: ‫compute.instanceTemplates.create בפרויקט
  • כדי ליצור MIG: ‫compute.instanceGroupManagers.create בפרויקט
  • כדי לראות את הפרטים של מכונה: compute.instances.get בפרויקט

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

יצירת מדיניות למיקום קומפקטי

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

  • אם רוצים להחיל מדיניות למיקום קומפקטי על מכונה שהיא לא מסוג M3,‏ M2,‏ M1,‏ N2D או N2, צריך לבצע את אחת מהפעולות הבאות בהתאם לסוג המכונה:

  • אם אתם רוצים להחיל מדיניות למיקום קומפקטי על מכונה מסוג A3 Mega,‏ A3 High או A3 Edge שנוצרה לפני 1 באוקטובר 2025, פנו לצוות ניהול החשבון.

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

gcloud

  • כדי להחיל את המדיניות למיקום קומפקטי על מכונות M3,‏ M2,‏ M1,‏ N2D או N2, או כדי ליצור מדיניות בלי לציין ערך למרחק המקסימלי, משתמשים בפקודה gcloud compute resource-policies create group-placement עם הדגל --collocation=collocated.

    gcloud compute resource-policies create group-placement POLICY_NAME \
        --collocation=collocated \
        --region=REGION
    

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

    • ‫POLICY_NAME: השם של המדיניות למיקום קומפקטי.

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

  • כדי להחיל את המדיניות למיקום קומפקטי על מכונות A4X Max או A4X עצמאיות, משתמשים בפקודה gcloud compute resource-policies create group-placement עם הדגלים --collocation=collocated ו---gpu-topology=1x72.

    gcloud compute resource-policies create group-placement POLICY_NAME \
        --collocation=collocated \
        --gpu-topology=1x72 \
        --region=REGION
    
  • כדי להחיל מדיניות למיקום קומפקטי עם ערך מרחק מקסימלי על סדרת מכונות נתמכת, משתמשים בפקודה gcloud beta compute resource-policies create group-placement עם הדגלים --collocation=collocated ו---max-distance.

    gcloud beta compute resource-policies create group-placement POLICY_NAME \
        --collocation=collocated \
        --max-distance=MAX_DISTANCE \
        --region=REGION
    

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

  • ‫POLICY_NAME: השם של המדיניות למיקום קומפקטי.

  • ‫MAX_DISTANCE: הגדרת המרחק המקסימלי למכונות שלכם. הערך צריך להיות בין 1, שמציין שהמכונות ימוקמו באותו בלוק משנה כדי שהזמן האחזור ברשת יהיה הכי נמוך שאפשר, לבין 3, שמציין שהמכונות ימוקמו באותו אשכול. אם רוצים להחיל את המדיניות למיקום קומפקטי על הזמנה, אפשר לציין רק את הערך 3 או 2.

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

REST

  • כדי להחיל את המדיניות למיקום קומפקטי על מכונות M3,‏ M2,‏ M1,‏ N2D או N2, או כדי ליצור מדיניות בלי לציין ערך למרחק המקסימלי, שולחים בקשת POST לשיטה resourcePolicies.insert. בגוף הבקשה, כוללים את השדה collocation ומגדירים אותו ל-COLLOCATED.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies
    
    {
      "name": "POLICY_NAME",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      }
    }
    
  • כדי להחיל את המדיניות למיקום קומפקטי על מכונות עצמאיות מסוג A4X Max או A4X, שולחים בקשת POST אל ה-method‏ resourcePolicies.insert. בגוף הבקשה, כוללים את השדה collocation שמוגדר ל-COLLOCATED ואת השדה gpuTopology שמוגדר ל-1x72.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies
    
    {
      "name": "POLICY_NAME",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED",
        "gpuTopology": "1x72"
      }
    }
    
  • כדי להחיל מדיניות למיקום קומפקטי עם ערך מרחק מקסימלי על סדרת מכונות נתמכת, שולחים בקשת POST אל ה-method‏ beta.resourcePolicies.insert. בגוף הבקשה, כוללים את הפרטים הבאים:

    • השדה collocation מוגדר ל-COLLOCATED.

    • השדה maxDistance.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
    
    {
      "name": "POLICY_NAME",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED",
        "maxDistance": MAX_DISTANCE
      }
    }
    

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

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

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

  • ‫MAX_DISTANCE: הגדרת המרחק המקסימלי למכונות שלכם. הערך צריך להיות בין 1, שמציין שהמכונות ימוקמו באותו בלוק משנה כדי שהזמן האחזור ברשת יהיה הכי נמוך שאפשר, לבין 3, שמציין שהמכונות ימוקמו באותו אשכול. אם רוצים להחיל את המדיניות למיקום קומפקטי על הזמנה, אפשר לציין רק את הערך 3 או 2.

החלת מדיניות למיקום קומפקטי

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

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

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

החלת המדיניות על מכונה קיימת

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

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

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

gcloud

  1. עוצרים את המכונה.

  2. כדי להחיל מדיניות למיקום קומפקטי על מכונה קיימת, משתמשים בפקודה gcloud compute instances add-resource-policies.

    gcloud compute instances add-resource-policies INSTANCE_NAME \
        --resource-policies=POLICY_NAME \
        --zone=ZONE
    

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

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

    • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

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

  3. מפעילים מחדש את המכונה.

REST

  1. עוצרים את המכונה.

  2. כדי להחיל מדיניות למיקום קומפקטי על מכונה קיימת, שולחים בקשת POST ל-method‏ instances.addResourcePolicies.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addResourcePolicies
    
    {
      "resourcePolicies": [
        "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
      ]
    }
    

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

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

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

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

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

    • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

  3. מפעילים מחדש את המכונה.

החלת המדיניות בזמן יצירת מכונה

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

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

gcloud

כדי ליצור מכונה שמציינת מדיניות למיקום קומפקטי, משתמשים בפקודה gcloud compute instances create עם הדגלים --maintenance-policy ו---resource-policies.

gcloud compute instances create INSTANCE_NAME \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

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

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

  • ‫MAINTENANCE_POLICY: מדיניות התחזוקה של המארח של המכונה. אם במדיניות למיקום קומפקטי שהגדרתם ערך המרחק המקסימלי הוא 1 או 2, או אם סוג המכונה שבחרתם לא תומך במיגרציה פעילה, אתם יכולים להגדיר רק TERMINATE. אחרת, אפשר לציין MIGRATE או TERMINATE.

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

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

REST

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

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"
    }
  ],
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  "scheduling": {
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

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

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

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

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

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

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

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

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

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

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

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

  • ‫MAINTENANCE_POLICY: מדיניות התחזוקה של המארח של המכונה. אם במדיניות למיקום קומפקטי שהגדרתם ערך המרחק המקסימלי הוא 1 או 2, או אם סוג המכונה שבחרתם לא תומך במיגרציה פעילה, אתם יכולים להגדיר רק TERMINATE. אחרת, אפשר לציין MIGRATE או TERMINATE.

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

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

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

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

gcloud

כדי ליצור כמות גדולה של מכונות שמציינות מדיניות למיקום קומפקטי, משתמשים בפקודה gcloud compute instances bulk create עם הדגלים --maintenance-policy ו---resource-policies.

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

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

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

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

  • ‫MAINTENANCE_POLICY: מדיניות התחזוקה של המארח של המכונה. אם במדיניות למיקום קומפקטי שהגדרתם ערך המרחק המקסימלי הוא 1 או 2, או אם סוג המכונה שבחרתם לא תומך במיגרציה פעילה, אתם יכולים להגדיר רק TERMINATE. אחרת, אפשר לציין MIGRATE או TERMINATE.

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

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

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

REST

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

לדוגמה, כדי ליצור כמה מכונות באזור אחד ולציין תבנית שם למכונות, שולחים בקשת 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"
      }
    ],
    "resourcePolicies": [
      "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
    ],
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

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

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

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

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

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

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

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

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

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

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

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

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

  • ‫MAINTENANCE_POLICY: מדיניות התחזוקה של המארח של המכונה. אם במדיניות למיקום קומפקטי שהגדרתם ערך המרחק המקסימלי הוא 1 או 2, או שסוג המכונה שבחרתם לא תומך במיגרציה פעילה, אתם יכולים להגדיר רק את TERMINATE. אחרת, אפשר לציין MIGRATE או TERMINATE.

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

החלת המדיניות בזמן יצירת ההזמנה

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

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

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

המסוף

  1. פותחים את הדף Reservations במסוף Google Cloud .

    כניסה לדף Reservations

  2. לוחצים על ‎ Create reservation‎. ייפתח הדף Create a reservation.

  3. בשדה Name, נותנים שם לבקשה.

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

  5. בקטע Use with VM instance, בוחרים באפשרות Select specific reservation.

  6. בקטע VM instances and GPUs:

    1. בשדה Number of VM instances, כותבים כמה מכונות וירטואליות רוצים לשריין.

    2. מציינים סוג וסדרת מכונות שתומכים במדיניות למיקום קומפקטי.

  7. בקטע Group placement policy, לוחצים על הרשימה Select or create a group placement policy ובוחרים אחת מהאפשרויות הבאות:

    • כדי ליצור מדיניות למיקום קומפקטי:

      1. לוחצים על יצירת מדיניות מיקום של קבוצה. מופיע החלונית Create a group placement policy.

      2. בשדה Policy name, כותבים את השם של המדיניות.

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

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

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

gcloud

כדי ליצור מקום שמור לפרויקט יחיד עם מדיניות למיקום קומפקטי, משתמשים בפקודה gcloud compute reservations create עם הדגלים --require-specific-reservation ו---resource-policies=policy ומציינים את המאפיינים ישירות.

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --require-specific-reservation \
    --resource-policies=policy=POLICY_NAME \
    --vm-count=NUMBER_OF_INSTANCES \
    --zone=ZONE

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

  • ‫RESERVATION_NAME: שם ההזמנה.

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

  • ‫NUMBER_OF_INSTANCES: מספר המכונות שרוצים לשמור, שלא יכול להיות גבוה ממספר המכונות המקסימלי שנתמך במדיניות למיקום קומפקטי שצוינה.

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

REST

כדי ליצור מקום שמור לפרויקט יחיד עם מדיניות למיקום קומפקטי, שולחים בקשת POST אל ה-method‏ reservations.insert ומציינים את המאפיינים ישירות. בגוף הבקשה, כוללים את השדה resourcePolicies ואת השדה specificReservationRequired שמוגדר ל-true.

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

{
  "name": "RESERVATION_NAME",
  "resourcePolicies": {
    "policy" : "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  },
  "specificReservation": {
    "count": "NUMBER_OF_INSTANCES",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  },
  "specificReservationRequired": true
}

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

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

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

  • ‫RESERVATION_NAME: שם ההזמנה.

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

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

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

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

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

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

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

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

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

  • כדי ליצור תבנית של הגדרות מכונה אזורית עם מדיניות חדשה למיקום קומפקטי, משתמשים במסוף Google Cloud . במדיניות החדשה לא מצוין ערך מרחק מקסימלי, ואפשר להחיל אותה על עד 22 מכונות.

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

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

המסוף

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

    כניסה לדף Instance templates

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

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

  4. בקטע Machine configuration, מציינים סדרת מכונות וסוג של מכונה שנתמכים במדיניות למיקום קומפקטי.

  5. בקטע Placement policy, ברשימה Placement policy בוחרים באפשרות Compact. כשבוחרים באפשרות הזו, מסוףGoogle Cloud יוצר באופן אוטומטי מדיניות למיקום קומפקטי בלי ערך מרחק מקסימלי, שתומכת בעד 22 מכונות.

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

gcloud

כדי ליצור תבנית של הגדרות מכונה שמציינת מדיניות למיקום קומפקטי, משתמשים בפקודה gcloud compute instance-templates create עם הדגלים --maintenance-policy ו---resource-policies.

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

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME

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

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

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

  • ‫MAINTENANCE_POLICY: מדיניות התחזוקה של המארח. אם במדיניות למיקום קומפקטי שציינתם ערך המרחק המקסימלי הוא 1 או 2, או שסוג המכונה שבחרתם לא תומך במיגרציה פעילה, אתם יכולים לציין רק TERMINATE. אחרת, אפשר לציין את הערך MIGRATE או TERMINATE.

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

REST

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

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

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

POST https://compute.googleapis.com/compute/v1/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"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

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

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

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

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

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

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

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

  • ‫MACHINE_TYPE: סוג מכונה נתמך למדיניות למיקום קומפקטי.

  • ‫POLICY_NAME: השם של מדיניות קיימת למיקום קומפקטי.

  • ‫MAINTENANCE_POLICY: מדיניות התחזוקה של המארח. אם במדיניות למיקום קומפקטי שציינתם ערך המרחק המקסימלי הוא 1 או 2, או שסוג המכונה שבחרתם לא תומך במיגרציה פעילה, אתם יכולים לציין רק TERMINATE. אחרת, אפשר לציין את הערך MIGRATE או TERMINATE.

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

החלת המדיניות על מכונות ב-MIG

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

החלת המדיניות בזמן יצירת קבוצת MIG

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

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

gcloud

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

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

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

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

  • ‫INSTANCE_GROUP_NAME: השם של קבוצת ה-MIG שרוצים ליצור.

  • ‫SIZE: הגודל של ה-MIG.

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

  • ‫ZONE: האזור שבו יוצרים את ה-MIG, שחייב להיות באזור שבו נמצאת המדיניות למיקום קומפקטי.

REST

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

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

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

{
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": SIZE,
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    }
  ]
}

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

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

  • ‫ZONE: האזור שבו יוצרים את קבוצת ה-MIG, שחייב להיות באזור שבו נמצאת המדיניות למיקום קומפקטי.

  • ‫INSTANCE_GROUP_NAME: השם של קבוצת ה-MIG שרוצים ליצור.

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

  • ‫SIZE: הגודל של ה-MIG.

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

החלת המדיניות על קבוצת MIG קיימת

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

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

gcloud

כדי לעדכן קבוצת MIG כך שתשתמש בתבנית של הגדרות מכונה שמציינת מדיניות מיקום קומפקטי, משתמשים בפקודה gcloud compute instance-groups managed rolling-action start-update.

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

gcloud compute instance-groups managed rolling-action start-update MIG_NAME \
    --version=template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

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

  • ‫MIG_NAME: השם של קבוצת MIG קיימת.

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

  • ‫ZONE: האזור שבו נמצאת קבוצת ה-MIG. אפשר להחיל את המדיניות למיקום קומפקטי רק על קבוצת MIG שנמצאת באותו אזור כמו המדיניות למיקום.

REST

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

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

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
}

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

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

  • ‫ZONE: האזור שבו נמצאת קבוצת ה-MIG. אפשר להחיל את המדיניות למיקום קומפקטי רק על קבוצת MIG שנמצאת באותו אזור כמו המדיניות למיקום.

  • ‫MIG_NAME: השם של קבוצת MIG קיימת.

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

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

מה השלב הבא?