Aller au contenu

Lab 05 : Peering entre un cluster OKS et un Net

À 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.

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 cluster oks-lab01-cluster (par exemple 10.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.

Avant de commencer, vous devez disposer :

  • du cluster oks-lab01-cluster à l’état ready, avec ses NodePools, créé dans le Lab 01 ;
  • du fichier oks-lab01-kubeconfig.yaml ré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. 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.yaml

    Remarque : 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)
  2. 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 »
  1. 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_CIDR

    La 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 dans octl iaas net list.

  2. 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
  1. Créez le Net oks-lab05-net avec la plage 10.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-net
    echo $NET_ID

    L’identifiant du Net s’affiche (il commence par vpc-).

  2. Créez le Subnet oks-lab05-subnet dans la Sous-région eu-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-subnet
    echo $SUBNET_ID
  3. 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_ID

    L’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 Net oks-lab05-net.

  1. Créez le Security Group oks-lab05-sg dans le Net oks-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
  2. 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_CIDR

    Seul le Net du projet OKS est autorisé, et uniquement pour le protocole ICMP.

  1. 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>
  2. 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-vm

    La VM n’a ni IP publique ni paire de clés : elle ne sert qu’à répondre aux requêtes ICMP.

  3. 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_IP

    L’IP privée de la VM s’affiche, dans la plage du Subnet (par exemple 10.1.3.25).

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.

  1. Créez le fichier oks-lab05-peering-request.yaml à partir des variables NET_ID et ACCOUNT_ID, puis affichez-le :

    Terminal window
    cat > oks-lab05-peering-request.yaml <<EOF
    apiVersion: oks.dev/v1beta
    kind: NetPeeringRequest
    metadata:
    name: oks-lab05-peering-request
    spec:
    accepterNetId: $NET_ID
    accepterOwnerId: "$ACCOUNT_ID"
    EOF
    cat oks-lab05-peering-request.yaml

    Vé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.
  2. Appliquez le manifeste :

    Terminal window
    kubectl apply -f oks-lab05-peering-request.yaml
  3. 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 -w

    Exemple de sortie :

    NAME SOURCE NET ID ACCEPTER NET ID NET PEERING ID STATE NAME STATE MESSAGE EXPIRATION DATE
    oks-lab05-peering-request vpc-137c2c75 vpc-a2c47218 pcx-35782956 pending-acceptance Pending acceptance by 415179769579

    Le Net peering est créé, à l’état pending-acceptance : il attend l’acceptation du propriétaire du Net oks-lab05-net, c’est-à-dire vous.

  4. Enregistrez l’identifiant du Net peering dans la variable PCX_ID, en remplaçant <ID_NET_PEERING> par la valeur de la colonne NET PEERING ID (elle commence par pcx-) :

    Terminal window
    PCX_ID=<ID_NET_PEERING>
  1. Acceptez le Net peering avec octl :

    Terminal window
    octl iaas netpeering accept $PCX_ID

    Remarque : 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.

  2. Attendez que le Net peering soit actif côté OUTSCALE :

    Terminal window
    octl iaas netpeering describe $PCX_ID --waitfor '.State.Name=="active"'
  3. Attendez qu’OKS prenne en compte l’acceptation. Une fois le Net peering accepté, OKS remplace la ressource NetPeeringRequest par une ressource NetPeering, puis configure la route de son côté. Relancez la commande suivante jusqu’à voir le Net peering à l’état active (une à deux minutes) :

    Terminal window
    kubectl get netpeerings

    Exemple de sortie :

    NAME SOURCE NET ID ACCEPTER NET ID NET PEERING ID STATE NAME STATE MESSAGE EXPIRATION DATE
    pcx-35782956 vpc-137c2c75 vpc-a2c47218 pcx-35782956 active Active 2026-11-04T00:16:28.000Z

    kubectl get netpeeringrequests affiche désormais No resources found : c’est normal, la demande a été consommée.

    Remarque : tant que le Net peering n’est pas active dans kubectl get netpeerings, la route côté OKS n’existe pas encore et le test de l’étape 5 échoue.

  4. Affichez le détail du Net peering vu par OKS :

    Terminal window
    kubectl get netpeering $PCX_ID -o yaml

    La section status indique les plages des deux Nets (sourceIpRange pour le projet OKS, accepterIpRange pour oks-lab05-net) et le compte propriétaire de chacun. Le champ sourceOwnerId montre 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 dans octl iaas net list.

Le Net peering est actif, mais aucun paquet ne l’emprunte tant qu’aucune route ne l’indique.

  1. Ajoutez dans la route table du Net oks-lab05-net une 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
  2. Vérifiez la route table :

    Terminal window
    octl iaas routetable describe $RT_ID

    Une route vers OKS_CIDR, dont la cible est le Net peering pcx-..., s’affiche.

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.

  1. 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
    • --rm supprime le Pod à la fin de la commande.
    • -it affiche la sortie de la commande dans votre terminal.

    Exemple de sortie :

    PING 10.1.3.25 (10.1.3.25): 56 data bytes
    64 bytes from 10.1.3.25: seq=0 ttl=60 time=1.39 ms
    64 bytes from 10.1.3.25: seq=1 ttl=60 time=1.29 ms
    64 bytes from 10.1.3.25: seq=2 ttl=60 time=1.31 ms
    64 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 loss
    pod "oks-lab05-test" deleted

    La VM répond : le trafic passe par le Net peering, avec des IPs privées, sans passer par Internet.

Pour valider votre lab, vérifiez les points suivants :

  • kubectl get netpeerings affiche le Net peering $PCX_ID à l’état active.
  • octl iaas netpeering describe $PCX_ID affiche le Net peering à l’état active.
  • octl iaas routetable describe $RT_ID affiche la route vers OKS_CIDR via pcx-....
  • octl iaas securitygroup rules $SG_ID affiche une seule règle entrante, ICMP, limitée à OKS_CIDR.
  • Le Pod oks-lab05-test reçoit les réponses ICMP de la VM oks-lab05-vm.
  1. Supprimez temporairement la route ajoutée à l’étape 4.1, relancez le test de connectivité, puis recréez la route.
  2. Autorisez le port TCP 22 depuis le Net du projet OKS dans le Security Group oks-lab05-sg, puis vérifiez depuis un Pod que le port répond, avec nc -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
Terminal window
octl iaas api DeleteRoute --RouteTableId $RT_ID --DestinationIpRange $OKS_CIDR
kubectl run oks-lab05-test --image=busybox:1.36 --restart=Never --rm -it -- ping -c 4 -W 2 $VM_PRIVATE_IP

Toutes 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
Terminal window
octl iaas securitygrouprule create --group-id $SG_ID --flow Inbound \
--ports tcp/22 --remote-ranges $OKS_CIDR
kubectl run oks-lab05-test --image=busybox:1.36 --restart=Never --rm -it -- nc -zv -w 3 $VM_PRIVATE_IP 22

La 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.

Attention : avant de supprimer une ressource, vérifiez qu’elle n’est pas utilisée par d’autres labs.

Si vous prévoyez de continuer avec le Lab 06, ne supprimez pas les ressources du Lab 01 :

  • le cluster OKS oks-lab01-cluster et ses NodePools ;
  • le fichier kubeconfig oks-lab01-kubeconfig.yaml.

Supprimez les ressources suivantes, dans cet ordre :

  1. Supprimer le Net peering depuis le cluster. OKS supprime aussi le Net peering côté OUTSCALE :

    Terminal window
    kubectl delete netpeering $PCX_ID
    octl iaas netpeering list

    Le Net peering $PCX_ID s’affiche à l’état deleted.

  2. Supprimer le Net et tout son contenu (VM, Security Group, Subnet, route table) :

    Terminal window
    octl iaas net teardown $NET_ID --teardown-vms

    La 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-vms autorise 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.
  3. Vérifiez la suppression du Net :

    Terminal window
    octl iaas net list

    Le Net oks-lab05-net s’affiche à l’état deleting, puis disparaît de la liste.

  4. Supprimer le fichier de la demande de Net peering :

    Terminal window
    rm oks-lab05-peering-request.yaml