Configuration des adresses IP élastiques

Equinix Metal vous offre la possibilité d'attribuer des adresses IP élastiques de manière statique à vos serveurs via la console et l'API.

Adresses IP pouvant être utilisées comme IP élastiques:

• Addresses in Reserved Public IPv4 subnets
• Global Anycast IP Addresses
• Private IPv4 Addresses
• Public IPv6 Addresses

Toutes les adresses IP doivent être dans le même métro et le même projet que les serveurs auxquels vous les attribuez, à l'exception des adresses IP Global Anycast (qui peuvent être utilisées globalement).

Ajout d'adresses IP élastiques à un serveur existant

Console

Dans l'onglet Réseau du serveur, dans la section Adresses IP élastiques, cliquez sur + Attribuer une nouvelle adresse IP élastique. Un menu latéral s'affiche, vous permettant de sélectionner le sous-réseau et les adresses IP à attribuer.

CLI

Vous pouvez assigner une adresse IP élastique à un serveur avec la commande metal ip assign. Indiquez l'adresse IP et le CIDR que vous souhaitez attribuer au serveur à l'aide de l'option --address.

metal ip assign --device-id <UUID> --address 198.51.100.3/31

La réponse à la commande d'affectation contient un UUID dans la colonne ID. Si vous souhaitez ultérieurement annuler l'affectation de l'adresse IP Elastic, vous aurez besoin de cet UUID.

+--------------------------------------+----------------+--------+----------------------+
|                  ID                  |    ADDRESS     | PUBLIC |       CREATED        |
+--------------------------------------+----------------+--------+----------------------+
| c6377504-b6cd-4bf9-aaea-ebba769e0b7e | 198.51.100.3   | true   | 2022-12-21T16:28:58Z |
+--------------------------------------+----------------+--------+----------------------+

API

Pour attribuer une adresse IP élastique à un serveur via l'API, envoyez une requête POST au point de terminaison /devices/{id}/ips. L'UUID du serveur est spécifié dans le chemin, et l'adresse IP ainsi que le CIDR sont transmis dans le corps de la requête.

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

Vous pouvez attribuer une seule adresse IP d'un sous-réseau en fournissant uniquement cette adresse. Vous pouvez également attribuer l'intégralité du sous-réseau en fournissant sa taille totale, ou spécifier un sous-réseau plus petit. L'ensemble des options de paramétrage est disponible dans la Référence de l'API.

Remarque: la réponse à la demande d’attribution contiendra un UUID dans le champ "id". Si vous souhaitez par la suite annuler l’attribution de l’adresse IP élastique, vous aurez besoin de cet UUID.

Configuration IP de l'hôte

Contrairement aux adresses IP de gestion, les adresses IP élastiques ne sont pas configurées automatiquement sur vos serveurs. Par mesure de sécurité, nous ne conservons pas l'accès aux serveurs pour mettre à jour leurs fichiers de configuration réseau une fois le système d'exploitation installé. Vous devez ajouter vous-même les nouvelles adresses IP à la configuration réseau du serveur.

En utilisant l'adresse IP 198.51.100.3 comme exemple, les modifications de configuration suivantes rendront cette adresse IP utilisable sur votre serveur:

Ubuntu/Debian

Pour configurer temporairement (ne reviendra pas au redémarrage):

sudo ip addr add 198.51.100.3 dev lo

Pour rendre permanent, ajoutez à /etc/network/interfaces:

auto lo:0
iface lo:0 inet static
    address 198.51.100.3
    netmask 255.255.255.255

netplan

Pour configurer temporairement (ne reviendra pas au redémarrage):

sudo ip addr add 198.51.100.3 dev lo

Pour rendre permanent, ajoutez à /etc/netplan/00-elastic.yaml:

network:
    version: 2
    renderer: networkd
    ethernets:
    lo:
        addresses:
        - 127.0.0.1/8
        - 198.51.100.3/32

alors soit sudo netplan try soit sudo netplan apply

Suivi des adresses IP élastiques

Console

Pour voir l'état des sous-réseaux et des adresses IP dans la console, cliquez sur l'onglet IP de votre projet. Cliquez ensuite sur le menu Actions du bloc IP pour visualiser les sous-réseaux et les adresses IP attribués à chaque serveur.

Pour une vue au niveau du serveur, accédez à l'onglet Réseau du serveur. Dans la section Adresses IP élastiques, vous pouvez voir les adresses IP élastiques attribuées à ce serveur.

CLI

Toutes les informations relatives aux adresses IP de blocs réservés pour un projet sont disponibles à partir de la commande metal ip get.

`metal ip get -p <project-uuid>`

Pour vérifier la disponibilité des sous-réseaux et des adresses IP dans un bloc d'adresses IP réservé, utilisez la commande metal ip available. L'adresse --reservation-id peut être obtenue à partir de la commande metal ip get -p <project-uuid>.

metal ip available --reservation-id <reservation_UUID> --cidr <size_of_subnet>

Vous pouvez vérifier les adresses IP attribuées à un serveur dans l'objet "ip_addresses" de la réponse de la commande metal device get, en utilisant l'indicateur --output json pour obtenir la réponse complète.

device get -i <device-id> --output json

Exemple de réponse (tronquée):

{
"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"
    },
    }
]
....
}

API

Vous pouvez vérifier l'état des sous-réseaux et des adresses IP de votre projet en envoyant une requête GET au point de terminaison /ips/{id}. L'UUID de l'adresse IP, qu'il s'agisse d'une adresse IP réservée ou d'un bloc d'adresses IP de gestion, doit être inclus dans le chemin.

curl -X GET \ 
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"

La réponse inclura les adresses IP et les sous-réseaux utilisés dans le bloc d'adresses IP spécifié.

Pour une vue au niveau du serveur, envoyez une requête GET au point de terminaison /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"

Annulation de l'attribution d'une adresse IP élastique

Console

Pour dissocier un sous-réseau ou une adresse IP d'un serveur, allez à l'onglet Réseau du serveur. Dans la section Adresses IP élastiques, sélectionnez les adresses IP élastiques, puis cliquez sur Détacher pour les dissocier du serveur.

CLI

Supprimez l'attribution d'une adresse IP élastique à l'aide de la commande metal ip unssign. Vous pouvez obtenir assignment-id à partir de la réponse à la commande d'attribution initiale ou à partir du champ "id" de l'objet "ip_addresses" de la réponse à la commande device get -i <device-id> -o json.

ip unassign --id <assignment-id>

API

Envoyer une requête DELETE au point de terminaison /ips/{id}. id correspond à l'UUID de l'affectation, que vous pouvez obtenir à partir de la réponse à la requête d'affectation initiale ou du champ « assignment » de la réponse du point de terminaison /ips/{id}.

curl -X DELETE \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"

Autres sous-réseaux et options d'adresse IP

L’attribution statique d’une adresse IP ou d’un sous-réseau n’est pas la seule façon d’utiliser les adresses IP dans vos sous-réseaux réservés et vos blocs de gestion.

• Si vous avez réservé des adresses IPv4 publiques, vous pouvez attribuer ces adresses et sous-réseaux aux serveurs au moment de la mise en service.
• Vous pouvez annoncer des adresses IP en utilisant BGP.

De plus, Equinix Metal offre Metal Gateways, qui fournit une adresse IPv4 publique ou privée comme passerelle pour un sous-réseau.