建立叢集網路介面

叢集網路介面是一種虛擬網路介面卡,用於將您的執行個體連接到叢集網路子網。 您可以在建立叢集網路時,或在網路配置完成後,建立叢集網路介面。

開始之前

您可以使用主控台、CLI、API 或 Terraform 建立群集網路介面。

在主控台中建立群集網路介面

要在控制台建立叢集網路介面,請遵循以下步驟:

  1. 請在瀏覽器中開啟 IBM Cloud 控制台,並登入您的帳戶。

  2. 選擇導航選單圖標,然後點擊基礎設施VPC 圖標 > 網路 > 叢集網路

  3. 在「VPC 的集群網路」頁面上,按一下要建立介面的集群網路名稱的連結。 即會顯示「概觀」頁面。

  4. 點擊「介面」標籤以顯示叢集網路介面表格,然後點擊「建立」。

  5. 在「建立」介面側邊欄中,請填寫以下資訊:

    • 輸入介面名稱。

    • 請選擇叢集網路的子網。

      系統會為您選取一個主要 IP 位址,並可在建立完成後查看。

  6. 按一下建立。 請求使用叢集網路介面。

從命令列介面建立叢集網路介面

若要從命令列介面建立叢集網路介面,請依循以下步驟:

  1. 設定您的 CLI 環境

  2. 請透過 CLI 登入您的帳戶。 輸入密碼後,系統會提示輸入帳戶和區域:

    ibmcloud login --sso
    
  3. 若要建立叢集網路接口,請輸入以下命令:

    ibmcloud is cluster-network-interface-create CLUSTER_NETWORK (--rip RIP | (--rip-address RIP_ADDRESS --rip-auto-delete true | false --rip-name RIP_NAME)) [--subnet SUBNET] [--vpc VPC] [--name NAME] [--output JSON] [-q, --quiet]
    

    其中:

    CLUSTER_NETWORK
    叢集網路的 ID 或名稱。
    --rip
    用於將主要 IP 位址綁定至叢集網路介面的預留 IP 位址的 ID 或名稱。
    --rip-address
    若要連結至叢集網路介面的保留 IP 位址的 IP 位址,其不得已在子網路上保留。
    --rip-auto-delete
    指示當任一目標被刪除,或叢集網路子網保留 IP 解除綁定時,此叢集網路子網保留 IP 成員是否會自動刪除。 以下任一項:truefalse (預設:true)。
    --rip-name
    此叢集網路子網中預留的 IP 位址名稱。
    --subnet
    子網路的 ID 或名稱。
    --vpc
    VPC 的 ID 或名稱。 只需要在此 VPC 內按名稱指定唯一資源。
    --name
    叢集網路介面的名稱。
    --output
    指定輸出格式,只支援 JSON。 下列其中一項:JSON
    -q, --quiet
    抑制詳細輸出。

命令範例

  • 建立具有保留 IP 的叢集網路介面:

    ibmcloud is cluster-network-interface-create my-cluster-network --name my-cluster-network-interface --subnet my-cluster-network-subnet --rip-name my-cluster-network-interface-reserved-ip
    
  • 使用現有叢集網路子網中的保留 IP 建立叢集網路介面:

    ibmcloud is cluster-network-interface-create my-cluster-network --name my-cluster-network-interface --rip my-cluster-network-interface-reserved-ip
    

使用 API 建立叢集網路介面

若要使用 API 建立叢集網路接口,請執行下列步驟:

  1. 使用正確的變數 設定您的 API 環境。

  2. 將任何用於 API 指令的額外變數儲存起來。 例如:

    version (字串):API 版本,格式為 YYYY-MM-DD

  3. 當所有變數都初始化後,執行以下命令建立叢集網路介面:

    curl -X POST "$vpc_api_endpoint/v1/cluster_networks/$cluster_network_id/interfaces?version=$today&generation=2" -H "Authorization: Bearer $iam_token" -d '{
          "name": "my-cluster-network-interface",
          "subnet": {
              "id": "0767-7931845c-65c4-4b0a-80cd-7d9c1a6d7930"
          }
        }'
    

若要查看完整的叢集網路 API 集,請參閱 VPC API 參考

使用 Terraform 建立集群網路接口

以下範例使用 Terraform 配置叢集網路介面:

resource "ibm_is_cluster_network_interface" "is_cluster_network_interface_instance" {
  cluster_network_id            = var.is_cluster_network_interface_cluster_network_id
  name                          = var.is_cluster_network_interface_name
  primary_ip {
    address = "10.1.0.6"
    name    = "my-cluster-network-subnet-reserved-ip"
  }
  subnet = "0767-7931845c-65c4-4b0a-80cd-7d9c1a6d7930"
}

下一步

若要建立虛擬伺服器執行個體並將其附加至叢集網路中的介面,請參閱 建立虛擬伺服器執行個體將叢集網路介面附加至執行個體