Guide de démarrage rapide
Ce guide explique comment commencer rapidement à utiliser Helm.
Conditions préalables
Les conditions préalables suivantes sont requises pour une utilisation correcte et sécurisé de Helm :
- Posséder un cluster Kubernetes.
- Décider des configurations de sécurité à appliquer à votre installation, si vous en avez.
- Installation et configuration de Helm.
Installer Kubernetes ou avoir accès à un cluster
- Vous devez avoir installé Kubernetes. Pour la dernière release de Helm, nous recommandons la dernière version stable de Kubernetes, qui est dans la plupart des cas la deuxième release mineure la plus récente.
- Vous devriez également avoir une copie locale configurée de
kubectl
.
Lisez la Politique de prise en charge de la version Helm pour connaitre la différence de version maximal pris en charge entre Helm et Kubernetes.
Installer Helm
Télécharger le binaire de la dernière release de Helm. Vous pouvez également utiliser un gestionnaire de package tel que homebrew
, ou regarder sur
la page des releases officielles.
Pour plus de détails, ou d'autre options d'installation rendez vous sur le guide d'installation.
Initialiser un dépot de charts Helm
Une fois que votre Helm est prêt, vous avez la possibilité d'ajouter un dépot de charts. Regardez le Artifact Hub pour voir les dépots publiques de charts Helm disponibles.
$ helm repo add stable https://charts.helm.sh/stable
Une fois que le dépot est configuré, vous aurez la possibilité de lister les charts que vous pouvez installer :
$ helm search repo stable
NAME chart VERSION APP VERSION DESCRIPTION
stable/acs-engine-autoscaler 2.2.2 2.1.1 DEPRECATED Scales worker nodes within agent pools
stable/aerospike 0.2.8 v4.5.0.5 A Helm chart for Aerospike in Kubernetes
stable/airflow 4.1.0 1.10.4 Airflow is a platform to programmatically autho...
stable/ambassador 4.1.0 0.81.0 A Helm chart for Datawire Ambassador
# ... and many more
Installer un chart d'exemple
Pour installer un chart, vous pouvez exécuter la commande helm install
. Helm a plusieurs moyens de trouver et d'installer un chart, mais le plus simple reste d'utiliser le dépot officiel de charts «stable».
$ helm repo update # Make sure we get the latest list of charts
$ helm install stable/mysql --generate-name
Released smiling-penguin
Dans l'exemple ci-dessus, le chart stable / mysql
a été déployé, et le nom de notre nouvelle release est «smiling-penguin».
Vous pouvez obtenir les informations simples des fonctionnalités de ce chart MySQL en exécutant helm show chart stable/mysql
. Ou vous pouvez lancer helm show all stable/mysql
pour obtenir toute les informations disponibles.
Chaque fois que vous installez un chart, une nouvelle release est créée. Un chart peut donc être installé plusieurs fois sur le même cluster. Et chaque release peut être indépendamment gérée et mise à jour.
La commande helm install
est très puissante et possède beaucoup de fonctionnalités. Pour en apprendre plus sur cette commande lisez le
Guide d'utilisation de Helm
Apprenez en plus sur le système de release
Il est facile de voir ce qui à été deployé avec Helm :
$ helm ls
NAME VERSION UPDATED STATUS chart
smiling-penguin 1 Wed Sep 28 12:59:46 2016 DEPLOYED mysql-0.1.0
La fonction helm list
vous montrera une liste de toutes les release déployées.
Désinstaller une release
Pour désinstaller une release utiliser la commande helm uninstall
:
$ helm uninstall smiling-penguin
Removed smiling-penguin
Cela désinstallera la release smiling-penguin
de Kubernetes, toutes les ressources associées à cette release seront supprimés ainsi que l'historique lié.
Si l'indicateur --keep-history
est fourni, l'historique des releases sera conservé. Vous serez même en mesure de demander des informations sur cette release :
$ helm status smiling-penguin
Status: UNINSTALLED
...
Étant donné que Helm suit vos releases même après les avoir désinstallées, vous pouvez auditer l'historique d'un cluster, et même annuler la suppression d'une release (avec helm rollback
).
Lecture du l'aide
Pour en savoir plus sur les commandes Helm disponibles, utilisez helm help
ou tapez une commande suivie de l'indicateur -h
:
$ helm get -h