Procédure Pour: administrateurs

Pools d'adresses IP

Créer, modifier et supprimer des pools d'adresses IP publiques dans la console et voir adresses libres, attributions, quarantaine et DNS inverse.

Un pool d'adresses IP contient des adresses publiques sur un réseau sur pont d'hôte, un pont Open vSwitch avec sécurité des ports. Créez d'abord le réseau, comme décrit dans Réseaux sur pont d'hôte ; sa propre plage DHCP reste réservée aux adresses internes et ne doit pas chevaucher le pool. Vous créez, modifiez, supprimez et surveillez les pools dans la console. Concepts du réseau explique comment une adresse atteint une machine virtuelle.

Dans la console

  1. Ouvrez la page d'accueil et sélectionnez Pools d’adresses IP.

    Pools d'adresses IP avec les plages, les adresses libres et les adresses attribuées (Agrandir)
  2. Lisez le tableau des pools. Pour chaque pool, il affiche le Nom, le Réseau, les Plages IPv4, le Préfixe IPv6, l'Utilisation (adresses attribuées et en quarantaine) et les Libres (adresses IPv4 libres et blocs IPv6 libres).
  3. Sélectionnez le nom d'un pool pour voir ses réglages : passerelle, adresses individuelles, serveurs DNS, adresses réservées, passerelle IPv6 et taille du bloc IPv6 par serveur, le réglage Courrier sortant (port 25), le mode DNS inverse, la Liaison montante et la période de Quarantaine des adresses libérées.
  4. Lisez le tableau Attributions sous les réglages. Chaque ligne est une adresse avec son État (Attribuée ou Quarantaine), son Rôle, la Machine virtuelle, le Locataire, le DNS inverse et la date d'attribution ou la date de fin de quarantaine.
  5. Pour reprendre une adresse, sélectionnez Libérer sur sa ligne. L'adresse passe en quarantaine et l'invité la perd ; la ligne n'a pas d'étape de confirmation, vérifiez donc l'adresse d'abord.
  6. Pour un nom DNS inverse qui attend le fournisseur, sélectionnez Marquer appliqué quand le nom est en place, ou Refuser et saisissez un motif. Voir DNS inverse.

Créer ou modifier un pool

  1. Sur la page Pools d’adresses IP, sélectionnez Nouveau pool. Pour modifier un pool, sélectionnez-le puis Modifier.

    Boîte de dialogue Nouveau pool d'adresses IP avec le réseau, les plages IPv4, le préfixe IPv6, le courrier et le DNS inverse (Agrandir)
  2. Saisissez le Nom du pool et choisissez le Réseau. Le réseau d'un pool ne peut plus changer ensuite.
  3. Sous IPv4, saisissez la Longueur du préfixe, la Passerelle et les Plages IPv4, une plage par ligne, avec la première et la dernière adresse séparées par un trait d'union. Ajoutez les adresses individuelles du fournisseur sous Adresses individuelles, les adresses jamais attribuées sous Réservées, et les Serveurs DNS que reçoivent les invités. Sans serveurs DNS, le pool distribue ceux du réseau.
  4. Pour attribuer des blocs IPv6, activez Attribuer des blocs IPv6 et saisissez le Préfixe, sa Longueur du préfixe, le Bloc IPv6 par serveur et la Passerelle IPv6. Utilisez la longueur de bloc 112 quand le fournisseur donne à l'hôte un seul /64. Tant que des blocs sont attribués ou en quarantaine, le préfixe et la longueur de bloc sont verrouillés, et la boîte de dialogue le dit.
  5. Sous Courrier, DNS inverse et quarantaine, choisissez pour chaque famille si les serveurs peuvent envoyer du courrier sur le port 25 (Courrier sortant (port 25) en IPv4 et Courrier sortant (port 25) en IPv6), le mode DNS inverse et la Quarantaine des adresses libérées en jours.
  6. Sélectionnez Créer le pool, ou Enregistrer le pool pour une modification. Une modification conserve les attributions : une adresse attribuée reste à son serveur, même si vous la retirez des plages. Une plage qui chevauche un autre pool du même réseau est refusée avec error.ip_pool.overlap.
  7. Pour supprimer un pool, sélectionnez Supprimer, saisissez le nom du pool et confirmez. Un pool dont des adresses sont encore attribuées ne peut pas être supprimé ; libérez-les d'abord.

Vous avez besoin du privilège Network.Config sur le réseau du pool ; sans lui, les boutons sont désactivés et le disent.

L'attribution d'adresses à un serveur se fait sur le serveur, comme décrit dans Adresses publiques.

Attribution des adresses

  • Adresses libres. Le nombre d'adresses libres d'un pool est ce que l'allocateur peut attribuer maintenant. Les adresses de passerelle, réservées, de réseau et de diffusion, les adresses attribuées et les adresses en quarantaine ne sont jamais comptées, et une allocation sans adresse prend la plus basse adresse libre. Lister les adresses libres ne réserve rien : quand quelqu'un d'autre prend l'adresse en premier, la boîte de dialogue d'attribution le dit et liste de nouveau les adresses libres.
  • Quarantaine. Une adresse libérée n'est pas attribuée de nouveau pendant 14 jours par défaut. Le réglage de pool Quarantaine des adresses libérées affiche la période.
  • IPv6. Chaque serveur reçoit un bloc du préfixe du pool, un /64 par défaut. Son adresse est <block>::1, configurée avec le préfixe sur le lien (au moins /64) et la passerelle IPv6 du pool. Les annonces de routeur viennent du routeur côté hôte ; un invité qui en envoie une est ignoré. Quand le fournisseur donne à l'hôte un seul /64 sur le lien, le pool attribue des blocs /112 à la place : le bloc 0, le bloc de la passerelle et les blocs qui contiennent une adresse réservée ne sont jamais attribués, l'invité configure <block>::1/64 avec la passerelle, et le commutateur ne le laisse émettre que depuis son /112. Le préfixe et la longueur de bloc ne peuvent pas changer tant que des blocs sont alloués ou en quarantaine.
  • Adresses individuelles. Un fournisseur qui ne route aucun bloc mais donne des adresses individuelles sur le lien reçoit un pool par sous-réseau, avec des adresses individuelles à la place d'une plage ou en plus.
  • Courrier sortant (port 25). Le pool définit si les serveurs IPv4 et IPv6 peuvent envoyer du courrier sur le port 25 (IPv4 autorisé et IPv6 bloqué par défaut) ; modifiez-le dans la boîte de dialogue du pool. Un opérateur peut débloquer un serveur dont le courrier est légitime dans l'onglet Réseaux du serveur, comme décrit dans Adresses publiques. Chaque changement figure dans les événements.
  • Liaison montante. Le réseau du pool a sa liaison montante dans le pont (mode pont, par défaut : le fournisseur doit accepter les adresses MAC des invités) ou non (mode proxy : l'hôte route chaque adresse publique vers le pont et répond au routeur du fournisseur). En mode proxy, l'opérateur active une fois le routage et l'ARP et le NDP proxy sur la liaison montante et charge les règles de pare-feu ; l'agent tient à jour les routes, les entrées proxy et les ensembles de pare-feu par adresse.

Automatisation

Avec la CLI

Créez un pool, puis listez les pools, les attributions et les adresses libres :

Shell
kyvernon ip-pools create --name public-1 --network network-7 --prefix-len 24 \
  --range 198.51.100.10-198.51.100.200 --gateway 198.51.100.1 --dns 198.51.100.2 \
  --reserved 198.51.100.53 --ipv6-prefix 2001:db8:7700::/48 --ipv6-gateway fe80::1
kyvernon ip-pools list
kyvernon ip-pools allocations ippool-1
kyvernon ip-pools available ippool-1 --limit 20

Autres options de create :

OptionSignification
--address <ip>Une adresse individuelle sur le lien, répétée par adresse, à la place de --range ou en plus.
--quarantine-s <seconds>Période de quarantaine des adresses libérées (14 jours par défaut).
--ipv6-block-len 112Longueur de bloc par serveur, avec --ipv6-reserved pour l'adresse propre de l'hôte.
--smtp-ipv4 allowed|blocked, --smtp-ipv6 blocked|allowedCourrier sortant sur le port 25.
--rdns manualLes noms DNS inverses sont des demandes qu'un opérateur applique.

kyvernon ip-pools available liste les adresses IPv4 libres, de la plus basse à la plus haute, avec le nombre d'adresses IPv4 et de blocs IPv6 libres (limit vaut 256 par défaut, 4096 au plus). Quand un autre appelant prend en premier une adresse listée, l'allocation de cette adresse échoue avec error.ip_pool.address_in_use, ou avec error.ip_pool.address_quarantined pour une adresse en quarantaine ; listez de nouveau ou omettez l'adresse. Le mode de liaison montante se définit sur le réseau, comme décrit dans Réseaux sur pont d'hôte.

Avec l'API

TâcheRequêtePrivilège
Créer, modifier, supprimer un poolPOST /v1/ip-pools, PUT et DELETE /v1/ip-pools/{id}Network.Config sur le réseau
Lister, lireGET /v1/ip-pools, GET /v1/ip-pools/{id}Network.Config sur le réseau
Adresses libresGET /v1/ip-pools/{id}/available?limit=NNetwork.Config ou Network.Assign
AttributionsGET /v1/ip-pools/{id}/allocationsNetwork.Config sur le réseau
Allouer une adressePOST /v1/ip-pools/{id}/allocationsNetwork.Assign, et VirtualMachine.Config.Settings sur le serveur
Libérer une adresseDELETE /v1/ip-pools/{id}/allocations/{address}Network.Assign sur le réseau
Courrier sortant d'un serveurGET et PUT /v1/vms/{id}/smtpSystem.View pour lire, Network.Config pour modifier

Une modification de pool porte expectedVersion, et les attributions sont conservées. Un pool qui a encore des attributions ne peut pas être supprimé. Le service gRPC IpPoolService offre les mêmes opérations.

Version 0.1. Dernière modification : 2026-11-14