Lab 05 : Peering entre un cluster OKS et un Net
Objectifs
Section intitulée « Objectifs »À l’issue de ce lab, vous serez capable de :
- créer un Net (réseau virtuel) et un Subnet (sous-réseau) avec octl ;
- demander un Net peering depuis un cluster OKS avec la ressource Kubernetes
NetPeeringRequest; - accepter ce Net peering avec octl, côté Net de votre compte ;
- ajouter une route vers le Net du projet OKS dans une route table ;
- autoriser le trafic du projet OKS dans un Security Group ;
- tester la connectivité privée entre un Pod du cluster et une VM.
Architecture du lab
Section intitulée « Architecture du lab »Dans ce lab, vous reliez deux Nets de la Région eu-west-2 :
- le Net du projet OKS
oks-lab01-project, créé au Lab 01, dans lequel s’exécutent les nœuds du clusteroks-lab01-cluster(par exemple10.50.0.0/16) ; - le Net
oks-lab05-net(10.1.0.0/16), que vous créez dans votre compte au début du lab.
Un Net peering est une connexion privée entre deux Nets : les VMs de chaque Net communiquent avec leurs IPs privées, sans passer par Internet. Les plages CIDR des deux Nets ne doivent pas se chevaucher.
Dans le Net oks-lab05-net, vous créez le Subnet oks-lab05-subnet (10.1.3.0/24), puis la VM de test oks-lab05-vm, sans IP publique, protégée par le Security Group oks-lab05-sg. Le cluster OKS demande le Net peering, vous l’acceptez, puis vous ajoutez dans la route table du Net une route vers le Net du projet OKS. Un Pod du cluster peut alors joindre la VM sur son IP privée.
Prérequis
Section intitulée « Prérequis »Avant de commencer, vous devez disposer :
- du cluster
oks-lab01-clusterà l’étatready, avec ses NodePools, créé dans le Lab 01 ; - du fichier
oks-lab01-kubeconfig.yamlrécupéré dans le Lab 01 ; - de kubectl et octl installés et configurés (Lab 01), avec un profil octl sur le même compte que le cluster ;
- d’un quota suffisant pour créer un Net et une VM dans votre compte ;
- de connaissances sur les Nets, Subnets et route tables, idéalement acquises aux Labs 02 et 03 du parcours Architecte.
Le lab utilise la région eu-west-2.
Remarque : les variables du shell (
NET_ID,RT_ID, etc.) sont perdues si vous fermez votre terminal. Dans ce cas, définissez-les de nouveau avec les commandes des étapes précédentes.
1. Préparer l’environnement
Section intitulée « 1. Préparer l’environnement »1.1 Accéder au cluster
Section intitulée « 1.1 Accéder au cluster »-
Placez-vous dans le répertoire qui contient le fichier
oks-lab01-kubeconfig.yaml, puis indiquez à kubectl de l’utiliser :Terminal window export KUBECONFIG=$PWD/oks-lab01-kubeconfig.yamlRemarque : si vous avez supprimé ce fichier, récupérez-le de nouveau :
Terminal window (umask 077; octl kube cluster kubeconfig oks-lab01-cluster --project oks-lab01-project > oks-lab01-kubeconfig.yaml) -
Vérifiez l’accès au cluster :
Terminal window kubectl get nodes
1.2 Relever les informations du projet OKS et du compte
Section intitulée « 1.2 Relever les informations du projet OKS et du compte »-
Enregistrez la plage CIDR du Net du projet OKS dans la variable
OKS_CIDR:Terminal window OKS_CIDR=$(octl kube project describe oks-lab01-project -o text --jq '.cidr')echo $OKS_CIDRLa plage du projet OKS s’affiche, par exemple
10.50.0.0/16. Le Net du projet OKS est géré par OKS : il n’apparaît pas dansoctl iaas net list. -
Enregistrez l’identifiant de votre compte OUTSCALE dans la variable
ACCOUNT_ID:Terminal window ACCOUNT_ID=$(octl iaas account list -o text --jq '.AccountId')echo $ACCOUNT_ID
2. Créer le Net et la VM de test
Section intitulée « 2. Créer le Net et la VM de test »2.1 Créer le Net et le Subnet
Section intitulée « 2.1 Créer le Net et le Subnet »-
Créez le Net
oks-lab05-netavec la plage10.1.0.0/16, qui ne chevauche pas celle du projet OKS :Terminal window NET_ID=$(octl iaas net create --ip-range 10.1.0.0/16 -o text --jq '.NetId')octl iaas tag create --resource-id $NET_ID --key Name --value oks-lab05-netecho $NET_IDL’identifiant du Net s’affiche (il commence par
vpc-). -
Créez le Subnet
oks-lab05-subnetdans la Sous-régioneu-west-2a:Terminal window SUBNET_ID=$(octl iaas subnet create --net-id $NET_ID --ip-range 10.1.3.0/24 \--subregion eu-west-2a -o text --jq '.SubnetId')octl iaas tag create --resource-id $SUBNET_ID --key Name --value oks-lab05-subnetecho $SUBNET_ID -
Enregistrez l’identifiant de la route table principale du Net. OUTSCALE la crée automatiquement avec le Net, et elle s’applique à tout Subnet qui n’est pas associé à une autre route table :
Terminal window RT_ID=$(octl iaas routetable list -o text --jq "select(.NetId==\"$NET_ID\") | .RouteTableId")echo $RT_IDL’identifiant de la route table s’affiche (il commence par
rtb-). octl applique le filtre--jqà chaque route table de la liste :select(...)ne garde que celle du Netoks-lab05-net.
2.2 Créer le Security Group
Section intitulée « 2.2 Créer le Security Group »-
Créez le Security Group
oks-lab05-sgdans le Netoks-lab05-net:Terminal window SG_ID=$(octl iaas securitygroup create \--name oks-lab05-sg \--description "Lab OKS 05 - trafic depuis le projet OKS" \--net-id $NET_ID \-o text --jq '.SecurityGroupId')echo $SG_ID -
Autorisez les requêtes ICMP (ping) en provenance du Net du projet OKS :
Terminal window octl iaas securitygrouprule create \--group-id $SG_ID \--flow Inbound \--ports icmp \--remote-ranges $OKS_CIDRSeul le Net du projet OKS est autorisé, et uniquement pour le protocole ICMP.
2.3 Créer la VM
Section intitulée « 2.3 Créer la VM »-
Recherchez l’OMI Ubuntu 22.04 la plus récente publiée par OUTSCALE, puis enregistrez son identifiant (il commence par
ami-) :Terminal window octl iaas image list --account-alias Outscale --name 'Ubuntu-22.04-*'IMAGE_ID=<ID_OMI> -
Créez la VM dans le Subnet
oks-lab05-subnet:Terminal window VM_ID=$(octl iaas vm create \--image-id $IMAGE_ID \--type tinav5.c1r1p2 \--subnet-id $SUBNET_ID \--security-group-id $SG_ID \-o text --jq '.VmId')octl iaas tag create --resource-id $VM_ID --key Name --value oks-lab05-vmLa VM n’a ni IP publique ni paire de clés : elle ne sert qu’à répondre aux requêtes ICMP.
-
Attendez que la VM soit à l’état
running, puis enregistrez son IP privée :Terminal window octl iaas vm describe $VM_ID --waitfor '.State=="running"'VM_PRIVATE_IP=$(octl iaas vm describe $VM_ID -o text --jq '.PrivateIp')echo $VM_PRIVATE_IPL’IP privée de la VM s’affiche, dans la plage du Subnet (par exemple
10.1.3.25).
3. Créer le Net peering
Section intitulée « 3. Créer le Net peering »3.1 Demander le Net peering depuis le cluster OKS
Section intitulée « 3.1 Demander le Net peering depuis le cluster OKS »Le Net du projet OKS est géré par OKS : vous ne pouvez pas y créer de Net peering directement. Vous le demandez au cluster avec la ressource Kubernetes NetPeeringRequest.
-
Créez le fichier
oks-lab05-peering-request.yamlà partir des variablesNET_IDetACCOUNT_ID, puis affichez-le :Terminal window cat > oks-lab05-peering-request.yaml <<EOFapiVersion: oks.dev/v1betakind: NetPeeringRequestmetadata:name: oks-lab05-peering-requestspec:accepterNetId: $NET_IDaccepterOwnerId: "$ACCOUNT_ID"EOFcat oks-lab05-peering-request.yamlVérifiez que le fichier contient bien l’identifiant du Net (
vpc-...) et celui de votre compte, et non des valeurs vides.accepterNetId: identifiant du Net qui doit accepter le Net peering.accepterOwnerId: identifiant du compte OUTSCALE propriétaire de ce Net. Il est écrit entre guillemets, car c’est une chaîne de caractères composée de chiffres.
-
Appliquez le manifeste :
Terminal window kubectl apply -f oks-lab05-peering-request.yaml -
Suivez l’état de la demande. Les colonnes restent vides quelques secondes, le temps qu’OKS crée le Net peering. Appuyez sur Ctrl+C quand un identifiant
pcx-...apparaît :Terminal window kubectl get netpeeringrequests -wExemple de sortie :
NAME SOURCE NET ID ACCEPTER NET ID NET PEERING ID STATE NAME STATE MESSAGE EXPIRATION DATEoks-lab05-peering-request vpc-137c2c75 vpc-a2c47218 pcx-35782956 pending-acceptance Pending acceptance by 415179769579Le Net peering est créé, à l’état
pending-acceptance: il attend l’acceptation du propriétaire du Netoks-lab05-net, c’est-à-dire vous. -
Enregistrez l’identifiant du Net peering dans la variable
PCX_ID, en remplaçant<ID_NET_PEERING>par la valeur de la colonneNET PEERING ID(elle commence parpcx-) :Terminal window PCX_ID=<ID_NET_PEERING>
3.2 Accepter le Net peering
Section intitulée « 3.2 Accepter le Net peering »-
Acceptez le Net peering avec octl :
Terminal window octl iaas netpeering accept $PCX_IDRemarque : si le Net appartient à un autre compte OUTSCALE, l’acceptation se fait avec un profil octl de ce compte : ajoutez l’option
--profile <NOM_DU_PROFIL>. Vous pouvez aussi accepter le Net peering dans Cockpit. -
Attendez que le Net peering soit actif côté OUTSCALE :
Terminal window octl iaas netpeering describe $PCX_ID --waitfor '.State.Name=="active"' -
Attendez qu’OKS prenne en compte l’acceptation. Une fois le Net peering accepté, OKS remplace la ressource
NetPeeringRequestpar une ressourceNetPeering, puis configure la route de son côté. Relancez la commande suivante jusqu’à voir le Net peering à l’étatactive(une à deux minutes) :Terminal window kubectl get netpeeringsExemple de sortie :
NAME SOURCE NET ID ACCEPTER NET ID NET PEERING ID STATE NAME STATE MESSAGE EXPIRATION DATEpcx-35782956 vpc-137c2c75 vpc-a2c47218 pcx-35782956 active Active 2026-11-04T00:16:28.000Zkubectl get netpeeringrequestsaffiche désormaisNo resources found: c’est normal, la demande a été consommée.Remarque : tant que le Net peering n’est pas
activedanskubectl get netpeerings, la route côté OKS n’existe pas encore et le test de l’étape 5 échoue. -
Affichez le détail du Net peering vu par OKS :
Terminal window kubectl get netpeering $PCX_ID -o yamlLa section
statusindique les plages des deux Nets (sourceIpRangepour le projet OKS,accepterIpRangepouroks-lab05-net) et le compte propriétaire de chacun. Le champsourceOwnerIdmontre que le Net du projet OKS appartient à un compte OUTSCALE géré par OKS, différent du vôtre : c’est pourquoi ce Net, comme les nœuds du cluster, n’apparaît pas dansoctl iaas net list.
4. Configurer le routage
Section intitulée « 4. Configurer le routage »4.1 Ajouter la route côté Net de la VM
Section intitulée « 4.1 Ajouter la route côté Net de la VM »Le Net peering est actif, mais aucun paquet ne l’emprunte tant qu’aucune route ne l’indique.
-
Ajoutez dans la route table du Net
oks-lab05-netune route vers le Net du projet OKS, via le Net peering :Terminal window octl iaas route create \--table-id $RT_ID \--destination-ip-range $OKS_CIDR \--net-peering-id $PCX_ID -
Vérifiez la route table :
Terminal window octl iaas routetable describe $RT_IDUne route vers
OKS_CIDR, dont la cible est le Net peeringpcx-..., s’affiche.
4.2 Côté projet OKS
Section intitulée « 4.2 Côté projet OKS »Côté projet OKS, la route vers le Net oks-lab05-net est ajoutée automatiquement par OKS une fois le Net peering actif : vous n’avez aucune action à réaliser.
Remarque : le trafic des Pods sort du cluster avec l’IP privée de leur nœud. C’est pourquoi la route et le Security Group utilisent la plage CIDR du projet OKS, et non celle des Pods.
5. Tester la connectivité
Section intitulée « 5. Tester la connectivité »-
Lancez un Pod temporaire qui envoie quatre requêtes ICMP à l’IP privée de la VM :
Terminal window kubectl run oks-lab05-test --image=busybox:1.36 --restart=Never --rm -it \-- ping -c 4 $VM_PRIVATE_IP--rmsupprime le Pod à la fin de la commande.-itaffiche la sortie de la commande dans votre terminal.
Exemple de sortie :
PING 10.1.3.25 (10.1.3.25): 56 data bytes64 bytes from 10.1.3.25: seq=0 ttl=60 time=1.39 ms64 bytes from 10.1.3.25: seq=1 ttl=60 time=1.29 ms64 bytes from 10.1.3.25: seq=2 ttl=60 time=1.31 ms64 bytes from 10.1.3.25: seq=3 ttl=60 time=1.27 ms--- 10.1.3.25 ping statistics ---4 packets transmitted, 4 packets received, 0% packet losspod "oks-lab05-test" deletedLa VM répond : le trafic passe par le Net peering, avec des IPs privées, sans passer par Internet.
Validation du lab
Section intitulée « Validation du lab »Pour valider votre lab, vérifiez les points suivants :
kubectl get netpeeringsaffiche le Net peering$PCX_IDà l’étatactive.octl iaas netpeering describe $PCX_IDaffiche le Net peering à l’étatactive.octl iaas routetable describe $RT_IDaffiche la route versOKS_CIDRviapcx-....octl iaas securitygroup rules $SG_IDaffiche une seule règle entrante, ICMP, limitée àOKS_CIDR.- Le Pod
oks-lab05-testreçoit les réponses ICMP de la VMoks-lab05-vm.
Challenge
Section intitulée « Challenge »- Supprimez temporairement la route ajoutée à l’étape 4.1, relancez le test de connectivité, puis recréez la route.
- Autorisez le port TCP
22depuis le Net du projet OKS dans le Security Groupoks-lab05-sg, puis vérifiez depuis un Pod que le port répond, avecnc -zv -w 3 $VM_PRIVATE_IP 22.
Question : Pourquoi les plages CIDR des deux Nets ne doivent-elles pas se chevaucher ?
💡 Correction — Suppression de la route
octl iaas api DeleteRoute --RouteTableId $RT_ID --DestinationIpRange $OKS_CIDRkubectl run oks-lab05-test --image=busybox:1.36 --restart=Never --rm -it -- ping -c 4 -W 2 $VM_PRIVATE_IPToutes les requêtes sont perdues : la VM reçoit les requêtes, mais ne sait plus renvoyer ses réponses vers le Net du projet OKS. Le Net peering ne suffit pas, il faut une route dans chaque sens. Recréez la route avec la commande de l’étape 4.1.
💡 Correction — Ouverture du port 22
octl iaas securitygrouprule create --group-id $SG_ID --flow Inbound \ --ports tcp/22 --remote-ranges $OKS_CIDRkubectl run oks-lab05-test --image=busybox:1.36 --restart=Never --rm -it -- nc -zv -w 3 $VM_PRIVATE_IP 22La commande affiche open : le port SSH de la VM est joignable depuis le cluster, via le Net peering.
💡 Correction — Question du challenge
Chaque route table choisit une cible en fonction de l’adresse de destination. Si les deux Nets utilisaient des plages qui se chevauchent, une même adresse privée existerait des deux côtés : il serait impossible de savoir si un paquet doit rester dans le Net local ou emprunter le Net peering. OUTSCALE refuse donc de créer un Net peering entre des Nets dont les plages se chevauchent.
Nettoyage du lab
Section intitulée « Nettoyage du lab »Attention : avant de supprimer une ressource, vérifiez qu’elle n’est pas utilisée par d’autres labs.
Ressources à conserver pour les labs suivants
Section intitulée « Ressources à conserver pour les labs suivants »Si vous prévoyez de continuer avec le Lab 06, ne supprimez pas les ressources du Lab 01 :
- le cluster OKS
oks-lab01-clusteret ses NodePools ; - le fichier kubeconfig
oks-lab01-kubeconfig.yaml.
Ressources à supprimer
Section intitulée « Ressources à supprimer »Supprimez les ressources suivantes, dans cet ordre :
-
Supprimer le Net peering depuis le cluster. OKS supprime aussi le Net peering côté OUTSCALE :
Terminal window kubectl delete netpeering $PCX_IDoctl iaas netpeering listLe Net peering
$PCX_IDs’affiche à l’étatdeleted. -
Supprimer le Net et tout son contenu (VM, Security Group, Subnet, route table) :
Terminal window octl iaas net teardown $NET_ID --teardown-vmsLa commande affiche l’arborescence des ressources du Net, puis les supprime une à une dans le bon ordre, avant de supprimer le Net lui-même. L’option
--teardown-vmsautorise la suppression des VMs du Net.Exemple de sortie :
net/vpc-a2c47218 (oks-lab05-net)├─ subnet/subnet-5cf752bc (oks-lab05-subnet)│ └─ vm/i-c7d108b1 (oks-lab05-vm)│ ├─ security group/sg-37cbce25 (oks-lab05-sg)│ └─ nic/eni-e35b4f8a└─ net peering/pcx-35782956✅ vm/i-c7d108b1 (oks-lab05-vm) was deleted in 168.242691ms.✅ net peering/pcx-35782956 was deleted in 160.184658ms.✅ nic/eni-e35b4f8a was deleted in 20.966639135s.✅ security group/sg-37cbce25 (oks-lab05-sg) was deleted in 164.558824ms.✅ subnet/subnet-5cf752bc (oks-lab05-subnet) was deleted in 617.144649ms.✅ net/vpc-a2c47218 (oks-lab05-net) was deleted in 281.720789ms. -
Vérifiez la suppression du Net :
Terminal window octl iaas net listLe Net
oks-lab05-nets’affiche à l’étatdeleting, puis disparaît de la liste. -
Supprimer le fichier de la demande de Net peering :
Terminal window rm oks-lab05-peering-request.yaml