Criação de uma interface de rede de cluster

Uma interface de rede de cluster é uma placa de rede virtual que conecta sua instância a uma sub-rede de rede de cluster. Você pode criar uma interface de rede de cluster durante a criação de uma rede de cluster ou após o provisionamento da rede.

Antes de Iniciar

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

Criação de uma interface de rede de cluster no console

Para criar uma interface de rede de cluster 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 Menu de navegação e clique em Ícone de 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 interface. A página Visão geral é exibida.

  4. Clique na guia Interfaces para exibir a tabela Interfaces de rede do cluster e, em seguida, clique em Criar.

  5. No painel lateral da interface Criar, preencha as seguintes informações:

    • Digite um nome de interface.

    • Selecione a sub-rede da rede do cluster.

      Um endereço IP primário é selecionado para você e fica disponível para visualização após a criação.

  6. Clique em Criar. A interface de rede do cluster é solicitada para uso.

Criando uma interface de rede de cluster a partir da CLI

Para criar uma interface de 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 interface de rede de cluster, digite o seguinte comando:

    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]
    

    Em que:

    CLUSTER_NETWORK
    ID ou nome da rede de cluster.
    --rip
    ID ou nome do IP reservado para associar o endereço IP primário à interface de rede do cluster.
    --rip-address
    O endereço IP do IP reservado a ser vinculado à interface de rede de cluster, que ainda não deve estar reservado na sub-rede.
    --rip-auto-delete
    Indica se esse membro com IP reservado na sub-rede da rede do cluster é excluído automaticamente quando qualquer um dos destinos for excluído ou quando o IP reservado na sub-rede da rede do cluster for desvinculado. Um dos seguintes: true, false (padrão: true).
    --rip-name
    O nome do endereço IP reservado para esta sub-rede do cluster.
    --subnet
    ID ou nome da sub-rede.
    --vpc
    ID ou nome da VPC. Só é necessário especificar o recurso exclusivo por nome dentro desta VPC.
    --name
    Nome da interface de rede do cluster.
    --output
    Especifique o formato de saída. Somente JSON é suportado. Um de: JSON.
    -q, --quiet
    Suprimir a saída detalhada.

Exemplos de comando

  • Para criar uma interface de rede de cluster com IP reservado:

    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
    
  • Para criar uma interface de rede de cluster usando um IP reservado de uma sub-rede de cluster existente:

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

Criação de uma interface de rede de cluster com a API

Para criar uma interface 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 uma interface de rede de cluster:

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

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

Criação de uma interface de rede de cluster com o Terraform

O exemplo a seguir provisiona uma interface de rede de cluster usando o 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"
}

Próximas etapas

Para criar instâncias de servidor virtual e anexá-las a interfaces na rede do cluster, consulte Criando instâncias de servidor virtual e Anexando uma interface de rede de cluster a uma instância.