Helm Helm

Trouver et installer des charts publiés depuis Artifact Hub

Recherchez un chart déjà écrit par quelqu'un d'autre, inspectez-le avant de l'installer et ne surchargez que ce dont vous avez besoin.

8 min Débutant

La plupart des logiciels d’infrastructure que vous exécuteriez dans Kubernetes, stacks de monitoring, contrôleurs d’ingress, bases de données, disposent déjà d’un chart publié. Ce guide couvre comment en trouver un, vérifier ce qu’il installe réellement avant de vous engager, et surcharger ses valeurs par défaut pour votre environnement.

Rechercher sans ajouter de dépôt au préalable

helm search hub prometheus

helm search hub interroge Artifact Hub, l’index de la CNCF pour les charts (et d’autres paquets cloud-native) issus de nombreux dépôts différents, sans qu’il soit nécessaire d’ajouter d’abord ce dépôt en local. C’est le moyen le plus rapide de voir ce qui existe et qui le publie. Parcourir directement artifacthub.io donne le même catalogue, avec une meilleure interface pour comparer les options, lire le README d’un chart et vérifier la date de sa dernière mise à jour. (Cette recherche passait autrefois par un « Helm Hub » distinct ; ce service a été retiré en 2020 et intégré à Artifact Hub, si bien que helm search hub interroge Artifact Hub depuis des années.)

Ajouter un dépôt et rechercher parmi ceux ajoutés

Une fois votre source choisie, ajoutez-la et recherchez en local :

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update
helm search repo prometheus-community

helm repo add enregistre un dépôt de charts par son nom ; helm repo update actualise l’index local de Helm de ce que propose chaque dépôt ajouté. helm search repo (notez : repo, pas hub) ne recherche que dans les dépôts que vous avez déjà ajoutés, ce que vous utiliserez au quotidien une fois que vous savez d’où viennent vos charts. helm repo list affiche tout ce qui est actuellement enregistré.

Inspecter un chart avant de l’installer

N’installez jamais un chart à l’aveugle, surtout s’il dispose de permissions étendues ou s’il gère du stockage :

helm show chart prometheus-community/prometheus
helm show readme prometheus-community/prometheus
helm show values prometheus-community/prometheus

show chart donne les métadonnées (version, mainteneurs, dépendances). show readme correspond aux notes d’installation et de configuration de l’éditeur lui-même, généralement le moyen le plus rapide de savoir ce qu’un chart attend. show values affiche l’intégralité de son values.yaml par défaut, qui est la vraie référence de ce que vous pouvez surcharger, plus complète que n’importe quel README.

Installer avec vos propres surcharges

helm install monitoring prometheus-community/prometheus \
  -n monitoring --create-namespace \
  --set server.retention=15d \
  --set alertmanager.persistentVolume.size=10Gi

--create-namespace évite une étape kubectl create namespace séparée. Tout ce qui figure dans le guide sur les values propres à un environnement s’applique aussi ici : pour tout ce qui dépasse un test rapide, écrivez vos surcharges dans un fichier de values et passez-le avec -f plutôt que d’accumuler des options --set, afin que ce que vous avez installé soit reproductible à partir d’un fichier sous gestion de versions.

# monitoring-values.yaml
server:
  retention: 15d
alertmanager:
  persistentVolume:
    size: 10Gi
helm upgrade --install monitoring prometheus-community/prometheus \
  -n monitoring --create-namespace -f monitoring-values.yaml

Épingler une version délibérément

Sans --version, helm install utilise la dernière version du chart disponible, qui peut changer entre le moment où vous écrivez un fichier de values et celui où vous exécutez réellement la commande :

helm search repo prometheus-community/prometheus --versions
helm install monitoring prometheus-community/prometheus --version 25.8.0 -n monitoring

Épingler une version est la pratique standard pour tout ce qui dépasse une expérimentation locale, pour la même raison que vous épingleriez le tag d’une image de conteneur plutôt que de suivre latest : c’est la différence entre un déploiement que vous pouvez reproduire et un déploiement dont vous pouvez seulement espérer qu’il était identique au précédent.

Guides populaires