Article

Infra de A à Z 098 – Traefik & Consul Sync Catalog : auto-configuration via annotations

TL;DR

Cette série construit progressivement une infrastructure cloud complète sur Infomaniak Public Cloud. Dans cet épisode, le sujet précis est: Traefik & Consul Sync Catalog : auto-configuration via annotations. Rendre l exposition HTTP/HTTPS cohérente avec "Traefik & Consul Sync Catalog : auto-configuration via annotations": routage Traefik, dashboard, TLS, DNS ou fournisseur dynamique.

La vidéo de référence

Vidéo: https://www.youtube.com/watch?v=Kn7DIbnOh2w

Playlist complète: https://www.youtube.com/playlist?list=PLn6POgpklwWpehxly1wOT6eB2NvZX9A-X

Le dépôt support est disponible ici: https://gitlab.com/xavki/infrastructure-cloud-infomaniak. Le chapitre correspondant est 97-kubernetes-annotations-consul.

Objectif précis de l épisode

Rendre l exposition HTTP/HTTPS cohérente avec "Traefik & Consul Sync Catalog : auto-configuration via annotations": routage Traefik, dashboard, TLS, DNS ou fournisseur dynamique.

Concrètement, cet épisode sert à passer d une intention formulée dans le titre à une modification vérifiable dans l infrastructure. Le dépôt donne les fichiers, la vidéo donne l ordre de manipulation, et la vérification doit confirmer que la brique fonctionne vraiment.

Traefik & Consul Sync Catalog : auto-configuration via annotations: c est quoi exactement ?

Dans une infrastructure cloud réelle, chaque épisode ajoute une brique: réseau, compute, sécurité, automatisation, découverte de services, observabilité, sauvegardes ou orchestration. Ici, les outils détectés sont: openstack, consul, traefik, kubernetes.

Dans cet épisode, il faut surtout regarder les éléments qui correspondent au titre: les ressources créées ou modifiées, les fichiers du chapitre, les services touchés et la preuve de fonctionnement. Les outils détectés donnent le contexte, mais le fil rouge reste Traefik & Consul Sync Catalog : auto-configuration via annotations.

Ce que la vidéo cherche à modifier

  • déclarer ou utiliser les services Consul nécessaires
  • relier DNS interne, checks et catalogue
  • préparer l intégration avec proxy ou monitoring
  • définir les routes et services exposés
  • séparer dashboard, backends et endpoints publics
  • relier Traefik à Consul ou Kubernetes si nécessaire
Découvrez  Infra de A à Z 083 - Les conteneurs, c'est quoi ??

Indices extraits des slides

  • Kubernetes: Use annotations for consul services
  • How to create to resolv pods or services from instances ?
  • Consul Sync Catalog
  • Kubernetes internal dns <> Consul nodes/services
  • That provides us a dns with an automatic synchronization

Notions et définitions des outils

  • openstack: OpenStack est la couche cloud IaaS: instances, réseaux, routeurs, IP flottantes, groupes de sécurité, volumes et images. Chez Infomaniak Public Cloud, il sert de socle programmable via GUI, CLI, Terraform et API.
  • consul: Consul apporte service discovery, DNS interne, health checks et catalogue de services. Il relie machines, proxy, monitoring et automatisation.
  • traefik: Traefik est un reverse proxy dynamique. Il route HTTP/HTTPS vers des backends et peut se configurer via Consul ou annotations Kubernetes.
  • kubernetes: Kubernetes orchestre des conteneurs sur un cluster: pods, deployments, services, CNI, kubeadm, Helm et intégration avec Terraform/Consul/monitoring.

Ces définitions sont volontairement pratiques: elles expliquent à quoi sert l outil dans la chaîne, pas seulement ce qu il est sur le papier.

Points clés à retenir pour cet épisode

  • Comprendre le rôle de Traefik & Consul Sync Catalog : auto-configuration via annotations dans la progression globale de l infrastructure.
  • Identifier la couche concernée: cloud, automatisation, réseau, service, observabilité ou orchestration.
  • Relier les fichiers du dépôt au résultat attendu sur les machines ou dans le cloud.
  • Valider les objets Kubernetes créés et leur intégration avec le réseau et le monitoring.

Approfondissement spécifique

Avec Traefik & Consul Sync Catalog : auto-configuration via annotations, Consul sert de tissu de découverte entre les machines. Le point spécifique est de comprendre quelle information entre dans le catalogue: nom du service, adresse, port, tags et health check.

Un service déclaré mais unhealthy ne doit pas être considéré comme disponible. Il faut suivre la chaîne DNS Consul -> catalogue -> check -> consommateur du service, par exemple Traefik, monitoring ou un autre composant applicatif.

Avec Traefik & Consul Sync Catalog : auto-configuration via annotations, Traefik est le point d entrée HTTP/HTTPS. Le détail important est l association entre hostname, route, service backend, certificat et fournisseur de configuration.

Découvrez  Infra de A à Z 082 - GitLab: Backups to Object Storage & Ansible

Un 404, un 502 ou un certificat absent ne se diagnostiquent pas au même endroit. Il faut distinguer DNS, routage Traefik, service découvert, port backend et TLS.

Exemple de code ou configuration du dépôt

Les exemples complets sont dans les répertoires du chapitre listés plus bas.

Chemin de diagnostic recommandé

  • vérifier les membres Consul
  • contrôler les entrées DNS et services
  • regarder l état des health checks
  • tester le hostname
  • vérifier certificat et route
  • contrôler les logs Traefik en cas de 404 ou 502
  • Comparer l état attendu dans le dépôt et l état réel dans le cloud, la machine ou le cluster.
  • Documenter la commande, l écran ou la métrique qui prouve que l étape est fonctionnelle.

Répertoires et commandes utiles

Pièges fréquents

  • oublier les ports Consul
  • déclarer un service sans health check utile
  • dépendre du DNS sans tester la résolution
  • exposer le dashboard sans protection
  • confondre service interne et endpoint public
  • oublier DNS ou TLS

Liens utiles externes

Liens internes conseillés

Pour continuer, lire Infra A à Z 099 – Kubernetes : gestion de configurations et persistence de datas.

FAQ

Pourquoi utiliser Terraform et Ansible ensemble ?

Terraform est adapté à la création et au cycle de vie des ressources cloud. Ansible est adapté à la configuration des machines et services. Les mélanger sans frontière claire rend les changements difficiles à relire.

Pourquoi Infomaniak/OpenStack dans cette série ?

Infomaniak Public Cloud expose des concepts OpenStack standards: compute, réseau, volumes, security groups, object storage, identity et orchestration. Cela permet d apprendre des notions transférables tout en travaillant sur un fournisseur concret.

Que faut-il sécuriser en premier ?

Les accès: credentials cloud, state Terraform, SSH, VPN, dashboards, secrets Ansible, tokens GitLab, consoles d administration et ports exposés publiquement. Une infrastructure automatisée amplifie aussi les erreurs de sécurité.

Comment savoir si une étape est terminée ?

Chaque étape doit produire une preuve: une ressource visible, un service joignable, une métrique collectée, un backup restaurable, une requête qui répond ou un déploiement qui converge.

Conclusion

L épisode 98 s inscrit dans une progression complète: construire, automatiser, sécuriser, observer et exploiter une infrastructure cloud. Le dépôt Xavki donne les exemples concrets, la documentation Infomaniak/OpenStack donne le cadre fournisseur, et le deep dive permet de comprendre le rôle des outils au lieu de seulement rejouer des commandes.

Explorer les formations Xavki

Pour apprendre dans l ordre, repartez depuis la roadmap ou une playlist thematique.