Criação de uma sub-rede de cluster

Uma sub-rede de rede de cluster é uma sub-rede em uma rede de cluster. Embora seja semelhante e tenha uma finalidade semelhante à de uma sub-rede VPC, ela é restrita à comunicação dentro de um cluster de servidores. No entanto, a sub-rede permite definir o CIDR da sub-rede e configurar IPs reservados para a sub-rede da rede do cluster. Esses IPs reservados incluem endereços especificados por você e vêm com uma função de exclusão automática semelhante à dos IPs reservados da sub-rede VPC.

Antes de Iniciar

É possível criar uma sub-rede de rede de cluster com o console, a CLI, a API ou o Terraform.

Criação de uma sub-rede de cluster no console

Para criar uma sub-rede em um cluster de rede no console, siga estas etapas:

  1. No seu navegador, abra o console do IBM Cloud e faça login na sua conta.

  2. Selecione o ícone do menu Navegação e clique no ícone Infraestrutura VPC > Rede > Redes de cluster.

  3. Na página Redes de cluster para VPC, clique no link do nome da rede de cluster em que você deseja criar uma sub-rede. A página Visão geral é exibida.

  4. Clique na guia Sub-redes para exibir a tabela Sub-redes da rede do cluster e, em seguida, clique em Criar.

  5. No painel lateral Criar sub-rede, preencha as seguintes informações:

    • Digite um nome de sub-rede.
    • Revise o prefixo do endereço. Altere conforme necessário.
    • Selecione o número total de endereços IP (o padrão é 256).
    • Verifique o intervalo de IP e altere conforme necessário.
    • Revisar o espaço de endereço especificado. Ajuste o intervalo de IPs conforme necessário.
  6. Clique em Criar. A sub-rede da rede do cluster é solicitada para uso.

Criando uma sub-rede de cluster a partir da CLI

Para criar uma sub-rede de cluster a partir da CLI, siga estas etapas:

  1. Configure seu ambiente da CLI.

  2. Faça login na sua conta usando a CLI. Depois de inserir a senha, o sistema solicita a conta e a região:

    ibmcloud login --sso
    
  3. Para criar uma sub-rede de rede de cluster, digite o seguinte 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 ipv4] [--output JSON] [-q, --quiet]
    

    Em que:

    CLUSTER_NETWORK
    ID ou nome da rede de cluster.
    --total-ipv4-address-count
    O número total de endereços IPv4 necessários. Deve ser uma potência de 2.
    --ipv4-cidr-block
    O intervalo IPv4 da sub-rede da rede de cluster, expresso no formato CIDR.
    --name
    O nome dessa sub-rede de rede de cluster.
    --isolation-group
    O grupo de isolamento para a sub-rede da rede do cluster. Deve ser um valor inteiro maior que 0. Use 1 para hopper-1.
    --output
    Especificar o formato de saída. Somente JSON é suportado. Um de: JSON.
    -q, --quiet
    Suprimir a saída detalhada.

Exemplo de comando

Para criar uma sub-rede de rede de cluster com o nome cli-cn-sub-1 para a rede de cluster cli-cn-1:

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

Criação de uma sub-rede de rede de cluster com a API

Para criar uma sub-rede de rede de cluster com a API, siga estas etapas:

  1. Configure o seu Ambiente de API com as variáveis direitas.

  2. Armazene as variáveis adicionais a serem usadas nos comandos da API. Por exemplo:

    version (string): A versão da API, no formato YYYY-MM-DD.

  3. Quando todas as variáveis forem iniciadas, execute o seguinte comando para criar a sub-rede da rede do cluster:

    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
          "isolation_group:1"
        }'
    

Para ver o conjunto completo de APIs de rede de cluster, consulte a referência de API de VPC.

Criação de uma sub-rede de rede de cluster com o Terraform

O exemplo a seguir provisiona uma sub-rede de rede de cluster usando o 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
  isolation_group = 1
}

Próximas etapas

Para criar interfaces de rede de cluster após criar sub-redes de rede de cluster, consulte Criando uma interface de rede de cluster.