Créer un VPC et y relier deux VM
Ce guide crée un VPC avec un sous-réseau depuis la console Hikube, y relie deux VM et vérifie qu'elles communiquent par leurs adresses privées.
Prérequis
- Un compte Hikube et un projet (voir Démarrage rapide Hikube).
- Deux VM Linux dans ce projet, dont au moins une accessible en SSH (voir Créer votre première VM). Vous pouvez aussi les créer pendant ce guide.
- Pour l'onglet API : une clé d'API
admindu projet et les variablesHIKUBE_API,HIKUBE_API_KEYetPROJECT_ID(voir Préparer l'environnement) ; les exemples utilisentcurletjq
Étape 1 : Ouvrir l'assistant de création de VPC
- Console
- API
- Dans le menu latéral, ouvrez Infrastructure > Réseau. La page Virtual Private Clouds liste les VPC du projet.
- Cliquez sur Créer un VPC.
L'assistant Créer un VPC comporte trois étapes : Général, Sous-réseaux et Vérification.
Avec l'API, il n'y a pas d'assistant. Listez les VPC du projet pour vérifier l'accès :
curl -sS "$HIKUBE_API/network/v1alpha1/projects/$PROJECT_ID/vpcs" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
Résultat attendu : un objet JSON {"totalCount": ..., "vpcs": [...]}.
Étape 2 : Configurer et valider
- Console
- API
Général
Saisissez le Nom du VPC, par exemple vpc-demo (3 à 16 caractères : minuscules, chiffres et tirets, commençant par une lettre). Cliquez sur Suivant.
Sous-réseaux
Un sous-réseau est pré-rempli avec la Plage CIDR 172.16.0.0/24.
- Nom : remplacez le nom généré par
app. - Plage CIDR : conservez
172.16.0.0/24. - Optionnel : Ajouter un sous-réseau pour en créer d'autres (par exemple
dben172.16.1.0/24), jusqu'à dix. - Cliquez sur Suivant.
Vérification
Le Résumé de la configuration reprend le Nom du VPC et ses Sous-réseaux. Cliquez sur Créer le VPC.
La console affiche VPC créé et revient à la liste.
Le VPC et ses sous-réseaux se créent en deux requêtes. Créez d'abord le VPC :
curl -sS -X POST "$HIKUBE_API/network/v1alpha1/projects/$PROJECT_ID/vpcs" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "vpcdemo"}'
name : 3 à 16 caractères, en minuscules ; ce nom identifie le VPC dans les chemins de l'API.
Ajoutez ensuite le sous-réseau app :
curl -sS -X POST "$HIKUBE_API/network/v1alpha1/projects/$PROJECT_ID/vpcs/vpcdemo/subnets" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subnetName": "app", "cidr": "172.16.0.0/24"}'
Répétez la requête pour d'autres sous-réseaux, par exemple db en 172.16.1.0/24. Un sous-réseau ne doit chevaucher ni un autre sous-réseau du VPC ni une plage réservée.
Étape 3 : Vérifier l'état
- Console
- API
Dans la liste des VPC, le statut de vpc-demo (colonne État en vue tableau) doit passer de En cours de provisionnement à Prêt.
Ouvrez le menu Actions du VPC et cliquez sur Voir les sous-réseaux : la page Sous-réseaux pour vpc-demo liste app avec son Bloc CIDR 172.16.0.0/24.
Résultat attendu : VPC Prêt, sous-réseau app listé.
curl -sS "$HIKUBE_API/network/v1alpha1/projects/$PROJECT_ID/vpcs/vpcdemo" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '{name, status}'
curl -sS "$HIKUBE_API/network/v1alpha1/projects/$PROJECT_ID/vpcs/vpcdemo/subnets" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
Résultat attendu : status passe de provisioning à ready, et la liste des sous-réseaux contient {"subnetName": "app", "cidr": "172.16.0.0/24"}.
Étape 4 : Relier les VM au sous-réseau
- Console
- API
Pour chacune des deux VM :
- Ouvrez Instances VM, cliquez sur la VM puis sur Modifier.
- Dans Réseau & Sécurité, sous Réseaux VPC (Secondaires), cochez
vpc-demo. - Sous Sous-réseaux, cochez
app. - Cliquez sur Enregistrer.
Pour une nouvelle VM, faites la même sélection à l'étape Réseau de l'assistant Créer une Instance.
Sur la page de détail de chaque VM, section Réseau et Sécurité :
- Réseaux VPC affiche
vpc-demoetapp (172.16.0.0/24); - la zone Interne affiche, à côté de l'IP mgmt, une adresse dans
172.16.0.0/24. Notez celle de la seconde VM.
Une VM se relie à un sous-réseau en modifiant la VM (PATCH /instance/v1alpha1/projects/{projectId}/instances/{name}). C'est une mise à jour partielle : un corps qui ne contient que network.vpcs garde le type d'instance, les disques, l'adresse publique et le pare-feu. Pour chacune des deux VM :
VM=vm1 # nom de la VM
curl -sS -X PATCH "$HIKUBE_API/instance/v1alpha1/projects/$PROJECT_ID/instances/$VM" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"network": {"vpcs": [{"name": "vpcdemo", "subnets": ["app"]}]}}'
La liste vpcs remplace les connexions VPC actuelles de la VM, et [] les retire toutes ; chaque connexion doit nommer au moins un sous-réseau. Pour une nouvelle VM, placez le même bloc network.vpcs dans le corps de création.
Relevez ensuite l'adresse privée de chaque VM :
curl -sS "$HIKUBE_API/instance/v1alpha1/projects/$PROJECT_ID/instances/$VM" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '{vpcs: .network.vpcs, ips: .network.ips}'
network.ips contient une adresse dans 172.16.0.0/24. Notez celle de la seconde VM.
Étape 5 : Connexion et tests
Connectez-vous à la première VM en SSH (commande du bloc Connexion SSH), puis listez ses interfaces :
ip -br addr
Résultat attendu : une interface supplémentaire apparaît (par exemple enp2s0), sans adresse sur Debian et Ubuntu, dont l'OS ne la configure pas automatiquement.
L'adresse VPC est distribuée par DHCP. Les distributions à NetworkManager (AlmaLinux, Rocky…) la prennent automatiquement ; sur Debian et Ubuntu, activez DHCP sur l'interface secondaire. Le bail ne fournit pas de passerelle : la route par défaut reste sur l'interface principale.
Exemple avec netplan (Debian, Ubuntu) :
network:
version: 2
ethernets:
enp2s0:
dhcp4: true
dhcp4-overrides:
use-routes: false
sudo chmod 600 /etc/netplan/60-vpc.yaml
sudo netplan apply
ip -br addr show enp2s0
Résultat attendu : enp2s0 est UP avec une adresse en 172.16.0.x/24, celle affichée dans la zone Interne de la console, à côté de l'IP mgmt. Faites de même sur la seconde VM.
Testez la communication avec la seconde VM sur son adresse privée :
ping -c 3 172.16.0.11
Remplacez 172.16.0.11 par l'adresse du sous-réseau relevée à l'étape 4. Le ping doit répondre ; ce trafic ne passe ni par Internet ni par le pare-feu de l'IP publique.
Étape 6 : Dépannage rapide
| Symptôme | Action |
|---|---|
| Bloc CIDR invalide à la création | Saisissez une plage IPv4 au format a.b.c.d/n, par exemple 172.16.2.0/24. |
| Message d'erreur mentionnant un chevauchement (overlaps) | La plage chevauche un autre sous-réseau du VPC ou une plage réservée (10.244.0.0/16, 10.96.0.0/12) : choisissez une autre plage. |
| L'interface secondaire n'a pas d'adresse dans la VM | Voir Dépannage. |
| Le ping ne répond pas | Vérifiez que les deux VM sont sur le même sous-réseau et que le pare-feu de l'OS (ufw, firewalld) autorise ICMP. |
Étape 7 : Nettoyage
- Console
- API
- Détachez les VM : Modifier > Réseau & Sécurité, décochez
vpc-demo, puis Enregistrer. - Dans Réseau, ouvrez le menu Actions du VPC et cliquez sur Supprimer.
- Saisissez le nom du VPC pour confirmer, puis cliquez sur Supprimer définitivement.
La suppression d'un VPC supprime aussi ses sous-réseaux. Elle est refusée tant qu'une VM y est reliée : la console affiche Suppression impossible avec la liste des VM concernées.
- Détachez les VM du VPC. Une liste
network.vpcsvide est ignorée par l'API : à ce jour, retirer le dernier VPC d'une VM se fait depuis la console (onglet Console, étape 1). Si la VM n'est plus utile, vous pouvez aussi la supprimer. - Supprimez le VPC :
curl -sS -X DELETE "$HIKUBE_API/network/v1alpha1/projects/$PROJECT_ID/vpcs/vpcdemo" \-H "X-Hikube-Api-Key: $HIKUBE_API_KEY"
La suppression d'un VPC supprime aussi ses sous-réseaux. Elle est refusée tant qu'une VM y est reliée.