הצגת המיקום הפיזי של מכונה של Compute Engine

gcloud

כדי להציג או להסתיר את מזהה המארח של מכונת חישוב קיימת, משתמשים בפקודה gcloud compute instances update עם אחד מהדגלים הבאים:

• כדי לחשוף את מזהה המארח, כוללים את הדגל --expose-host-topology:

  gcloud compute instances update INSTANCE_NAME \
      --expose-host-topology \
      --zone=ZONE
  

• כדי להסתיר את מזהה המארח, מוסיפים את הדגל --no-expose-host-topology:

  gcloud compute instances update INSTANCE_NAME \
      --no-expose-host-topology \
      --zone=ZONE
  

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

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

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

REST

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

   GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
   

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

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

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

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

2. כדי לעדכן מכונת Compute כך שתחשוף או תסתיר את מזהה המארח, שולחים בקשת PUT אל ה-method‏ instances.update. בגוף הבקשה, משתמשים בGETפלט הבקשה מהשלב הקודם. עם זאת, בשדה scheduling, צריך להוסיף את השדה exposeHostTopology כדי לחשוף או להסתיר את מזהה המארח. אם השדה scheduling לא קיים בפלט של הבקשה, צריך להוסיף אותו גם כן.

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

   PUT https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=REFRESH
   
   {
     "scheduling": {
       "exposeHostTopology": EXPOSE_HOST_ID
     },
     ...
   }
   

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

   • כדי לחשוף את מזהה המארח: true

   • כדי להסתיר את מזהה המארח: false

gcloud

כדי לחשוף את מזהה המארח בזמן יצירת מכונת Compute, משתמשים בפקודה gcloud compute instances create עם הדגל --expose-host-topology:

gcloud compute instances create INSTANCE_NAME \
    --machine-type=MACHINE_TYPE \
    --expose-host-topology \
    --zone=ZONE

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

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

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

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

REST

כדי לחשוף את מזהה המארח בזמן שיוצרים מכונת חישוב, שולחים בקשת POST אל ה-method‏ instances.insert. בגוף הבקשה, כוללים את השדה scheduling.exposeHostTopology עם הערך true.

POST https://compute.s3nsapis.fr/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": {
    "exposeHostTopology": true
  }
}

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

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

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

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

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

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

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

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

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

gcloud

כדי לחשוף את מזהה המארח כשיוצרים כמות גדולה של מכונות וירטואליות, מריצים את הפקודה gcloud compute instances create-bulk עם הדגל --expose-host-topology.

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

gcloud compute instances create-bulk \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --expose-host-topology \
    --zone=ZONE

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

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

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

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

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

REST

כדי לחשוף את מזהה המארח כשיוצרים כמות גדולה של מכונות וירטואליות, שולחים בקשת POST אל ה-method‏ instances.bulkInsert. בגוף הבקשה, כוללים את השדה instanceProperties.scheduling.exposeHostTopology עם הערך true.

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

POST https://compute.s3nsapis.fr/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": {
      "exposeHostTopology": true
    }
  }
}

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

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

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

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

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

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

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

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

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

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

gcloud

כדי לחשוף את מזהה המארח בזמן שיוצרים תבנית של הגדרות מכונה, משתמשים בפקודה gcloud compute instance-templates create עם הדגל --expose-host-topology.

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

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --expose-host-topology \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

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

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

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

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

REST

כדי לחשוף את מזהה המארח בזמן שיוצרים תבנית של הגדרות מכונה, שולחים POST בקשה לאחת מהשיטות הבאות. בגוף הבקשה, כוללים את השדה properties.scheduling.exposeHostTopology עם הערך true.

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

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

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

POST https://compute.s3nsapis.fr/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": {
      "exposeHostTopology": true
    }
  }
}

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

• ‫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 ישתמשו בו.

המסוף

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

   כניסה לדף VM instances

2. בעמודה Name (שם), לוחצים על השם של מופע החישוב שרוצים לראות את הפרטים שלו. מופיע דף עם פרטי המופע והכרטיסייה Details נבחרת.

3. בקטע מידע בסיסי, בודקים את הערך בשדה מארח פיזי.

gcloud

כדי לראות את המיקום הפיזי של מכונת Compute פעילה, משתמשים בפקודה gcloud compute instances describe עם הדגל --flatten=resourceStatus.physicalHostTopology:

gcloud compute instances describe INSTANCE_NAME \
    --flatten=resourceStatus.physicalHostTopology \
    --zone=ZONE

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

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

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

הפלט אמור להיראות כך:

• אם אתם יכולים לראות את המזהה של האשכול, הבלוק, תת-הבלוק והמארח של מופע Compute, הפלט ייראה כך:

  ---
  block: 3e3056e23cf91a5cb4a8621b6a52c100
  cluster: europe-west1-cluster-jfhb
  host: 1215168a4ecdfb434fd4d28056589059
  subBlock: 0fc09525cbd5abd734342893ca1c083f
  

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

  ---
  block: null
  cluster: null
  host: 1215168a4ecdfb434fd4d28056589059
  subBlock: null
  

REST

כדי לראות את המיקום הפיזי של מופעי המחשוב הפעילים, שולחים אחת מהבקשות הבאות של GET. כששולחים בקשה, צריך לכלול את פרמטר השאילתה fields ולהגביל את הפלט לשדות name, machineType ו-physicalHostTopology של מופע Compute. צריך גם לכלול את פרמטר השאילתה filter ולהגביל את התוצאות למכונות פעילות.

• כדי לראות רשימה של המופעים בכל האזורים: ‫instances.aggregatedList method

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/instances?fields=items.name,items.machineType,items.resourceStatus.physicalHostTopology&filter=status=RUNNING
  

• כדי לראות רשימה של המכונות שלכם באזור מסוים: שיטת instances.list

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances?fields=items.name,items.machineType,items.resourceStatus.physicalHostTopology&filter=status=RUNNING
  

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

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

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

הפלט אמור להיראות כך:

• אם אתם יכולים לראות את המזהה של האשכול, הבלוק, תת-הבלוק והמארח של מופע Compute, הפלט ייראה כך. בדוגמה הבאה, המכונות vm-01 ו-vm-02 נמצאות באותו בלוק.

  {
    "items": [
      {
        "name": "vm-01",
        "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
        "resourceStatus": {
          "physicalHostTopology": {
            "block": "3e3056e23cf91a5cb4a8621b6a52c100",
            "cluster": "europe-west1-cluster-jfhb",
            "host": "1215168a4ecdfb434fd4d28056589059",
            "subBlock": "0fc09525cbd5abd734342893ca1c083f"
          }
        }
      },
      {
        "name": "vm-02",
        "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
        "resourceStatus": {
          "physicalHostTopology": {
            "block": "3e3056e23cf91a5cb4a8621b6a52c100",
            "cluster": "europe-west1-cluster-jfhb",
            "host": "2326279b5ecdfc545fd5e39167698168",
            "subBlock": "1fc18636cbd4abd623553784ca2c174e"
          }
        }
      },
      ...
    ]
  }
  

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

  {
    "items": [
      {
        "name": "vm-01",
        "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
        "resourceStatus": {
          "physicalHostTopology": {
            "block": null,
            "cluster": null,
            "host": "1215168a4ecdfb434fd4d28056589059",
            "subBlock": null
          }
        }
      },
      {
        "name": "vm-02",
        "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
        "resourceStatus": {
          "physicalHostTopology": {
            "block": null,
            "cluster": null,
            "host": "2326279b5ecdfc545fd5e39167698168",
            "subBlock": null
          }
        }
      },
      ...
    ]
  }
  

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

מכונות Linux

1. מתחברים למופע Linux.

2. שולחים שאילתה למפתח המטא-נתונים physical_host_topology באמצעות curl:

   user@myinst:~$ curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology
   

   הפלט אמור להיראות כך:

   • אם אתם יכולים לראות את המזהה של האשכול, הבלוק, תת-הבלוק והמארח של מופע Compute, הפלט ייראה כך:

     {
       "block": "3e3056e23cf91a5cb4a8621b6a52c100",
       "cluster": "europe-west1-cluster-jfhb",
       "host": "2326279b5ecdfc545fd5e39167698168",
       "subBlock": "1fc18636cbd4abd623553784ca2c174e"
     }
     

   • אם אפשר לראות רק את המזהה של המארח אחרי שחושפים אותו, הפלט ייראה כך:

     {
       "block": null,
       "cluster": null,
       "host": "2326279b5ecdfc545fd5e39167698168",
       "subBlock": null
     }
     

מכונות וירטואליות של Windows

1. מתחברים למופע Windows.

2. שולחים שאילתה למפתח המטא-נתונים physical_host_topology באמצעות הפקודה Invoke-RestMethod:

   PS C:\> 
   $value = (Invoke-RestMethod `
           -Headers @{'Metadata-Flavor' = 'Google'} `
           -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology")
   $value
   

   הפלט אמור להיראות כך:

   • אם אתם יכולים לראות את המזהה של האשכול, הבלוק, תת-הבלוק והמארח של מופע Compute, הפלט ייראה כך:

     {
       "block": "3e3056e23cf91a5cb4a8621b6a52c100",
       "cluster": "europe-west1-cluster-jfhb",
       "host": "2326279b5ecdfc545fd5e39167698168",
       "subBlock": "1fc18636cbd4abd623553784ca2c174e"
     }
     

   • אם אפשר לראות רק את המזהה של המארח אחרי שחושפים אותו, הפלט ייראה כך:

     {
       "block": null,
       "cluster": null,
       "host": "2326279b5ecdfc545fd5e39167698168",
       "subBlock": null
     }