Configurando IPs Elásticos
O Equinix Metal você a capacidade de atribuir endereços IP elásticos estaticamente aos seus servidores por meio do console e da API.
Endereços IP que podem ser usados como IPs elásticos:
- Addresses in Reserved Public IPv4 subnets
- Global Anycast IP Addresses
- Private IPv4 Addresses
- Public IPv6 Addresses
Todos os endereços IP precisam estar no mesmo área metropolitana e Projeto dos servidores aos quais você os está atribuindo, com exceção dos endereços IP Global Anycast (que podem ser usados globalmente).
Adicionando endereços IP elásticos a um servidor existente
- Console
- CLI
- API
Na aba Rede do servidor, na seção IPs Elásticos, clique em + Atribuir Novo Elástico. Uma janela deslizante será exibida, permitindo que você selecione a sub-rede e os endereços IP a serem atribuídos.
Você pode atribuir um IP elástico a um servidor com o comando metal ip assign. Forneça o endereço IP e o CIDR que você gostaria de atribuir ao servidor na flag --address.
metal ip assign --device-id <UUID> --address 198.51.100.3/31
A resposta ao comando de atribuição contém um UUID na coluna ID. Se posteriormente você cancelar a atribuição do IP Elástico, você precisará deste UUID.
+--------------------------------------+----------------+--------+----------------------+
| ID | ADDRESS | PUBLIC | CREATED |
+--------------------------------------+----------------+--------+----------------------+
| c6377504-b6cd-4bf9-aaea-ebba769e0b7e | 198.51.100.3 | true | 2022-12-21T16:28:58Z |
+--------------------------------------+----------------+--------+----------------------+
Para atribuir um IP elástico a um servidor na API, envie uma solicitar POST para o endpoint /devices/{id}/ips. O UUID do servidor é especificado no caminho e o endereço IP e CIDR são passados no corpo da solicitar.
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/ips" \
-d '{
"address": "198.51.100.3/31"
}'
Você pode atribuir um único endereço IP de uma sub-rede enviando apenas esse IP. Você pode atribuir a sub-rede inteira enviando o tamanho total da sub-rede ou você especificar uma sub-rede de tamanho menor. As opções completas de parâmetros estão disponíveis na Referência da API .
Observação: na resposta à solicitar de atribuição, haverá um UUID no campo "id". Se você desejar posteriormente remover a atribuição do IP elástico, você desse UUID.
Configuração de IP do host
Ao contrário dos IPs de gerenciamento, os IPs elásticos não são configurados automaticamente em seus servidores. Como medida de segurança, não mantemos acesso aos servidores para atualizar seus arquivos de configuração de rede após a instalação do sistema operacional, você precisa adicionar novos endereços IP à configuração de rede do servidor.
Usando o endereço IP de exemplo 198.51.100.3, as seguintes alterações de configuração tornarão o endereço IP utilizável em seu servidor:
- Ubuntu/Debian
- netplan
Para configurar temporariamente (não retornará na reinicialização):
sudo ip addr add 198.51.100.3 dev lo
Para tornar permanente, adicione a /etc/network/interfaces:
auto lo:0
iface lo:0 inet static
address 198.51.100.3
netmask 255.255.255.255
Para configurar temporariamente (não retornará na reinicialização):
sudo ip addr add 198.51.100.3 dev lo
Para tornar permanente, adicione a /etc/netplan/00-elastic.yaml:
network:
version: 2
renderer: networkd
ethernets:
lo:
addresses:
- 127.0.0.1/8
- 198.51.100.3/32
então ou sudo netplan try ou sudo netplan apply
Acompanhamento de endereços IP elásticos
- Console
- CLI
- API
Para verificar o status das sub-redes e endereços IP no console, clique na guia IPs do seu projeto. Clique no menu Ações do bloco de IP e você poderá ver quais sub-redes e IPs estão atribuídos a quais servidores.
Para uma visão em nível de servidor, navegue até a guia Rede do servidor. Na seção IPs Elásticos, você pode ver os IPs elásticos atribuídos a esse servidor.
Todas as informações de endereço IP do bloco reservado para um projeto estão disponíveis no comando metal ip get.
`metal ip get -p <project-uuid>`
Para verificar as sub-redes e endereços IP disponíveis em um bloco IP reservado específico, use o comando metal ip available. O --reservation-id pode ser obtido a partir do comando metal ip get -p <project-uuid>.
metal ip available --reservation-id <reservation_UUID> --cidr <size_of_subnet>
Você pode verificar os endereços IP atribuídos a um servidor no objeto "ip_addresses" da resposta do comando metal device get, usando a flag --output json para obter a resposta completa.
device get -i <device-id> --output json
Exemplo de resposta (truncada):
{
"id": "d97f0c03-10d2-4667-9465-7f7a27a4f7a7",
....
"ip_addresses": [
{
"id": "4cc7f67b-522e-4b6c-82a5-3b2505be326a",
"address": "198.51.100.3",
"gateway": "198.51.100.2",
"network": "198.51.100.1",
"address_family": 4,
"netmask": "255.255.255.252",
"public": true,
....
"metro": {
"id": "2991b022-b8c4-497e-8db7-5a407c3a209b",
"name": "Silicon Valley",
"code": "sv",
"country": "US"
},
}
]
....
}
Você pode verificar o status das sub-redes e dos endereços IP nos blocos de sub-redes e IPs do seu projeto enviando uma solicitar GET para o endpoint /ips/{id}. O UUID do endereço IP, seja ele um IP reservado ou um bloco de IPs de gerenciamento, é incluído no caminho.
curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"
A resposta incluirá quais IPs e sub-redes estão sendo usados fora do bloco de endereços IP especificado.
Para uma visão em nível de servidor, envie uma solicitar GET para o endpoint /devices/{id}/ips.
curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/ips"
Desatribuição de um endereço IP elástico
- Console
- CLI
- API
Para desatribuir uma sub-rede ou um endereço IP de um servidor, acesse a guia Rede do servidor. Na seção IPs Elásticos, selecione os IPs elásticos e clique em Desanexar para removê-los do servidor.
Remova a atribuição de um endereço IP elástico usando o comando metal ip unssign. Você pode obter o assignment-id da resposta do comando de atribuição original ou do campo "id" no objeto "ip_addresses" da resposta do comando device get -i <device-id> -o json.
ip unassign --id <assignment-id>
Envie uma solicitar DELETE para o endpoint /ips/{id}. O id é o UUID da atribuição, que você pode obter da resposta da solicitar de atribuição original ou do campo "assignment" da resposta do endpoint /ips/{id}.
curl -X DELETE \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"
Outras opções de sub-redes e endereços IP
Atribuir um IP ou sub-rede estaticamente não é a única maneira de usar os endereços IP em suas sub-redes reservadas e blocos de gerenciamento.
- Se você reservou endereços IPv4 públicos, você atribuir esses endereços e sub-redes aos servidores no momento do provisionamento.
- Você pode anunciar endereços IP usando BGP.
Além disso, o Equinix Metal oferece Metal Gateways, que fornece um endereço IPv4 público ou privado como gateway para uma sub-rede.