Lab 02 : Déploiement et exposition d'une application dans OKS
Objectifs
Section intitulée « Objectifs »À l’issue de ce lab, vous serez capable de :
- installer le contrôleur Ingress NGINX avec Helm ;
- identifier le load balancer OUTSCALE créé automatiquement pour un Service Kubernetes de type
LoadBalancer; - déployer une application et l’exposer en HTTP avec une ressource Ingress ;
- installer cert-manager et créer une autorité de certification (CA) auto-signée ;
- exposer l’application en HTTPS avec un certificat émis par cert-manager.
Architecture du lab
Section intitulée « Architecture du lab »Dans ce lab, vous travaillez dans le cluster oks-lab01-cluster créé au Lab 01, depuis le terminal de votre poste.
Vous installez le contrôleur Ingress NGINX dans le namespace ingress-nginx. Son Service de type LoadBalancer déclenche la création d’un load balancer OUTSCALE public dans le Net du projet OKS : c’est le point d’entrée unique du trafic HTTP et HTTPS vers le cluster.
Vous déployez ensuite l’application de test echoheaders dans le namespace oks-lab02. Une ressource Ingress indique au contrôleur de router les requêtes adressées au nom d’hôte oks-lab02.example.com vers le Service de l’application.
Enfin, cert-manager crée une CA auto-signée, oks-lab02-ca, qui émet le certificat TLS de l’application. Le contrôleur Ingress NGINX termine alors les connexions HTTPS avec ce certificat.
Remarque : le nom d’hôte
oks-lab02.example.comest fictif et n’existe pas dans le DNS. Les tests indiquent àcurlde joindre directement le load balancer, avec ce nom d’hôte dans la requête.
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) ;
- de Helm 4, installé à l’étape 1.1 ;
- d’un terminal bash ou zsh avec
curl.
Le lab utilise la région eu-west-2.
Important : le projet Ingress NGINX de la communauté Kubernetes a été retiré en mars 2026 : il ne reçoit plus de correctifs, y compris de sécurité. Il reste utilisé ici pour présenter le fonctionnement d’un contrôleur Ingress. En production, préférez un contrôleur maintenu ou l’API Gateway de Kubernetes. Consultez l’annonce officielle.
1. Préparer l’environnement
Section intitulée « 1. Préparer l’environnement »1.1 Installer Helm
Section intitulée « 1.1 Installer Helm »Helm est le gestionnaire de paquets de Kubernetes : il installe une application à partir d’un chart (un ensemble de manifestes paramétrables).
-
Installez Helm 4 en suivant uniquement la méthode de votre système. N’utilisez pas les deux méthodes : vous auriez deux versions de Helm sur votre poste.
Sous Linux :
Terminal window curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-4 | bashSous macOS :
Terminal window brew install helm -
Vérifiez l’installation :
Terminal window which -a helmhelm versionUn seul chemin doit s’afficher, et la version doit commencer par
v4.
1.2 Accéder au cluster
Section intitulée « 1.2 Accéder au cluster »-
Placez-vous dans le répertoire qui contient le fichier
oks-lab01-kubeconfig.yaml, puis indiquez à kubectl et Helm 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 nodesLes nœuds des NodePools du Lab 01 s’affichent à l’état
Ready.
2. Installer le contrôleur Ingress NGINX
Section intitulée « 2. Installer le contrôleur Ingress NGINX »Une ressource Ingress décrit des règles de routage HTTP (nom d’hôte, chemin). Elle n’a aucun effet sans un contrôleur Ingress, qui lit ces règles et route le trafic.
2.1 Installer le chart
Section intitulée « 2.1 Installer le chart »-
Ajoutez le dépôt Helm du projet Ingress NGINX :
Terminal window helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginxhelm repo update -
Installez le contrôleur dans le namespace
ingress-nginx:Terminal window helm install ingress-nginx ingress-nginx/ingress-nginx \--namespace ingress-nginx \--create-namespaceingress-nginx(premier argument) : nom de la release Helm. Il sert de préfixe au nom des ressources créées.--create-namespace: crée le namespace s’il n’existe pas.
-
Vérifiez que le Pod du contrôleur est à l’état
Running:Terminal window kubectl get pods -n ingress-nginxExemple de sortie :
NAME READY STATUS RESTARTS AGEingress-nginx-controller-7bbfb99f87-s5cr6 1/1 Running 0 2m
2.2 Identifier le load balancer
Section intitulée « 2.2 Identifier le load balancer »-
Affichez les Services du contrôleur :
Terminal window kubectl get svc -n ingress-nginxExemple de sortie :
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGEingress-nginx-controller LoadBalancer 10.92.12.41 <ADRESSE_DU_LB> 80:30080/TCP,443:30443/TCP 3mingress-nginx-controller-admission ClusterIP 10.92.97.75 <none> 443/TCP 3mLe Service
ingress-nginx-controllerest de typeLoadBalancer: le composant OUTSCALE du cluster a créé un load balancer public, dont l’adresse s’affiche dans la colonneEXTERNAL-IP. Tant qu’elle affiche<pending>, le load balancer est en cours de création (une à deux minutes). -
Enregistrez l’adresse IP publique du load balancer dans la variable
LB:Terminal window LB=$(kubectl get svc ingress-nginx-controller -n ingress-nginx \-o jsonpath='{.status.loadBalancer.ingress[0].ip}')echo $LBL’adresse IP publique du load balancer s’affiche, par exemple
171.33.125.152. -
Affichez aussi le nom DNS du load balancer :
Terminal window kubectl get svc ingress-nginx-controller -n ingress-nginx \-o jsonpath='{.status.loadBalancer.ingress[0].hostname}{"\n"}'Le nom DNS se termine par
.eu-west-2.lbu.outscale.com, le domaine des load balancers OUTSCALE de la Région.
Remarque : le load balancer est créé et géré par OKS : il n’apparaît pas dans la liste des load balancers de votre compte (
octl iaas loadbalancer list). Vous le gérez uniquement à travers le Service Kubernetesingress-nginx-controller.
Remarque : les variables du shell (
LB, etc.) sont perdues si vous fermez votre terminal. Dans ce cas, exécutez de nouveau la commande de l’étape 2.2.
3. Déployer et exposer l’application en HTTP
Section intitulée « 3. Déployer et exposer l’application en HTTP »3.1 Déployer l’application
Section intitulée « 3.1 Déployer l’application »-
Créez le namespace de l’application :
Terminal window kubectl create namespace oks-lab02 -
Créez un fichier
oks-lab02-app.yamlavec le contenu suivant :apiVersion: apps/v1kind: Deploymentmetadata:name: echoheadersnamespace: oks-lab02labels:app: echoheadersspec:replicas: 1selector:matchLabels:app: echoheaderstemplate:metadata:labels:app: echoheadersspec:containers:- name: echoheadersimage: registry.k8s.io/echoserver:1.10ports:- containerPort: 8080protocol: TCP---apiVersion: v1kind: Servicemetadata:name: echoheadersnamespace: oks-lab02labels:app: echoheadersspec:type: ClusterIPselector:app: echoheadersports:- port: 8080targetPort: 8080protocol: TCPL’application
echoheadersrenvoie le détail de chaque requête HTTP reçue. Son Service est de typeClusterIP: il n’est joignable que depuis l’intérieur du cluster. -
Appliquez le manifeste et vérifiez que le Pod est à l’état
Running:Terminal window kubectl apply -f oks-lab02-app.yamlkubectl get pods -n oks-lab02
3.2 Créer l’Ingress HTTP
Section intitulée « 3.2 Créer l’Ingress HTTP »-
Créez un fichier
oks-lab02-ingress.yamlavec le contenu suivant :apiVersion: networking.k8s.io/v1kind: Ingressmetadata:name: echoheadersnamespace: oks-lab02spec:ingressClassName: nginxrules:- host: oks-lab02.example.comhttp:paths:- path: /pathType: Prefixbackend:service:name: echoheadersport:number: 8080ingressClassName: nginx: cet Ingress est pris en charge par le contrôleur Ingress NGINX.host: seules les requêtes adressées àoks-lab02.example.comsont routées vers le Serviceechoheaders.
-
Appliquez le manifeste :
Terminal window kubectl apply -f oks-lab02-ingress.yaml -
Vérifiez l’Ingress :
Terminal window kubectl get ingress -n oks-lab02Exemple de sortie :
NAME CLASS HOSTS ADDRESS PORTS AGEechoheaders nginx oks-lab02.example.com <ADRESSE_DU_LB> 80 1m
3.3 Tester l’accès HTTP
Section intitulée « 3.3 Tester l’accès HTTP »-
Envoyez une requête HTTP au load balancer, pour le nom d’hôte
oks-lab02.example.com:Terminal window curl --connect-to oks-lab02.example.com:80:$LB:80 http://oks-lab02.example.com/--connect-toindique àcurlde se connecter au load balancer tout en envoyant le nom d’hôteoks-lab02.example.com, comme le ferait un navigateur si ce nom existait dans le DNS.Exemple de sortie (extrait) :
Hostname: echoheaders-65475f6b6-llqkwRequest Information:client_address=10.91.0.130method=GETreal path=/request_scheme=httprequest_uri=http://oks-lab02.example.com:8080/Request Headers:host=oks-lab02.example.comx-forwarded-for=10.50.44.176x-forwarded-proto=httpx-real-ip=10.50.44.176La réponse vient du Pod
echoheaders. L’en-têtex-forwarded-for, ajouté par le contrôleur Ingress NGINX, ne contient pas votre adresse IP publique, mais l’IP privée d’un nœud du cluster (10.50.x.x). Le load balancer envoie le trafic à un nœud, qui le transmet au Pod du contrôleur en remplaçant l’adresse source : l’IP réelle du client est perdue.client_addressest l’IP du Pod du contrôleur Ingress NGINX, dans la plage des Pods (10.91.0.0/16). -
Envoyez une requête sans le nom d’hôte :
Terminal window curl http://$LB/Le contrôleur répond
404 Not Found: aucune règle Ingress ne correspond à cette requête.
4. Sécuriser l’application en HTTPS
Section intitulée « 4. Sécuriser l’application en HTTPS »4.1 Installer cert-manager
Section intitulée « 4.1 Installer cert-manager »cert-manager est un contrôleur Kubernetes qui crée et renouvelle des certificats TLS, et les stocke dans des Secrets.
-
Installez cert-manager avec Helm :
Terminal window helm repo add jetstack https://charts.jetstack.io --force-updatehelm install cert-manager jetstack/cert-manager \--namespace cert-manager \--create-namespace \--version v1.19.1 \--set crds.enabled=truecrds.enabled=trueinstalle aussi les CRDs (Custom Resource Definitions) de cert-manager :ClusterIssuer,Issuer,Certificate, etc. -
Vérifiez que les trois Pods de cert-manager sont à l’état
Running:Terminal window kubectl get pods -n cert-manager
4.2 Créer une autorité de certification auto-signée
Section intitulée « 4.2 Créer une autorité de certification auto-signée »Dans ce lab, vous n’utilisez pas d’autorité de certification publique (comme Let’s Encrypt), car le nom d’hôte est fictif. Vous créez votre propre CA en trois ressources :
- le ClusterIssuer
oks-lab02-selfsignedsigne un certificat avec sa propre clé ; - le Certificate
oks-lab02-cautilise ce ClusterIssuer pour créer le certificat de la CA, stocké dans le Secretoks-lab02-ca; - l’Issuer
oks-lab02-ca-issuerutilise la CA stockée dans ce Secret pour émettre les certificats de l’application.
-
Créez un fichier
oks-lab02-ca.yamlavec le contenu suivant :apiVersion: cert-manager.io/v1kind: ClusterIssuermetadata:name: oks-lab02-selfsignedspec:selfSigned: {}---apiVersion: cert-manager.io/v1kind: Certificatemetadata:name: oks-lab02-canamespace: oks-lab02spec:isCA: truecommonName: oks-lab02-casecretName: oks-lab02-caprivateKey:rotationPolicy: AlwaysissuerRef:name: oks-lab02-selfsignedkind: ClusterIssuergroup: cert-manager.io---apiVersion: cert-manager.io/v1kind: Issuermetadata:name: oks-lab02-ca-issuernamespace: oks-lab02spec:ca:secretName: oks-lab02-caLa ligne
rotationPolicy: Alwaysdemande à cert-manager de générer une nouvelle clé privée à chaque renouvellement du certificat. C’est la valeur par défaut depuis cert-manager 1.18 : l’indiquer explicitement évite un avertissement à l’application du manifeste. -
Appliquez le manifeste :
Terminal window kubectl apply -f oks-lab02-ca.yaml -
Vérifiez que le certificat de la CA est prêt et que l’Issuer est utilisable :
Terminal window kubectl get certificate,issuer -n oks-lab02La colonne
READYafficheTruepour le Certificateoks-lab02-caet pour l’Issueroks-lab02-ca-issuer.
4.3 Activer TLS sur l’Ingress
Section intitulée « 4.3 Activer TLS sur l’Ingress »-
Créez un fichier
oks-lab02-ingress-tls.yamlavec le contenu suivant :apiVersion: networking.k8s.io/v1kind: Ingressmetadata:name: echoheadersnamespace: oks-lab02annotations:cert-manager.io/issuer: oks-lab02-ca-issuernginx.ingress.kubernetes.io/ssl-redirect: "false"spec:ingressClassName: nginxtls:- hosts:- oks-lab02.example.comsecretName: oks-lab02-tlsrules:- host: oks-lab02.example.comhttp:paths:- path: /pathType: Prefixbackend:service:name: echoheadersport:number: 8080- L’annotation
cert-manager.io/issuerdemande à cert-manager d’émettre un certificat pour les noms d’hôte de la sectiontls, avec l’Issueroks-lab02-ca-issuer. secretName: oks-lab02-tls: Secret dans lequel cert-manager stocke le certificat de l’application. Il doit être différent du Secret de la CA.- L’annotation
ssl-redirect: "false"conserve l’accès HTTP, pour comparer les deux protocoles. Sans elle, le contrôleur redirige le HTTP vers le HTTPS.
- L’annotation
-
Appliquez le manifeste. L’Ingress
echoheadersexiste déjà : il est mis à jour.Terminal window kubectl apply -f oks-lab02-ingress-tls.yaml -
Vérifiez que cert-manager a émis le certificat de l’application :
Terminal window kubectl get certificate -n oks-lab02Exemple de sortie :
NAME READY SECRET AGEoks-lab02-ca True oks-lab02-ca 5moks-lab02-tls True oks-lab02-tls 30s
4.4 Tester l’accès HTTPS
Section intitulée « 4.4 Tester l’accès HTTPS »-
Envoyez une requête HTTPS et affichez le certificat présenté par le contrôleur :
Terminal window curl -kv --connect-to oks-lab02.example.com:443:$LB:443 \https://oks-lab02.example.com/ 2>&1 | grep -E "issuer:|request_scheme"-kaccepte un certificat signé par une CA inconnue de votre poste (votre CA auto-signée).-vaffiche le détail de la connexion TLS.
Exemple de sortie :
* issuer: CN=oks-lab02-carequest_scheme=httpLe certificat est émis par votre CA
oks-lab02-ca. Le contrôleur Ingress NGINX termine la connexion HTTPS, puis transmet la requête en HTTP au Pod : c’est la terminaison TLS. -
Vérifiez que l’accès HTTP fonctionne toujours :
Terminal window curl --connect-to oks-lab02.example.com:80:$LB:80 http://oks-lab02.example.com/
Validation du lab
Section intitulée « Validation du lab »Pour valider votre lab, vérifiez les points suivants :
kubectl get pods -n ingress-nginxaffiche le Podingress-nginx-controllerà l’étatRunning.kubectl get svc -n ingress-nginxaffiche une adresse dans la colonneEXTERNAL-IPdu Serviceingress-nginx-controller.echo $LBaffiche l’adresse IP publique du load balancer.curl --connect-to oks-lab02.example.com:80:$LB:80 http://oks-lab02.example.com/renvoie la réponse du Podechoheaders.kubectl get certificate -n oks-lab02afficheoks-lab02-caetoks-lab02-tlsà l’étatREADY True.- La requête HTTPS de l’étape 4.4 affiche
issuer: CN=oks-lab02-ca.
Challenge
Section intitulée « Challenge »- Passez le Deployment
echoheadersà 3 réplicas, puis envoyez plusieurs requêtes HTTP : observez la valeur deHostnamedans les réponses. - Supprimez l’annotation
nginx.ingress.kubernetes.io/ssl-redirectde l’Ingress, appliquez de nouveau le manifeste, puis envoyez une requête HTTP aveccurl -I.
Question : Pourquoi le Secret
oks-lab02-tlsdoit-il être différent du Secretoks-lab02-ca?
💡 Correction — Passage à 3 réplicas
kubectl scale deployment echoheaders -n oks-lab02 --replicas=3for i in 1 2 3 4 5 6; do curl -s --connect-to oks-lab02.example.com:80:$LB:80 http://oks-lab02.example.com/ | grep HostnamedoneLa valeur de Hostname change d’une requête à l’autre : le contrôleur Ingress NGINX répartit les requêtes entre les trois Pods.
💡 Correction — Redirection HTTP vers HTTPS
curl -I --connect-to oks-lab02.example.com:80:$LB:80 http://oks-lab02.example.com/Le contrôleur répond 308 Permanent Redirect, avec un en-tête Location: https://oks-lab02.example.com/. Dès qu’un Ingress déclare une section tls, le contrôleur redirige par défaut le HTTP vers le HTTPS.
💡 Correction — Question du challenge
cert-manager écrit le certificat de l’application dans le Secret indiqué par secretName. Si ce Secret était oks-lab02-ca, cert-manager remplacerait le certificat de la CA par celui de l’application : l’Issuer oks-lab02-ca-issuer ne pourrait plus émettre de certificats.
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 03, 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, qui ne seront pas réutilisées :
-
Supprimer l’application, l’Ingress et la CA :
Terminal window kubectl delete namespace oks-lab02kubectl delete clusterissuer oks-lab02-selfsigned -
Désinstaller cert-manager :
Terminal window helm uninstall cert-manager -n cert-managerkubectl delete namespace cert-manager -
Désinstaller le contrôleur Ingress NGINX. La suppression du Service
ingress-nginx-controllerentraîne celle du load balancer :Terminal window helm uninstall ingress-nginx -n ingress-nginxkubectl delete namespace ingress-nginx -
Vérifiez qu’il ne reste aucun Service de type
LoadBalancerdans le cluster :Terminal window kubectl get svc -A | grep LoadBalancerLa commande n’affiche rien.