Como criar e gerenciar uma rede

Quando usar

Use este procedimento quando as máquinas virtuais precisarem de uma nova rede com sub-rede própria para um ambiente separado ou para o isolamento de um projeto. Este guia acompanha você desde a criação da rede até a exclusão.

A atribuição de endereços a uma máquina específica e a exclusão de endereços do pool são tratadas separadamente. Consulte Pool de endereços e endereçamento de VMs.

Pré-requisitos

• O papel Cluster master para redes de qualquer tipo, incluindo Routed e Q-in-Q.
• O papel vDC admin ou superior para Isolated e GENEVE; Routed e Q-in-Q não estão disponíveis para esse papel.
• Uma sub-rede escolhida com antecedência: IPv4 com prefixo de /16 a /29.
• Para Q-in-Q, as duas tags VLAN: externa e interna.
• vStack Center versão 3.0.4.

Criação de uma rede

Uma rede é criada como um objeto completo: o tipo, a sub-rede, o gateway, o MTU e as tags VLAN são definidos em um único formulário e não podem ser alterados após a criação. Somente o nome pode ser alterado depois.

1. Abra Provider Data Center → All Networks.

2. Clique em Add acima da tabela para abrir o formulário de criação de rede.

   

3. Preencha o formulário:

   Campo	Valor a inserir
   Type	Tipo de rede: Isolated (selecionado por padrão), Routed ou Q-in-Q
   Name	Nome da rede
   CIDR	Sub-rede IPv4 com prefixo de /16 a /29
   Gateway	Gateway padrão: um endereço dentro da sub-rede em CIDR. Este campo é opcional: se ficar vazio, o endereço é preenchido automaticamente
   MTU	1500 por padrão. A dica ao lado do campo mostra os limites do cluster; valores abaixo de 1000 ou acima de 9180 não são aceitos
   VLAN ID	Este campo aparece para os tipos Routed e Q-in-Q. Para Q-in-Q, é a tag externa (S-VLAN)
   C-VLAN	Este campo aparece apenas para Q-in-Q: a tag interna

4. Clique em Create a Network. O botão permanece desabilitado até que todos os campos obrigatórios sejam preenchidos e os valores passem na validação.

5. Aguarde até que a rede apareça na tabela All Networks. A criação é assíncrona: o dispatcher do cluster aceita a solicitação e a repassa ao agente de rede, por isso o registro não aparece imediatamente. Até a rede ser confirmada, ainda é cedo para atribuí-la a um VDC ou conectar máquinas a ela.

6. Atribua a rede a um data center virtual (VDC): abra o VDC → Networks, guia Primary, encontre a linha da rede e ative a opção na coluna Assign. Sem a atribuição, as máquinas do VDC não enxergam a rede.

O formulário de criação monta uma rede com sub-rede IPv4. Uma rede com sub-rede IPv6 ou uma rede dual-stack, em que as máquinas recebem endereços das duas famílias, é criada programaticamente. Os métodos estão listados no final desta página.

Se a rede não foi criada

Código	Causa	Ação
-606 "Bad type value"	O tipo de rede não foi reconhecido	Selecione um tipo na lista Type
-403 "Access denied"	O papel não tem permissão para criar esse tipo de rede	Somente o Cluster master pode criar redes Routed e Q-in-Q; peça a um usuário com esse papel
-647 "Empty cidr param value"	O campo CIDR está vazio	Especifique uma sub-rede
-644 "Bad cidr param value"	O valor de CIDR não pode ser interpretado como sub-rede	Verifique o formato: endereço de rede e prefixo separados por uma barra
-646 "You've asked too wide network"	O prefixo em CIDR é mais curto que /16	Restrinja a sub-rede; a mensagem especifica o número de bits
-643 "You've asked too narrow network"	O prefixo em CIDR é mais longo que /29, sem deixar endereços para as máquinas	Amplie a sub-rede
-680 "default_gw param is NULL"	O gateway foi passado como valor vazio	Insira um endereço em Gateway ou deixe o campo sem preencher
-681 "default_gw param has bad value"	O valor de Gateway não pode ser interpretado como endereço IPv4	Corrija o endereço do gateway
-682 "default_gw value is out of cidr block"	O endereço em Gateway está fora da sub-rede em CIDR	Escolha um endereço dentro da sub-rede
-628 "mtu param value is out of acceptable range (1000-9180)"	O valor de MTU está fora do intervalo permitido	Defina um valor de 1000 a 9180
-629 "mtu param value exceeds maximal"	MTU está acima do máximo do cluster	Reduza o valor até o máximo mostrado na dica ao lado do campo
-609 "Bad mixup of network type and params"	Para uma rede Routed, o campo VLAN ID está vazio	Preencha VLAN ID
-602 "Bad param value for vlan_id"	O número em VLAN ID está fora do intervalo aceito pelo cluster	Combine o número da VLAN com o administrador de rede
-610 "Bad param qinq_id", -611 "qinq_id param value is out of acceptable range"	O valor de C-VLAN não pode ser interpretado ou está fora do intervalo	Corrija a tag interna
-612 "qinq_id param is required for Q-in-Q network type"	A tag interna não foi definida para o tipo Q-in-Q	Preencha C-VLAN
-613 "qinq_id is not allowed for this network type"	A tag interna foi definida para um tipo que não a aceita	Altere o tipo para Q-in-Q ou remova a tag interna
-636 "Bad backend param value"	O backend de rede foi definido como número negativo; isso ocorre apenas em solicitações programáticas	Mantenha o valor padrão
-659 "Failed to obtain cluster status while creating network"	O status do cluster está indisponível no momento da solicitação	Verifique o status do cluster e tente novamente
-617 "Network creation failed"	Os parâmetros foram aceitos, mas a criação não foi concluída	Tente novamente; se não resolver, verifique os logs do cluster
-12 "Failed to create network"	O formulário foi aceito, mas o agente de rede não aplicou a configuração nos nós	Verifique o status dos nós e os logs do cluster e depois crie a rede novamente

Verificação de que a rede apareceu

1. Abra Provider Data Center → All Networks. A nova rede está na tabela com os valores de ID, Type, Name, VLAN ID, MTU, CIDR, Used IP Addresses e Free IP Addresses. O campo Search in table filtra uma lista longa, e o botão CSV exporta a lista inteira.

   

2. Abra o cartão da rede e expanda a seção General properties. Compare CIDR, Gateway, MTU e VLAN ID com os valores que você inseriu: esses campos são somente leitura. A linha Latest changes: mostra quando a rede foi modificada pela última vez.

3. Verifique a atribuição: na seção VDC → Networks, na guia Primary, a rede tem a opção Assign ativada. A lista de redes do VDC mostra apenas as redes atribuídas a ele, de acordo com as permissões do usuário.

Quem criou a rede pode modificá-la e excluí-la, enquanto o Cluster master pode modificar e excluir qualquer rede, independentemente de quem a criou.

Renomeação de uma rede

O nome é o único parâmetro da rede que pode ser alterado. A alteração é síncrona: a confirmação chega imediatamente.

1. Abra Provider Data Center → All Networks e acesse o cartão da rede.

2. Na seção General properties, insira um novo nome no campo Name. Os demais campos, CIDR, Gateway, MTU, VLAN ID e os contadores de endereços, são somente leitura.

3. Clique em Save changes. O botão fica desabilitado até que o nome seja alterado.

4. Verifique se o novo nome aparece no cabeçalho do cartão e na tabela All Networks.

O nome pode ficar vazio; nesse caso, a rede é identificada pelo ID.

Se a renomeação falhar

Código	Causa	Ação
-47301 "No param id"	A rede não foi identificada: a solicitação foi enviada sem ID	Volte para All Networks e abra novamente o cartão da rede
-47305 "No params has been provided"	A solicitação de salvamento foi enviada sem campos alterados	Insira um novo nome e depois salve
-403 "Access denied"	A rede está atribuída a outro VDC e foi criada por outro usuário	Renomeie-a como Cluster master
-47306 "Network unknown"	A rede com esse ID não existe mais; ela pode ter sido excluída em outra sessão	Atualize a lista All Networks
-78 "Database error"	Erro de banco de dados	Tente novamente; se não resolver, entre em contato com o suporte

Exclusão de uma rede

A exclusão é assíncrona: o comando é enviado ao agente de rede, e o resultado chega depois. O Cluster master pode excluir qualquer rede; o vDC admin só pode excluir as redes que criou.

1. Desconecte todos os consumidores da rede: interfaces de rede de máquinas virtuais e roteadores definidos por software (Edge). Enquanto a rede estiver em uso, a exclusão será rejeitada.

2. Abra o cartão da rede, clique em Actions e selecione Delete Network. A mesma ação está disponível na linha da rede na lista All Networks.

3. Leia o aviso na caixa de diálogo: a exclusão pode afetar não só o VDC atual, mas o cluster inteiro. Confirme com o botão Delete ou feche a caixa de diálogo com Cancel.

4. Aguarde até que o registro desapareça da tabela All Networks. Se a rede continuar na lista, atualize-a novamente: a exclusão é confirmada pelo agente de rede, e não pela própria caixa de diálogo.

Se a exclusão falhar

Código	Causa	Ação
A ação Delete Network não aparece no menu Actions	Você não é quem criou a rede nem Cluster master, ou a rede tem um erro de ciclo de vida ou de atribuição	Atue como Cluster master; resolva o erro de ciclo de vida antes da exclusão
-707 "Network is used still so can't be deleted"	Há máquinas ou Edge conectados à rede	Desconecte os consumidores e tente novamente
-403 "Access denied"	A rede está atribuída a outro VDC e foi criada por outro usuário	Exclua-a como Cluster master
-659 "Failed to obtain cluster status while creating network"	O status do cluster está indisponível no momento da solicitação	Verifique o status do cluster e tente novamente
-722 "Internal database error"	Erro de banco de dados	Tente novamente; se não resolver, entre em contato com o suporte
-12 "Failed to delete network"	O agente não concluiu a exclusão; a rede pode permanecer na configuração dos nós	Verifique o status dos nós e os logs do cluster e depois tente excluir novamente

Veja também

• Redes do cluster: tipos, dual-stack e pools de endereços — estrutura da rede e limites dos parâmetros.
• Pool de endereços e endereçamento de VMs — o que fazer depois de criar uma rede.

Métodos da API

As operações da API tratadas nesta página são nets-create, net-list, net-set, nets-delete, vdc-assign-network e vdc-deassign-network. Consulte a referência da API.