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

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

מדיניות למיקום מרווח מציינת שהמכונות צריכות להיות מפוזרות בין דומיינים שונים של זמינות. הפיזור הזה עוזר לצמצם שיבושים שספציפיים למיקום, כמו שגיאות חומרה, והוא שימושי כשמריצים עומסי עבודה משוכפלים, מבוזרים ובקנה מידה גדול, כמו Hadoop Distributed File System‏ (HDFS),‏ Cassandra או Kafka.

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

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

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

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

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

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

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

  • כדי ליצור כללי מדיניות מיקום: ‫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.instanceTemplates.create בפרויקט
  • כדי ליצור קבוצת מופעי מכונה מנוהלים (MIG): ‫compute.instanceGroupManagers.create בפרויקט

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

יצירת מדיניות למיקום מרווח

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

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

gcloud

כדי ליצור מדיניות למיקום מרווח, משתמשים בפקודה gcloud compute resource-policies create group-placement עם הדגל --availability-domain-count.

gcloud compute resource-policies create group-placement POLICY_NAME \
    --availability-domain-count=DOMAIN_COUNT \
    --region=REGION

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

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

  • ‫DOMAIN_COUNT: המספר הייחודי של דומייני הזמינות שבהם רוצים למקם את המכונות. הערך צריך להיות בין 1 ל-8.

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

REST

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "availabilityDomainCount": DOMAIN_COUNT
  }
}

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

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

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

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

  • ‫DOMAIN_COUNT: המספר הייחודי של דומייני הזמינות שבהם רוצים למקם את המכונות. הערך צריך להיות בין 1 ל-8.

החלת מדיניות למיקום מרווח

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

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

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

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

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

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

  • המכונה הווירטואלית והמדיניות למיקום מרווח צריכות להיות באותו אזור. לדוגמה, אם מדיניות המיקום נמצאת באזור us-central1, המכונה הווירטואלית חייבת להיות באזור ב-us-central1. אם אתם צריכים להעביר מכונה וירטואלית לאזור אחר, קראו את המאמר העברת מכונה וירטואלית בין אזורים.

אם רוצים לציין את דומיין הזמינות שבו ה-VM ימוקם, צריך לעדכן את מאפייני ה-VM כדי להחיל את מדיניות המיקום על ה-VM. בבקשת העדכון, צריך לכלול את השדות resourcePolicies ו-scheduling.availabilityDomain, ולציין את REFRESH כפעולה המותרת הכי משבשת. אם בהמשך תשנו את השדה scheduling.availabilityDomain של מכונה וירטואלית שכבר משויכת למדיניות למיקום מרווח, תצטרכו לציין את RESTART כפעולה המותרת הכי משבשת.

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

gcloud

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

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

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

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

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

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

REST

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

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

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

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

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

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

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

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

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

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

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

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

gcloud

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

gcloud compute instances create VM_NAME \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

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

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

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

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

אם רוצים לציין את דומיין הזמינות שבו יוצרים את ה-VM, מוסיפים את הדגל --availability-domain.

gcloud compute instances create VM_NAME \
    --availability-domain=DOMAIN_NUMBER \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

REST

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

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

{
  "name": "VM_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"
  ]
}

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

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

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

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

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

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

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

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

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

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

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

אם רוצים לציין את דומיין הזמינות שבו תיצרו את המכונה הווירטואלית, צריך לכלול את השדה availabilityDomain בגוף הבקשה.

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

{
  "name": "VM_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": {
    "availabilityDomain": DOMAIN_NUMBER
  }
}

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

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

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

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

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

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

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

gcloud

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

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

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

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

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

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

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

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

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

אם רוצים לציין את דומיין הזמינות שבו יוצרים את המכונות בכמות גדולה, מוסיפים את הדגל --availability-domain.

gcloud compute instances bulk create \
    --availability-domain=DOMAIN_NUMBER \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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

REST

כדי ליצור כמות גדולה של מכונות עם מדיניות למיקום מרווח, שולחים בקשת POST אל ה-method‏ instances.bulkInsert. בגוף הבקשה, כוללים את השדה 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": [
      "POLICY_NAME"
    ]
  }
}

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

  • ‫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. למידע נוסף על השימוש במשפחות של קובצי אימג', קראו את המאמר שיטות מומלצות למשפחות של קובצי אימג'.

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

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

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": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "availabilityDomain": DOMAIN_NUMBER
    }
  }
}

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

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

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

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

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

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

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

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

המסוף

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

    כניסה לדף Instance templates

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

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

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

  5. בקטע Placement policy, ברשימה Placement policy בוחרים באפשרות Spread.

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

gcloud

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

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

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

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

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

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

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

אפשר גם לציין את דומיין הזמינות שבו רוצים ליצור את המכונות, באמצעות הדגל --availability-domain.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --availability-domain=DOMAIN_NUMBER  \
    --machine-type=MACHINE_TYPE \
    --resource-policies=POLICY_NAME

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

REST

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

בגוף הבקשה, מציינים את השדה 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"
    ]
  }
}

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

  • ‫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: השם של מדיניות קיימת למיקום מרווח.

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

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": {
      "availabilityDomain": DOMAIN_NUMBER
    }
  }
}

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

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

מה השלב הבא?