创建集群网络

集群网络可帮助您将多个虚拟网络相互连接，并为其定义一组性能标准。这些网络旨在支持需要高速数据传输和低延迟的任务，如高性能计算（HPC）和大规模数据处理。

准备工作

在创建集群网络之前，请检查以下先决条件：

审查规划考虑因素和已知问题。
请确保您在某个区域内已存在一个虚拟私有云（VPC），且该区域具备支持集群功能的集群网络配置文件容量。有关更多信息，请参阅《虚拟私有云（VPC）入门》和《在不同区域创建VPC》。

你可以使用控制台、API、CLI 和 Terraform 创建集群网络。

在控制台中创建群集网络

要在控制台中创建群集网络，请按照以下步骤操作：

在浏览器中打开 IBM Cloud 控制台，并登录您的账户。
选择导航，然后点击基础设施 > 网络 > 集群网络。
在“VPC 的集群网络”页面上，单击 “创建”。
在“位置”部分，必要时编辑以下字段。
- 地理：集群网络的地理区域。
- 区域：地理范围内的特定区域。
- 区域：所选区域内的可用区。
您必须在与VPC相同的区域内创建集群网络和虚拟服务器实例。有关更多信息，请参阅集群网络和实例支持的区域和区域。
在“详细信息”部分，请填写以下信息：
- 名称：输入虚拟网络接口的唯一名称，如 my-virtual-network-interface。
- 资源组：为虚拟网络接口选择一个资源组。
- 标签：（可选）添加标签，以便您整理和查找资源。以后可以添加更多标记。有关更多信息，请参阅使用标记。
- 虚拟私有云：选择要将群集网络与之关联的 VPC。
为您的集群网络选择所需配置文件。可用配置文件是料斗 1 (hopper-1)
要向集群网络添加集群子网，请启用 “集群网络子网”部分。您现在可以添加集群子网，也可以在创建集群网络之后再添加。
- 对于集群器件1，请选择要创建的集群子网总数（8、16或32）。
- 为群集子网添加子网前缀。
某些场景可能需要使用更多子网。
查看摘要面板中的信息，然后单击创建群集网络。

通过 CLI 创建群集网络

要从 CLI 创建群集网络，请按照以下步骤操作：

设置 CLI 环境
使用 CLI 登录您的账户。输入密码后，系统会提示输入要使用的账户和地区：
```
ibmcloud login --sso
```
要创建一个集群网络，请输入以下命令：

   ibmcloud is cluster-network-create --vpc VPC --zone ZONE --profile PROFILE [--name NAME] [--subnet-prefixes-cidr SUBNET_PREFIXES_CIDR] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

其中：

-vpc: VPC 的标识或名称。
--zone: 该集群网络所在的区域。区域必须在指定的集群网络概要文件中被列为受支持。有关更多信息，请参阅集群网络支持的区域和区域。
--profile: 该集群网络要使用的概要文件的名称。可用配置文件为 hopper-1，用于 Hopper 1 集群网络。
--name: 集群网络的名称。
--subnet-prefixes-cidr: 以 CIDR 格式表示的集群网络子网前缀的 IPv4 范围。
--resource-group-id value: 资源组的标识。该 ID 与 --resource-group-name 互斥。
--resource-group-name value: 资源组的名称。该名称与 --resource-group-id 互斥。
--output value: 指定输出格式，仅支持 JSON。之一：JSON.
-q, --quiet: 禁止冗长输出。

命令示例

在指定的VPC和区域中创建具有特定配置文件的新集群网络：

ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name

在指定的VPC和区域中创建集群网络，使用特定配置文件和自定义名称（my-cl-net）：
```
ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name --name my-cl-net
```

创建一个集群网络，使用自定义名称并为子网前缀指定一个 CIDR 块。输出采用JSON格式：

ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name --name my-cl-net --subnet-prefixes-cidr 10.0.0.24/24 --output JSON

使用 API 创建群集网络

要使用 API 创建群集网络，请按照以下步骤操作：

使用正确的变量设置 API 环境。
将任何用于API命令的附加变量存储起来。例如：

version (字符串）：API 版本，格式为。YYYY-MM-DD

启动所有变量后，运行以下命令创建群集网络：

curl -X POST   "$vpc_api_endpoint/v1/cluster_networks?version=$api_version&generation=2" -H "Authorization: Bearer $iam_token" -d '{
   "name": "my-cluster-network",
   "profile": {
       "name": "hopper-1"
   },
   "vpc": {
       "id": "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b"
   },
   "zone": {
       "name": "us-east-3"
   }
 }'

可用的群集网络配置文件名称为 hopper-1

要查看整套群集网络 API，请参阅 VPC API 参考。

使用 Terraform 创建集群网络接口

下面的示例使用 Terraform 提供了一个群集网络实例：

resource "ibm_is_cluster_network" "is_cluster_network_instance" {
  name            = var.is_cluster_network_name  // change to update
  profile         = "hopper-1"
  resource_group  = "fee82deba12e4c0fb69c3b09d1f12345"
  subnet_prefixes {
    cidr = "10.0.0.0/24"
  }
  vpc             = "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b"
  zone            = "us-east-3"
}

后续步骤

若在创建集群网络时未创建集群网络子网，请参阅创建集群网络子网。