Creación de una subred de red de clúster

Una subred de red de clúster es una subred dentro de una red de clúster. Aunque se parece a una subred VPC, ofrece menos funciones. Sin embargo, sí permite definir el CIDR de la subred y configurar IPs reservadas para la subred de la red del cluster. Estas IPs reservadas incluyen las direcciones que especifiques y vienen con una función de auto-borrado similar a la de las IPs reservadas de subred VPC.

Antes de empezar

Repasar las consideraciones de planificación y los problemas y limitaciones conocidos.

Puede crear una subred de red de clúster con la consola, CLI, API o Terraform.

Creación de una subred de red de clúster en la consola

Para crear una subred dentro de un clúster de red en la consola, siga estos pasos:

Desde su navegador, abra la consola IBM Cloud y conéctese a su cuenta.
Seleccione el de navegación, luego haga clic en el ícono Infraestructura > Red > Redes de clúster.
En la página Redes de clúster para VPC, haga clic en el enlace del nombre de la red de clúster en la que desea crear una subred. Aparece la página Resumen.
Haga clic en la pestaña Subredes para mostrar la tabla Subredes de red del clúster y, a continuación, haga clic en Crear +.
Complete la información en el panel lateral Crear subred y, a continuación, haga clic en Crear.
- Introduzca un nombre de subred.
- Revise el prefijo de la dirección. Cambie según sea necesario.
- Seleccione el número de direcciones IP totales (por defecto es 256).
- Revise el rango IP indicado. Cambie según sea necesario.
- Revisa el espacio de direcciones especificado. Ajuste el rango de IP según sea necesario.

Se solicita el uso de la subred de red del clúster.

Creación de una subred de red de clúster en la CLI

Para crear una subred de red de clúster en la CLI, siga estos pasos:

Configure el entorno de la CLI.
Inicie sesión en su cuenta con la CLI. Una vez introducida la contraseña, el sistema le pedirá la cuenta y la región que desea utilizar:
```
ibmcloud login --sso
```
Para crear una subred de red de clúster, introduzca el siguiente comando:
```
ibmcloud is cluster-network-subnet-create CLUSTER_NETWORK (--total-ipv4-address-count TOTAL_IPV4_ADDRESS_COUNT | --ipv4-cidr-block IPV4_CIDR_BLOCK) [--name NAME] [--ip-version IP_VERSION] [--output JSON] [-q, --quiet]
```
Donde:

CLUSTER_NETWORK

ID o nombre de la red del clúster.

--total-ipv4-address-count

El numero total de direcciones IPv4 necesarias. Debe ser una potencia de 2.

--ipv4-cidr-block

El rango de IPv4 de la subred de la red del clúster, expresado en formato CIDR.

--name

El nombre de esta subred de red de clúster.

--output

Especificar el formato de salida, solo se admite JSON. Valores posibles: JSON.

-q, --quiet

Suprimir la salida detallada.

Ejemplo de mandato

Para crear una subred de red de clúster con el nombre cli-cn-sub-1 para la red de clúster cli-cn-1:

ibmcloud is cluster-network-subnet-create cli-cn-1 --name cli-cn-sub-1 --total-ipv4-address-count 32

Creación de una subred de red de clúster con la API

Para crear una subred de red de clúster con la API, siga estos pasos:

Configure el entorno de la API con las variables adecuadas.
Almacene las variables adicionales que se van a utilizar en los mandatos de la API; por ejemplo:

version (cadena): La versión de la API, en formato YYYY-MM-DD.

Una vez iniciadas todas las variables, ejecute el siguiente comando para crear la subred de red del clúster:

curl -X POST "$vpc_api_endpoint/v1/cluster_networks/$cluster_network_id/subnets?version=$today&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-cluster-network-subnet",
      "total_ipv4_address_count": 2048
    }'

Para ver el conjunto completo de API de red de clústeres, consulte la referencia de API de VPC.

Creación de una subred de red de clúster con Terraform

El siguiente ejemplo aprovisiona una subred de red de cluster utilizando Terraform:

resource "ibm_is_cluster_network_subnet" "is_cluster_network_subnet_instance" {
  cluster_network_id        = var.is_cluster_network_subnet_cluster_network_id
  ip_version                = var.is_cluster_network_subnet_ip_version
  name                      = var.is_cluster_network_subnet_name
  total_ipv4_address_count  = var.is_cluster_network_subnet_total_ipv4_address_count
  // ipv4_cidr_block = var.is_cluster_network_subnet_ipv4_cidr_block #conflicts with total_ipv4_address_count
}