Pool de endereços e endereçamento de VMs

Quando usar

Use este procedimento para controlar quais endereços de rede podem ser atribuídos a máquinas virtuais: reservar um endereço para um equipamento físico ou um serviço externo, restaurar um endereço excluído anteriormente, encontrar uma máquina pelo endereço ou verificar se os endereços disponíveis estão se esgotando.

Este guia trata de uma rede existente. A criação de redes é abordada em um guia à parte: Como criar e gerenciar uma rede.

Pré-requisitos

• A rede foi criada e atribuída a um data center virtual (VDC).
• Para visualizar o conteúdo do pool, o privilégio View IP Pool Details.
• Você sabe com o pool de qual rede está trabalhando: encontre-a pela coluna ID na lista All Networks.
• vStack Center versão 3.0.4.

Como uma máquina recebe um endereço

Um endereço é alocado quando uma interface de rede é adicionada a uma máquina: no cartão da VM, é o botão Add network. O vStack Center pega um endereço livre do pool da rede selecionada e o atribui à máquina; em uma rede dual-stack, a máquina recebe endereços das duas famílias. O endereço atribuído é exibido no mesmo lugar, na seção Networks do cartão da máquina, na coluna IP, ao lado de MAC e do número do slot.

O pool determina quais endereços podem ser atribuídos. Para IPv4, ele é uma lista de endereços permitidos; para IPv6, é uma lista de reservas, ou exclusões. Isso explica o comportamento duplo das operações abaixo: "excluir um endereço" remove um registro do pool no caso do IPv4 e adiciona um registro de reserva no caso do IPv6. Para saber mais sobre essa assimetria, consulte Redes do cluster: tipos, dual-stack e pools de endereços.

Visualização do conteúdo do pool

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

2. Expanda a seção IPPool space. O cabeçalho dela mostra a sub-rede da rede e, abaixo, uma grade com os endereços dessa sub-rede. A grade se baseia na sub-rede IPv4: as reservas IPv6 não são exibidas nela.

3. Leia os estados dos endereços com os três botões de filtro acima da grade. Cada um exibe um contador e deixa na grade apenas os próprios endereços; clicar novamente remove o filtro.

   Filtro	Endereços exibidos	Pode ser atribuído a uma máquina
   N free IP address	O endereço está no pool e não é usado por ninguém	Sim, será atribuído à próxima máquina
   N used IP address	O endereço já está atribuído a uma máquina	Não, está em uso
   N absent IP address	O endereço está dentro da sub-rede, mas não está no pool	Não, até que você o devolva ao pool

4. Encontre o endereço desejado: o campo Search IP address acima da grade pesquisa por uma substring, e o seletor abaixo da grade altera a quantidade de endereços por página (24 por padrão).

5. Clique em um endereço para abrir uma janela com a sub-rede (Subnet address:), o próprio endereço (IP address:), um menu de ações disponíveis e o campo Comment.

O terceiro estado, absent, decorre diretamente da lógica da lista de permissões do IPv4: o endereço está dentro da sub-rede, mas não pode ser atribuído até ser adicionado ao pool. O campo Comment é especialmente útil para esses endereços: a anotação é salva nas suas configurações e lembra por que o endereço foi excluído da atribuição.

Se o pool não for exibido

Código	Causa	Ação
-403 "Access denied"	O privilégio View IP Pool Details está ausente	Solicite o privilégio ao administrador do cluster
-25503 "network_id param does not exist", -25504 "network_id param is null"	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
-25505 "network_id param is not numeric"	O ID da rede não foi passado como número; isso ocorre apenas em solicitações programáticas	Passe um ID numérico
-25501 "Params section does not exist", -25502 "Params section is null"	A solicitação foi enviada sem parâmetros; isso ocorre apenas em solicitações programáticas	Adicione uma seção de parâmetros com o ID da rede
-7	Erro de banco de dados	Tente novamente; se não resolver, entre em contato com o suporte

Exclusão de um endereço da atribuição

Isso remove um endereço da alocação automática, por exemplo, para atribuí-lo a um servidor físico ou reservá-lo para um serviço futuro.

1. Na seção IPPool space, ative o filtro N free IP address e clique no endereço desejado.

2. No menu de ações, selecione Delete from IP pool.

3. Confirme a exclusão na caixa de diálogo. Ela pergunta sobre um endereço específico: confira-o e clique em Delete; o botão Cancel fecha a caixa de diálogo sem alterações.

4. Verifique se o endereço passou para a categoria absent: o contador N absent IP address aumenta, e o endereço fica visível com esse filtro. Uma notificação com o endereço e o número da rede também indica o sucesso.

Um endereço no estado used não tem ações no menu: um endereço em uso não pode ser excluído da atribuição. Por outro lado, a exclusão não retira o endereço de uma máquina que já o recebeu: a operação afeta apenas as atribuições futuras.

No caso do IPv6, a mesma operação adiciona o endereço à lista de reservas; o resultado é o mesmo: o endereço não pode mais ser atribuído a uma máquina.

Se não for possível excluir um endereço

Código	Causa	Ação
-25722 "The address doesn't match network cidr"	O endereço está fora da sub-rede da rede	Compare o endereço com o CIDR da rede
-25724 "The address does not exist"	O endereço já está fora do pool e aparece com o filtro absent	Nenhuma ação é necessária
-25727 "The address is already reserved"	O endereço IPv6 já está reservado	Nenhuma ação é necessária
-25725 "The network does not support IPv4"	A rede não tem sub-rede IPv4	Use os endereços IPv6 desta rede
-25726 "The network does not support IPv6"	A rede não tem sub-rede IPv6	Use os endereços IPv4 desta rede
-25708 "address param is not valid"	O endereço não pode ser interpretado	Corrija o formato do endereço
-25720 "The network does not exist"	A rede com esse ID não existe mais	Atualize a lista All Networks

Como tornar um endereço novamente disponível para atribuição

Esta é a operação inversa: o endereço volta a ficar disponível para as máquinas.

1. Na seção IPPool space, ative o filtro N absent IP address e clique no endereço desejado.

2. No menu de ações, selecione Add. Essa operação não pede confirmação.

3. Verifique se o endereço passou para a categoria free: o contador N free IP address aumenta, e o endereço fica visível com esse filtro.

No caso do IPv6, a mesma operação remove a reserva.

Se não for possível devolver um endereço ao pool

Código	Causa	Ação
-25622 "The address doesn't match network cidr"	O endereço está fora da sub-rede da rede	Compare o endereço com o CIDR da rede
-25623 "The address exists already"	O endereço já está no pool e aparece com o filtro free	Nenhuma ação é necessária
-25626 "The address is not reserved"	O endereço IPv6 já não está reservado	Nenhuma ação é necessária
-25624 "The network does not support IPv4"	A rede não tem sub-rede IPv4	Use os endereços IPv6 desta rede
-25625 "The network does not support IPv6"	A rede não tem sub-rede IPv6	Use os endereços IPv4 desta rede
-25608 "address param is not valid"	O endereço não pode ser interpretado	Corrija o formato do endereço
-25620 "The network does not exist"	A rede com esse ID não existe mais	Atualize a lista All Networks

Como descobrir quais endereços estão em uso e por quem

1. Abra o cartão da rede e expanda a seção IPPool usage. A tabela com ID, VDC name e Used IP Addresses discrimina os endereços em uso por VDC e responde à primeira pergunta: qual VDC usou os endereços desta rede.

2. Desça até o nível da máquina. Abra o VDC correspondente → Virtual Machines e verifique a seção Networks nos cartões das máquinas: a coluna IP mostra o endereço recebido pela interface.

3. Verifique se você encontrou o endereço na interface correta: na seção Networks, IP aparece ao lado de Slot, Port e MAC.

A interface rastreia a relação até o VDC, e não diretamente até a máquina: a API fornece a cadeia completa rede → VDC → máquina → endereço. Os métodos estão listados no final desta página.

Verificação da disponibilidade de endereços

A disponibilidade de endereços é exibida em três lugares, e cada um responde a uma pergunta diferente.

Onde olhar	O que mostra
Provider Data Center → All Networks	Colunas Used IP Addresses e Free IP Addresses para cada rede do cluster; o botão CSV exporta a tabela inteira
Cartão da rede, seção IPPool space	Contadores free, used e absent para a sub-rede desta rede
VDC → Networks, guia IP Data	Used IP addresses by this vDC, Used IP Addresses, Free IP Addresses e Addrs limit: uso por um VDC específico e o limite dele

Os contadores da interface contam endereços IPv4: Free IP Addresses significa endereços do pool que não são usados por ninguém. Os endereços IPv6 livres são contados de outra forma e, para sub-redes amplas, a quantidade deles nem chega a ser calculada. Para entender o motivo, consulte Redes do cluster: tipos, dual-stack e pools de endereços.

Veja também

• Redes do cluster: tipos, dual-stack e pools de endereços — por que os pools IPv4 e IPv6 funcionam de forma diferente.
• Como criar e gerenciar uma rede — criação de uma rede e atribuição dela a um VDC.

Métodos da API

As operações da API tratadas nesta página são net-ippool-show, net-ippool-add, net-ippool-delete, net-ippool-usage e net-ippool-free. Consulte a referência da API.