Como conectar uma VM a uma rede

No vStack Center, uma interface de rede de VM é uma porta em uma rede do VDC (data center virtual) com slot, endereço MAC, endereços IPv4 e IPv6 e limite de taxa próprios. Há cinco slots, como no caso dos discos. A porta é criada junto com a VM ou adicionada separadamente.

O vStack Center aloca endereços a partir do pool de endereços da rede. Por padrão, ele mesmo seleciona um endereço IPv4 disponível; você pode especificar um endereço explicitamente. A mesma abordagem se aplica ao IPv6, mas os endereços são especificados como uma lista, com até oito por porta. Cada um é verificado segundo quatro condições: formato, pertencimento à sub-rede IPv6, não estar reservado e não estar em uso. Se nenhuma lista for especificada e a rede tiver uma sub-rede IPv6 configurada, o vStack Center alocará um endereço por conta própria; quando não houver mais endereços disponíveis na sub-rede, será retornado o erro -3579, "IPv6 IP-pool is depleted".

Cada família de endereços pode ser desabilitada de forma independente. Se a rede não tiver uma sub-rede para uma família de endereços, essa família será considerada desabilitada, independentemente da solicitação. Essa porta recebe um endereço apenas na família configurada para a rede.

O IP guard protege contra falsificação de endereços: o nó permite tráfego apenas a partir do endereço atribuído. Ele vem habilitado por padrão. Só pode ser desabilitado em redes isoladas e apenas por um sujeito com as permissões correspondentes.

A adição e a exclusão de uma interface exigem uma VM parada: os dispositivos de rede são montados na configuração do hipervisor durante a inicialização. Já o limite de taxa pode ser alterado com a VM em execução.

As interfaces aparecem na seção Networks do cartão da VM: uma tabela com as colunas ID, Name, Slot, Port, MAC, IP, IP guard e MBps limit, além do botão Add network.

Como adicionar uma interface

Acesso: o Cluster master pode acessar qualquer VM; um usuário comum pode acessar as VMs dos seus VDCs.

1. Pare a VM. Para uma VM em execução, a operação é rejeitada com o erro -3526, "vm id==N must be stopped in order to add nic".

2. Na seção Networks do cartão da VM, clique em Add network.

   

3. Selecione uma rede atribuída ao VDC da VM. Uma rede de outro VDC é rejeitada com o erro -3562.

4. Preencha os demais campos. Se nenhum slot for especificado explicitamente, o vStack Center usará o primeiro disponível:

   Campo	Valor
   Rede	Uma rede no VDC da VM; obrigatório
   Slot	1–5; se omitido, um slot disponível é selecionado automaticamente
   Endereço IPv4	Um endereço específico; se omitido, um endereço é alocado a partir do pool de endereços da rede
   Endereço MAC	Um endereço específico; se omitido, um é gerado
   Endereços IPv6	Até 8 endereços por porta; se omitido, um endereço é alocado a partir da sub-rede IPv6 da rede
   Ignorar família de endereços	Desabilita IPv4 ou IPv6 para esta porta; ambos vêm habilitados por padrão
   IP guard	Habilitado por padrão; só pode ser desabilitado em redes isoladas
   MBps limit	Limite de taxa da porta

5. Aguarde até que a interface apareça na tabela Networks. Os endereços atribuídos, o endereço MAC e o número da porta também são exibidos ali. Você precisa do número para distinguir as portas ao editar um limite ou excluir uma porta.

Porta dual-stack

A porta recebe IPv6 automaticamente se a rede tiver uma sub-rede IPv6 configurada. Para especificar os endereços em vez de selecioná-los automaticamente, forneça uma lista.

Para atribuir apenas IPv6, desabilite a família IPv4 para a porta. Nesse caso, nenhum endereço é alocado a partir do pool IPv4, e as verificações de IPv4 não são executadas. Você não pode especificar um endereço IPv4 nesse caso: essa combinação é rejeitada com o erro -3577.

Os endereços da porta aparecem na coluna IP da seção Networks: para uma porta sem IPv4, a coluna fica vazia; todos os endereços IPv6 são listados.

Se a interface não foi adicionada

Falha	Motivo	Solução
-3526 vm must be stopped in order to add nic	A VM está em execução	Pare a VM
-3530, -3544 no available slots	Todos os cinco slots estão ocupados	Libere um slot
-3545 Slot N occupied already	O slot selecionado está ocupado	Deixe o slot em branco
-3542 slot outside the range 1..5	O valor do slot é inválido	Especifique um slot dentro do intervalo
-3562 Network isn't assigned to vdc	A rede não pertence ao VDC da VM	Selecione uma rede deste VDC
-3563 Disabling ip_guard available on Isolated networks only	O IP guard foi desabilitado em uma rede de outro tipo	Mantenha o IP guard habilitado
-403 Access denied	Permissões insuficientes para desabilitar a proteção	Solicite as permissões ou mantenha a proteção habilitada
-3565 Bad address param	Endereço IPv4 inválido	Verifique o formato
-3549 IP-pool of network has been depleted	Não há mais endereços disponíveis no pool de endereços da rede	Libere endereços ou amplie o pool de endereços da rede
-3550 addr limit reached	O par VDC↔rede atingiu o limite de endereços; ainda pode haver endereços disponíveis no pool	Aumente Addrs limit desse par na guia IP Data do cartão do VDC ou libere as portas desse VDC nessa rede
-3571 IPv6 addresses limit exceeded	Mais de 8 endereços IPv6 por porta	Reduza a lista
-3572 Bad IPv6 address format	Endereço IPv6 inválido	Verifique o formato
-3573 IPv6 address is absent at IP-pool	O endereço está fora da sub-rede IPv6 da rede	Selecione um endereço da sub-rede da rede
-3574 IPv6 address is already allocated	O endereço está em uso	Selecione outro endereço
-3575 Duplicate IPv6 address in request	A lista contém uma duplicata	Remova a duplicata
-3576 IPv6 address is reserved	O endereço está reservado na rede	Selecione um endereço fora do intervalo reservado
-3577 Network port address conflicts with skip or network IP family	Foi especificado um endereço para uma família desabilitada na porta	Remova o endereço ou habilite a família
-3579 IPv6 IP-pool is depleted	Não há mais endereços disponíveis na sub-rede IPv6 da rede	Libere endereços, amplie a sub-rede ou desabilite o IPv6 para a porta
-3508 nic has bad ratelimit_mbits value	Limite de taxa inválido	Verifique o valor

Como excluir uma interface

A exclusão também exige uma VM parada. Pare a VM e exclua a porta desejada na seção Networks do cartão dela.

Falhas: -3724 significa que a VM está em execução, -3723 significa que a versão da configuração da VM não suporta a exclusão de uma interface, e -3720 significa que a VM não tem essa porta.

Como limitar a taxa de uma porta

O limite é definido no campo MBps limit da porta desejada; o valor zero remove o limite. É necessário um papel no VDC com role_id ≤ 3.

Não é preciso parar a VM. Para uma VM desligada, apenas a configuração é alterada, e o limite entra em vigor imediatamente; para uma VM em execução, o valor é enviado ao nó. É possível um sucesso parcial: "Ratelimit has been set (DB), but agent didn't apply it" significa que o valor foi salvo, mas o hipervisor não o aceitou. Esse limite entra em vigor na próxima inicialização da VM. Outras falhas: -7224 significa que a VM não tem essa porta, -7223 significa que a versão da configuração da VM é 3, e -7228 significa que a VM está bloqueada por outra operação.

Veja também

• Como criar, excluir e mover uma máquina virtual — como definir as portas de rede ao criar uma VM e por que mover uma VM para outro VDC depende das redes
• Como gerenciar os discos e os recursos computacionais da VM — os demais slots e limites da VM

Métodos da API

As operações da API desta página são vms-add-nic, vm-remove-nic e vm-ratelimit-nic — consulte a referência da API.