יצירת מכונה שמשתמשת ב-Cloud RDMA

מדריכים להוראה

כדי ליצור את הרשתות, אפשר לפעול לפי ההוראות הבאות:

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

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

• כדי ליצור רשת לממשק הרשת IRDMA, אפשר לעיין במאמר בנושא יצירת רשת VPC לכרטיסי NIC של RDMA ולהשתמש בפרופיל רשת Falcon RDMA. מגדירים את יחידת השידור המקסימלית (MTU) ל-8896 עבור רשת ה-VPC של Falcon.

Script

כדי ליצור את הרשתות, אפשר להשתמש בסקריפט הבא.

1. אופציונלי: לפני שמריצים את הסקריפט, כדאי להציג את פרופילי הרשת של Falcon RDMA כדי לוודא שהם זמינים.

   gcloud compute network-profiles list --filter=falcon
   

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

#!/bin/bash

# Create standard VPC (network and subnet) for the GVNIC interface
  gcloud compute networks create GVNIC_NAME_PREFIX-net-0 \
    --subnet-mode=custom

  gcloud compute networks subnets create GVNIC_NAME_PREFIX-sub-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --region=REGION \
    --range=10.0.0.0/16

  gcloud compute firewall-rules create GVNIC_NAME_PREFIX-internal-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=10.0.0.0/8

# Create SSH firewall rules
gcloud compute firewall-rules create GVNIC_NAME_PREFIX-ssh \
  --network=GVNIC_NAME_PREFIX-net-0 \
  --action=ALLOW \
  --rules=tcp:22 \
  --source-ranges=IP_RANGE

# Optional: Create an external IP for only the GVNIC interface
gcloud compute firewall-rules create GVNIC_NAME_PREFIX-allow-ping-net-0 \
  --network=GVNIC_NAME_PREFIX-net-0 \
  --action=ALLOW \
  --rules=icmp \
  --source-ranges=IP_RANGE

# Create network for Cloud RDMA over Falcon transport
gcloud compute networks create RDMA_NAME_PREFIX-irdma \
  --network-profile=ZONE-vpc-falcon \
  --subnet-mode custom

# Create subnet for Cloud RDMA
gcloud compute networks subnets create RDMA_NAME_PREFIX-irdma-sub \
    --network=RDMA_NAME_PREFIX-irdma \
    --region=REGION \
    --range=10.1.0.0/16  # offset to avoid overlap with GVNIC network

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

• ‫GVNIC_NAME_PREFIX: קידומת השם לשימוש ברשת הרגילה של הענן הווירטואלי הפרטי (VPC) וברשת המשנה שמשתמשת בסוג כרטיס רשת GVNIC.
• ‫RDMA_NAME_PREFIX: תחילית השם לשימוש ברשת הענן הווירטואלי הפרטי (VPC) וברשת המשנה שמשתמשת בסוג כרטיס הרשת IRDMA.
• ‫ZONE: האזור שבו רוצים ליצור את הרשתות ואת מכונות ה-Compute. אפשר להשתמש ב-us-central1-a או ב-europe-west4-b.
• ‫REGION: האזור שבו רוצים ליצור את הרשתות. הכתובת צריכה להיות תואמת לאזור שצוין. לדוגמה, אם האזור שלכם הוא europe-west4-b, האזור הוא europe-west4.
• ‫IP_RANGE: טווח כתובות ה-IP מחוץ לרשת ה-VPC שמשמשות לכללי חומת האש של SSH. מומלץ לציין את טווחי כתובות ה-IP הספציפיים שמהם רוצים לאפשר גישה, ולא את כל המקורות של IPv4 או IPv6. אל תשתמשו ב-0.0.0.0/0 או ב-::/0 כטווח מקור, כי זה מאפשר תנועה מכל מקורות IPv4 או IPv6, כולל מקורות מחוץ ל-Cloud de Confiance by S3NS.

המסוף

1. נכנסים לדף Create an instance במסוף Cloud de Confiance .

   כניסה לדף Create an instance

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

   הדף Create an instance מופיע ובו החלונית Machine configuration.

2. בחלונית Machine configuration:

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

   2. אופציונלי: בשדה Zone, בוחרים אזור למכונה הזו.

      בוחרים את האזור שבו השתמשתם כדי להגדיר את רשת ה-VPC של Falcon.

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

   4. בעמודה Series, בוחרים בסדרת המכונות H4D.

   5. בקטע Machine type, בוחרים את סוג המכונה עבור המופע.

3. בתפריט הניווט הימני, לוחצים על מערכת הפעלה ואחסון. בחלונית Operating system and storage שמופיעה, מבצעים את הפעולות הבאות:

   1. בתחתית הקטע מערכת הפעלה ואחסון, לוחצים על שינוי.
   2. ברשימות Operating system ו-Version, בוחרים סוג ומערכת הפעלה שתומכים ב-Cloud RDMA.
   3. מוודאים שסוג דיסק האתחול מוגדר כ-Hyperdisk Balanced.
   4. לוחצים על בחירה בחלק התחתון של החלונית כדי לשמור את השינויים.

4. בתפריט הניווט הימני, לוחצים על Networking (רשת). בחלונית Networking שמופיעה, מבצעים את הפעולות הבאות:

   1. עוברים לקטע Network interfaces. צריך להיות כבר ממשק רשת אחד עם התווית default.
   2. לוחצים על הוספת ממשק רשת. בקטע New network interface שמופיע, מבצעים את הפעולות הבאות:
      1. ברשימה Network interface card בוחרים באפשרות IRDMA.
      2. בשדה Network (רשת), בוחרים ברשת ה-VPC של Falcon.
      3. אופציונלי: ברשימה Subnetwork, בוחרים את רשת המשנה שהמכונה תשתמש בה.
      4. בשדה IP stack type מוודאים שהערך הוא IPV4-only.
      5. ברשימה External IPv4 address בוחרים באפשרות None.
      6. כדי לאשר את פרטי ממשק הרשת, לוחצים על סיום.

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

6. כדי ליצור את המכונה ולהפעיל אותה, לוחצים על Create.

gcloud

1. במסוף Cloud de Confiance , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. משתמשים בפקודה gcloud compute instances create עם לפחות שני דגלים --network-interface, אחד לממשק GVNIC ואחד לממשק IRDMA. אפשר להתאים אישית את שאר אפשרויות הפקודה לפי הצורך.

   gcloud compute instances create INSTANCE_NAME \
       --zone=ZONE \
       --machine-type=MACHINE_TYPE \
       --create-disk=boot=yes, \
           image=projects/IMAGE_PROJECT/global/images/IMAGE, \
           size=SIZE \
       --maintenance-policy=TERMINATE \
       --network-interface \
           nic-type=GVNIC, \
           network=NETWORK_NAME,subnet=SUBNET_NAME, \
           stack-type=STACK_TYPE, \
           private-network-ip=INTERNAL_IPV4_ADDRESS, \
           address=EXTERNAL_IPV4_ADDRESS \
       --network-interface \
           nic-type=IRDMA, \
           network=RDMA_NETWORK_NAME,subnet=RDMA_SUBNET_NAME, \
           stack-type=IPV4_ONLY, \
           no-address \
   

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

   • ‫INSTANCE_NAME: השם של מכונת ה-Compute
   • ‫ZONE: האזור שבו נוצרת המכונה, למשל europe-west1-b. האזור של המופע נגזר מהאזור.
   • ‫MACHINE_TYPE: אופציונלי: סוג המכונה שבה רוצים להשתמש עבור המופע.
   • ‫IMAGE_PROJECT: אופציונלי: פרויקט התמונה שמכיל את התמונה.
   • ‫IMAGE: אופציונלי: מציינים אחת מהאפשרויות הבאות:
     • גרסה ספציפית של תמונת מערכת ההפעלה – לדוגמה, hpc-rocky-linux-8-v20250721.
     • תמונה משפחתית, שצריך לעצב אותה בפורמט family/IMAGE_FAMILY. הפעולה הזו יוצרת את המכונה מקובץ האימג' העדכני ביותר של מערכת ההפעלה, שלא הוצא משימוש. לדוגמה, אם מציינים family/hpc-rocky-linux-8, ‏ Compute Engine יוצר מכונה באמצעות הגרסה האחרונה של תמונת מערכת ההפעלה במשפחת תמונות HPC Rocky Linux 8. מידע נוסף על שימוש בקבוצות של תמונות זמין במאמר שיטות מומלצות לשימוש בקבוצות של תמונות.
   • ‫SIZE: אופציונלי: הגודל של הדיסק החדש. הערך חייב להיות מספר שלם. יחידת המידה שמוגדרת כברירת מחדל היא GiB.
   • ‫NETWORK_NAME: אופציונלי: שם הרשת

   • ‫SUBNET_NAME: השם של תת-הרשת שבה רוצים להשתמש עבור ממשק הרשת. כדי לראות את רשימת רשתות המשנה ברשת, משתמשים בפקודה gcloud compute networks subnets list.

     בממשק הרשת GVNIC, אפשר להשמיט את הדגלים network ו-subnet ולהשתמש ברשת default במקום זאת.

   • ‫STACK_TYPE: אופציונלי: סוג הערימה של ממשק הרשת GVNIC. הערך של STACK_TYPE חייב להיות אחד מהערכים הבאים: IPV4_ONLY,‏ IPV4_IPV6 או IPV6_ONLY. ערך ברירת המחדל הוא IPV4_ONLY.

   • ‫INTERNAL_IPV4_ADDRESS: אופציונלי: כתובת ה-IPv4 הפנימית שרוצים שמכונת ה-Compute תשתמש בה ברשת המשנה של היעד. אם לא צריך כתובת IP ספציפית, אפשר להשמיט את הדגל הזה.

     כדי לציין כתובת IPv6 פנימית, משתמשים בדגל --internal-ipv6-address במקום.

   • ‫EXTERNAL_IPV4_ADDRESS: אופציונלי: כתובת IPv4 חיצונית סטטית לשימוש עם ממשק הרשת. צריך לשריין כתובת IPv4 חיצונית מראש. מבצעים אחת מהפעולות הבאות:

     • מציינים כתובת IPv4 חוקית מתת-הרשת.
     • אם לא רוצים שלממשק הרשת תהיה כתובת IP חיצונית, משתמשים בדגל no-address במקום זאת.
     • מציינים address='' אם רוצים שהממשק יקבל כתובת IP חיצונית ארעית.

     כדי לציין כתובת IPv6 חיצונית, משתמשים בדגל --external-ipv6-address.

   • ‫RDMA_NETWORK_NAME: השם של רשת ה-VPC שיצרתם עם פרופיל רשת Falcon RDMA.

   • ‫RDMA_SUBNET_NAME: השם של תת-רשת ברשת ה-VPC של Falcon.

REST

כדי ליצור מכונה שמוגדרת לשימוש ב-Cloud RDMA, שולחים בקשת POST אל ה-method‏ instances.insert. כוללים את האובייקט networkInterfaces עם לפחות שתי הגדרות רשת, אחת לממשק gVNIC ואחת לממשק IRDMA. אפשר להתאים אישית את שאר מאפייני המופע לפי הצורך.

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

• ‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את המכונה
• ‫ZONE: האזור שבו רוצים ליצור את המכונה
• ‫MACHINE_TYPE: סוג המכונה שרוצים להשתמש בה, לדוגמה, h4d-highmem-192-lssd
• ‫INSTANCE_NAME: שם למכונה החדשה
• ‫IMAGE_PROJECT: אופציונלי: פרויקט התמונה שמכיל את התמונה

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

  • גרסה ספציפית של תמונת מערכת ההפעלה – לדוגמה, debian-12-bookworm-v20250415
  • משפחת תמונות, שצריך לעצב אותה בפורמט family/IMAGE_FAMILY. הפעולה הזו יוצרת את המופע מתמונת מערכת ההפעלה העדכנית ביותר שלא הוצאה משימוש. לדוגמה, אם מציינים family/debian-12, ‏ Compute Engine יוצר מכונה באמצעות הגרסה האחרונה של תמונת מערכת ההפעלה במשפחת תמונות Debian 12. מידע נוסף על שימוש במשפחות תמונות זמין במאמר בנושא שיטות מומלצות לשימוש במשפחות תמונות.
• ‫NETWORK_NAME: אופציונלי: השם של הרשת לשימוש עם ממשק הרשת gVNIC

• ‫SUBNET_NAME: השם של רשת המשנה שבה רוצים להשתמש עם ממשק הרשת gVNIC

  בממשק הרשת GVNIC, אפשר להשמיט את המאפיינים network ו-subnet ולהשתמש ברשת default.

• ‫INTERNAL_IPV4_ADDRESS: אופציונלי: כתובת ה-IPv4 הפנימית שרוצים שמכונת ה-Compute תשתמש בה ברשת המשנה של היעד. אם לא צריך כתובת IP ספציפית, אפשר להשמיט את הדגל הזה.
• ‫EXTERNAL_IPV4_ADDRESS: אופציונלי: כתובת IPv4 חיצונית סטטית לשימוש עם ממשק הרשת. צריך לשריין כתובת IPv4 חיצונית מראש.
• ‫RDMA_NETWORK_NAME: השם של הרשת שיצרתם באמצעות פרופיל רשת RDMA
• ‫RDMA_SUBNET_NAME: השם של תת-רשת ברשת ה-RDMA

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

{
    "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot": true
      }
    ],
    "networkInterfaces": [
      {
        "network": "NETWORK_NAME",
        "subnetwork": "SUBNET_NAME",
        "networkIP": "INTERNAL_IPV4_ADDRESS",
        "accessConfigs": [
          {
            "type": "ONE_TO_ONE_NAT",
            "name": "External IP",
            "natIP": "EXTERNAL_IPV4_ADDRESS"
          }
        ],
        "stackType": "IPV4_ONLY",
        "nicType": "GVNIC",
      },
      {
        "network": "RDMA_NETWORK_NAME",
        "subnetwork": "RDMA_SUBNET_NAME",
        "stackType": "IPV4_ONLY",
        "nicType": "IRDMA",
      }
    ]
}

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": "compute#operation",
  "id": "9216044482154695709",
  "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
  "zone": "https://www.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`",
  "operationType": "insert",
  "targetLink": "https://www.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
  "targetId": "2679381553616227357",
  "status": "RUNNING",
  "user": "USER_ID",
  "progress": 0,
  "insertTime": "2025-02-10T09:10:10.551-08:00",
  "startTime": "2025-02-10T09:10:10.551-08:00",
  "selfLink": "https://www.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
 "kind": "compute#operation"
}