Trajet d'une requête HTTP dans la plateforme

Navigateur

Le navigateur de l’utilisateur envoie une requête HTTPS vers l’URL publique de l’application (par exemple https://api.exemple.com). Il résout le nom d’hôte via DNS, établit une connexion TLS, puis transmet la requête HTTP.Où déboguer: Onglet Réseau des outils de développement du navigateur (F12).Commande utile:

curl -I -v https://api.exemple.com

Cloudflare

Cloudflare gère la résolution DNS pour les 18 zones de la plateforme et assure la terminaison TLS de bordure. Il sert également de pare-feu applicatif (WAF) et peut mettre en cache certaines ressources.Où déboguer: Console Cloudflare, onglet DNS et Security Events.Commande utile:

dig api.exemple.com

Load balancer Hetzner

Deux load balancers Hetzner répartissent le trafic entrant: kaeyros.org (95.217.173.179 à Helsinki) et sem-a.com (46.225.34.99 à Nuremberg). Ils dirigent le trafic vers les nœuds du cluster Kubernetes RKE2.Où déboguer: Console Hetzner Cloud, section Load Balancers.Commande utile:

curl -I --resolve api.exemple.com:443:95.217.173.179 https://api.exemple.com

Traefik

Traefik est l’ingress controller du cluster. Il écoute sur l’entrypoint websecure, gère HTTP/3, redirige automatiquement le port 80 vers 443, et route les requêtes vers l’Ingress correspondant en fonction du nom d’hôte.Où déboguer: Dashboard Traefik (accessible via port-forward) ou logs des pods Traefik.Commande utile:

kubectl -n traefik get pods
kubectl -n traefik logs -l app.kubernetes.io/name=traefik --tail=100

Ingress

L’objet Ingress (avec ingressClassName: traefik) définit les règles de routage par nom d’hôte. Il associe un nom de domaine à un Service interne du cluster. Attention: les annotations nginx.ingress.kubernetes.io/* présentes dans de nombreux fichiers de valeurs n’ont aucun effet car l’ingress controller est Traefik, pas NGINX.Où déboguer: Description de l’objet Ingress dans le namespace de l’application.Commande utile:

kubectl -n <namespace> get ingress
kubectl -n <namespace> describe ingress <nom-de-l-ingress>

Service ClusterIP

Le Service de type ClusterIP expose l’application à l’intérieur du cluster. Son nom suit la convention fullname = <Application>-<chart>. C’est ce nom DNS interne que les autres services utilisent pour communiquer (par exemple http://<service>.<namespace>.svc.cluster.local).

Renommer une Application recrée le Service et change son nom DNS interne. Cela casse les appels service-à-service écrits en dur. Planifiez ce type de changement hors heures de pointe.

Où déboguer: Endpoints du Service et état des cibles.Commande utile:

kubectl -n <namespace> get svc
kubectl -n <namespace> get endpoints <nom-du-service>

Rollout

Le chart rollout (ou rollout-v2, recommandé) gère le déploiement via Argo Rollouts. Il contrôle le nombre de replicas, les mises à jour progressives (canary) et la répartition des pods sur les nœuds. Par défaut, le chart rollout éloigne les pods du nœud big-one-9d0479e4 avec une préférence de poids 100 (preferredDuringScheduling).Où déboguer: Interface ArgoCD ou description du Rollout.Commande utile:

kubectl -n <namespace> get rollout
kubectl -n <namespace> describe rollout <nom-du-rollout>

Pods

Les pods exécutent les conteneurs applicatifs. Le nom complet d’un pod suit le schéma: <Application>-<chart>-<hash ReplicaSet>-<hash pod>. Par exemple: biolab-prod-api-rollout-v2-787d6449d4-vntt5 correspond à l’Application biolab-prod-api avec le chart rollout-v2.Où déboguer: Logs des pods et événements du namespace.Commande utile:

kubectl -n <namespace> get pods
kubectl -n <namespace> logs <nom-du-pod> --tail=200
kubectl -n <namespace> describe pod <nom-du-pod>

PostgreSQL

La base de données PostgreSQL est gérée par l’opérateur Zalando. Le pod principal porte le suffixe -0 (par exemple <nom>-0). La base peut résider dans le même namespace que l’application ou dans le namespace dédié database.Où déboguer: État du cluster PostgreSQL via patronictl.Commande utile:

kubectl -n <namespace> exec <nom-du-cluster>-0 -- patronictl list
kubectl -n <namespace> get pods -l cluster-name=<nom-du-cluster>

Symptôme	Étape à inspecter	Commande
DNS ne résout pas	Cloudflare	`dig <hôte>`
Erreur TLS / certificat invalide	cert-manager / ClusterIssuer	`kubectl get certificate -A \| grep -v ' True '`
404 Traefik	Ingress mal configuré	`kubectl -n <ns> describe ingress <nom>`
502 Bad Gateway / 503 Service Unavailable	Service ou pods	`kubectl -n <ns> get pods,endpoints`
Base de données injoignable	PostgreSQL	`kubectl -n <ns> exec <cluster>-0 -- patronictl list`

Modèle GitOps

Anatomie d'une application

Le trajet complet

Chaque étape en détail

Où regarder quand ça ne marche pas

​Le trajet complet

​Chaque étape en détail

​Où regarder quand ça ne marche pas

Le trajet complet

Chaque étape en détail

Où regarder quand ça ne marche pas