TP : Déployer Alloy sur Kubernetes avec Helm

Ce que vous allez apprendre dans ce TP

• Installer Alloy avec Helm
• Découvrir des pods par annotation
• Externaliser la configuration

Introduction #

Ce que vous allez apprendre dans cette section

• Installer Alloy avec Helm
• Découvrir des pods par annotation
• Externaliser la configuration

Contexte. En production Alloy tourne sur Kubernetes. Vous le déployez avec le Helm Chart officiel, en StatefulSet clusterisé, puis vous sortez sa configuration dans une ConfigMap pour qu'elle soit versionnée dans Git et modifiable sans réinstaller le chart.

Prérequis : Un cluster local (kind, minikube ou k3d), kubectl et helm  ·  Durée estimée : 45 min

Prérequis : un cluster Kubernetes local (kind, minikube ou k3d), kubectl et helm.

Installation avec Helm #

Valeurs du chart et configuration River.

1. 1. Écrire le fichier values.yaml

   Pourquoi ? Un fichier values versionné décrit l'installation complète : c'est la base d'un déploiement reproductible plutôt que de commandes tapées à la main.

   Configurez le chart pour déployer 3 réplicas en statefulset, avec le clustering activé, et une configuration qui découvre les pods ayant l'annotation prometheus.io/scrape: "true".

2. 2. Installer le chart

   Pourquoi ? Helm applique le chart et crée les ressources (StatefulSet, RBAC, Service) : on vérifie donc que tout est démarré avant d'aller plus loin.

   Ajoutez le dépôt Helm de Grafana et installez la release alloy dans le namespace monitoring.

3. 3. Contrôler le cluster

   Pourquoi ? Le port-forward donne accès à l'UI sans l'exposer sur Internet ; vérifier les 3 membres confirme que le clustering fonctionne dans Kubernetes.

   Faites un port-forward sur un pod, ouvrez l'UI et vérifiez que le cluster compte 3 membres. Consultez les logs en cas d'erreur de configuration.

Externaliser la configuration #

Séparer le code du chart.

1. 4. Utiliser une ConfigMap existante

   Pourquoi ? Séparer la configuration du chart permet de la modifier par une simple mise à jour de ConfigMap et de la relire depuis Git, sans toucher aux valeurs d'infrastructure.

   Sortez la configuration River du values.yaml : créez une ConfigMap à partir d'un fichier config.alloy versionné dans Git et demandez au chart de l'utiliser sans en créer une.

Niveau de difficulté : ●●●○○ (3/5)