建立使用 Cloud RDMA 的執行個體

操作指南

如要建立網路，請按照下列操作說明進行：

• 如要為 GVNIC 或 IDPF 網路介面建立主機網路，請參閱「建立及管理虛擬私有雲網路」。

  如果只設定一個 GVNIC 或 IDPF 網路介面，可以使用預設的虛擬私有雲網路，以及與執行個體位於相同區域的自動子網路。

• 如要為 IRDMA 網路介面建立網路，請參閱「為 RDMA NIC 建立虛擬私有雲網路」，並使用 Falcon RDMA 網路設定檔。將 Falcon 虛擬私有雲網路的最大傳輸單位 (MTU) 設為 8896。

腳本

您可以使用下列指令碼建立網路。

1. 選用：執行指令碼前，請列出 Falcon RDMA 網路設定檔，確認這些設定檔可用。

   gcloud compute network-profiles list --filter=falcon
   

2. 複製下列程式碼，並在 Linux 殼層視窗中執行。

#!/bin/bash

# Create standard VPC (network and subnet) for the GVNIC or IDPF 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 or IDPF 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 or IDPF network

更改下列內容：

• GVNIC_NAME_PREFIX：一般虛擬私有雲網路和子網路的名稱前置字串，使用 GVNIC 或 IDPF NIC 類型。
• RDMA_NAME_PREFIX：虛擬私有雲網路和子網路的名稱前置字串，該網路和子網路使用 IRDMA NIC 類型。
• ZONE：要建立網路和運算執行個體的可用區。使用 us-central1-a 或 europe-west4-b。
• REGION：要建立網路的區域。這必須與指定的可用區相對應。舉例來說，如果可用區是 europe-west4-b，則區域為 europe-west4。
• IP_RANGE：虛擬私有雲網路以外的 IP 位址範圍，用於 SSH 防火牆規則。最佳做法是指定您需要允許存取的特定 IP 位址範圍，而非所有 IPv4 或 IPv6 來源。請勿使用 0.0.0.0/0 或 ::/0 做為來源範圍，因為這樣會允許來自所有 IPv4 或 IPv6 來源的流量，包括Cloud de Confiance by S3NS以外的來源。

控制台

1. 前往 Cloud de Confiance 控制台的「Create an instance」(建立執行個體) 頁面。

   前往「Create an instance」(建立執行個體)

   如果出現系統提示，請選取您的專案，然後按一下 [Continue] (繼續)。

   「Create an instance」(建立執行個體) 頁面隨即顯示，並顯示「Machine configuration」(機器設定) 窗格。

2. 在「機器設定」窗格中，執行下列操作：

   1. 在「Name」(名稱) 欄位中，指定執行個體的名稱。詳情請參閱「資源命名慣例」。

   2. 選用：在「Zone」(可用區) 欄位中，選取這個執行個體的可用區。

      選擇用於設定 Falcon 虛擬私有雲網路的可用區。

   3. 請選擇支援的機器家族和機器系列。

   4. 在「Machine type」(機型) 部分，選取執行個體的機型。

3. 在左側導覽選單中，按一下「OS and Storage」(OS 和儲存空間)。在隨即顯示的「作業系統和儲存空間」窗格中，完成下列步驟：

   1. 在「作業系統和儲存空間」專區底部，點選「變更」。
   2. 在「Operating system」(作業系統) 和「Version」(版本) 清單中，選取支援 Cloud RDMA 的作業系統類型和版本。
   3. 確認「開機磁碟類型」設為「Hyperdisk Balanced」。
   4. 按一下窗格底部的「選取」，儲存變更。

4. 在左側導覽選單中，按一下「Networking」。在隨即顯示的「Networking」(網路) 窗格中，執行下列操作：

   1. 前往「網路介面」部分。應該已經有一個網路介面，標示為 default。
   2. 按一下「新增網路介面」。在顯示的「New network interface」(新增網路介面) 區段中，執行下列操作：
      1. 在「網路介面卡」清單中，選取「IRDMA」。
      2. 在「Network」(網路) 欄位中，選取 Falcon 虛擬私有雲網路。
      3. 選用：在「Subnetwork」(子網路) 清單中，選取要用於執行個體的子網路。
      4. 在「IP stack type」(IP 堆疊類型) 欄位中，確認已設為「IPV4-only」(僅限 IPV4)。
      5. 在「外部 IPv4 位址」清單中，選取「無」。
      6. 按一下「Done」(完成)，確認網路介面詳細資料。

5. 選用：指定執行個體的其他設定選項。詳情請參閱「建立執行個體時的設定選項」。

6. 如要建立並啟動執行個體，請按一下「建立」。

gcloud

1. 在 Cloud de Confiance 控制台啟用 Cloud Shell。

   啟用 Cloud Shell

   Cloud de Confiance 控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。

2. 使用 gcloud compute instances create 指令，並加上至少兩個 --network-interface 旗標，一個用於 GVNIC 或 IDPF 介面，另一個用於 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：運算執行個體的名稱
   • ZONE：建立執行個體的可用區，例如 europe-west1-b。執行個體的地區是從區域推測得出。
   • MACHINE_TYPE：執行個體可使用的支援機器類型。
   • IMAGE_PROJECT：選用：包含圖片的圖片專案。
   • IMAGE：選用：指定下列其中一項：
     • 特定版本的 OS 映像檔，例如 hpc-rocky-linux-8-v20250721。
     • 圖片系列，格式必須為 family/IMAGE_FAMILY。這會使用最新的非淘汰 OS 映像檔建立執行個體。舉例來說，如果您指定 family/hpc-rocky-linux-8，Compute Engine 就會使用 HPC Rocky Linux 8 映像檔系列中最新版本的 OS 映像檔建立執行個體。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。
   • SIZE：選用：新磁碟的大小。值必須是整數。預設測量單位為 GiB。
   • NETWORK_NAME：選用：網路名稱

   • SUBNET_NAME：用於網路介面的子網路名稱。如要查看網路中的子網路清單，請使用 gcloud compute networks subnets list 指令。

     如果是 GVNIC 或 IDPF 網路介面，您可以省略 network 和 subnet 旗標，改用 default 網路。

   • STACK_TYPE：選用：GVNIC 或 IDPF 網路介面的堆疊類型。STACK_TYPE 必須是下列其中一項：IPV4_ONLY、IPV4_IPV6 或 IPV6_ONLY。預設值為 IPV4_ONLY。

   • INTERNAL_IPV4_ADDRESS：選用：您希望運算執行個體在目標子網路中使用的內部 IPv4 位址。如果不需要特定 IP 位址，請略過這個旗標。

     如要指定內部 IPv6 位址，請改用 --internal-ipv6-address 旗標。

   • EXTERNAL_IPV4_ADDRESS：選用：要與網路介面搭配使用的靜態外部 IPv4 位址。您必須先預留外部 IPv4 位址。 執行下列其中一個步驟：

     • 請指定子網路中的有效 IPv4 位址。
     • 如果您不希望網路介面有外部 IP 位址，請改用 no-address 旗標。
     • 如要讓介面接收暫時外部 IP 位址，請指定 address=''。

     如要指定外部 IPv6 位址，請改用 --external-ipv6-address 標記。

   • RDMA_NETWORK_NAME：您使用 Falcon RDMA 網路設定檔建立的虛擬私有雲網路名稱。

   • RDMA_SUBNET_NAME：Falcon 虛擬私有雲網路中的子網路名稱。

REST

如要建立設定為使用 Cloud RDMA 的執行個體，請向 instances.insert 方法提出 POST 要求。加入 networkInterfaces 物件，並至少包含兩個網路設定，一個用於 gVNIC 或 IDPF 介面，另一個用於 IRDMA 介面。您可以視需要自訂其餘執行個體屬性。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID：要建立執行個體的專案 ID
• ZONE：要在哪個可用區建立執行個體
• MACHINE_TYPE：支援的機器類型，例如 h4d-highmem-192-lssd
• INSTANCE_NAME：新執行個體的名稱
• IMAGE_PROJECT：選用：包含圖片的圖片專案

• IMAGE：選用，指定下列其中一項：

  • OS 映像檔的特定版本，例如 debian-12-bookworm-v20250415
  • 映像檔系列，格式必須為 family/IMAGE_FAMILY。系統會使用最新且未淘汰的 OS 映像檔建立執行個體。舉例來說，如果您指定 family/debian-12，Compute Engine 會使用 Debian 12 映像檔系列中最新版本的 OS 映像檔建立執行個體。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。
• NETWORK_NAME：選用：要與 gVNIC 或 IDPF 網路介面搭配使用的網路名稱

• SUBNET_NAME：要搭配 gVNIC 或 IDPF 網路介面使用的子網路名稱

  如果是 GVNIC 或 IDPF 網路介面，您可以省略 network 和 subnet 屬性，改用 default 網路。

• INTERNAL_IPV4_ADDRESS： (選用) 要讓運算執行個體在目標子網路中使用的內部 IPv4 位址。如果不需要特定 IP 位址，請略過這個旗標。
• EXTERNAL_IPV4_ADDRESS：選用。要與網路介面搭配使用的靜態外部 IPv4 位址。您必須預先保留外部 IPv4 位址。
• RDMA_NETWORK_NAME：使用 RDMA 網路設定檔建立的網路名稱
• RDMA_SUBNET_NAME：RDMA 網路中的子網路名稱

HTTP 方法和網址：

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"
}