Installation de l'interface de ligne de commande Helm (helm)

Vous pouvez utiliser l'interface de ligne de commande Helm pour gérer les éditions dans votre cluster.

Pour plus d'informations sur Helm, voir helm / docs, dans GitHub S'ouvre dans un nouvel onglet .

Dans la mesure où IBM Cloud Private offre un contrôle d'accès à base de rôles, vous devez installer une version spécifique du client CLI Helm et fournir des certificats contenant le jeton d'accès à IBM Cloud Private pour un compte spécifique.

Important : après avoir configuré une connexion, vous devez ajouter l'option --tls aux commandes Helm qui accèdent au serveur via Tiller.

Avant de configurer l'interface de ligne de commande Helm, vous devez exécuter les étapes suivantes :

Installez l'outil de ligne de commande Kubernetes, kubectl, et configurez l'accès à votre cluster. Voir Installation de l'interface de ligne de commande Kubernetes (kubectl).
Installez l'interface de ligne de commande IBM Cloud Private et connectez-vous à votre cluster. Voir Installation de l'interface de ligne de commande IBM Cloud Private.
Procurez-vous les droits d'accès au noeud d'amorçage et au compte d'administrateur de cluster ou demandez à une personne disposant de ce niveau d'accès de créer votre certificat. Si vous ne pouvez pas accéder au compte d'administrateur de cluster, vous devez avoir un compte IBM Cloud Private auquel le rôle d'administrateur est affecté pour une équipe et qui peut accéder à l'espace de nom kube-system.

Installation de l'interface de ligne de commande Helm

Vous pouvez installer l'interface de ligne de commande Helm à partir de l'interface de ligne de IBM Cloud Private.

Procédez comme suit pour installer l'interface de ligne de commande Helm à l'aide de l'interface de ligne de commande IBM Cloud Private :

Depuis la page Initiation de la console de gestion IBM Cloud Private, cliquez sur Installer les outils d'interface de ligne de commande.
Développez Installer l'interface de ligne de commande Helm. Lisez le texte puis copiez et exécutez la commande curl pour votre système d'exploitation. Poursuivez la procédure d'installation de la documentation produit.

Choisissez la commande curl pour le système d'exploitation applicable. Ainsi, vous pouvez exécuter la commande suivante pour macOS :
```
curl -kLo <install_file> https://<Cluster Master Host>:<Cluster Master API Port>/api/cli/helm-darwin-amd64.tar.gz
```
Une fois que vous avez exécuté la commande curl pour votre système d'exploitation, créez un répertoire helm-unpacked et décompressez le fichier d'installation dans ce répertoire avec les commandes suivantes :
```
mkdir helm-unpacked
```
```
tar -xvzf ./<path_to_installer> -C helm-unpacked 

```
Transformez le fichier en fichier exécutable puis déplacez-le dans votre répertoire :
- Pour Linux® et macOS, exécutez les commandes suivantes pour changer et déplacer le fichier :
```
chmod 755 ./helm-unpacked/<unpacked_dir>/helm
```
```
sudo mv ./helm-unpacked/<unpacked_dir>/helm /usr/local/bin/helm
```
- Pour Windows™, renommez le fichier téléchargé en helm et placez le fichier dans la variable d'environnement PATH.
Supprimez le programme d'installation et les archives décompressées supplémentaires :
```
 rm -rf ./helm-unpacked ./<path_to_installer>
```

Remarque : vous pouvez aussi télécharger l'interface de ligne de commande Helm depuis la communauté Helm. Voir Helm v2.12.3 - Bug Fix Release S'ouvre dans un nouvel onglet pour la procédure d'installation.

Vérification de l'installation

Si vous utilisez Helm 2.12.3, vous devez définir HELM_HOME :
```
 export HELM_HOME=~/.helm
```
Initialisez votre interface de ligne de commande Helm. Important : n'utilisez pas l'option --upgrade avec la commande helm init. Si vous ajoutez l'option --upgrade, la version de serveur de Helm Tiller qui est installée avec IBM Cloud Private sera remplacée.
- Pour les environnements disposant d'un accès à Internet, exécutez la commande suivante :
```
helm init --client-only
```
- Pour les environnements airgap, exécutez la commande suivante :
```
helm init --client-only --skip-refresh
```

Vérifiez que l'interface de ligne de commande Helm est initialisée. Exécutez la commande suivante :

 helm version --tls

La sortie ressemble au contenu ci-après :

 Client: &version.Version{SemVer:"v2.12.3", GitCommit:"20adb27c7c5868466912eebdf6664e7390ebe710", GitTreeState:"clean"}

 Server: &version.Version{SemVer:"v2.12.3+icp", GitCommit:"843201eceab24e7102ebb87cb00d82bc973d84a7", GitTreeState:"clean"}

Procédez comme suit pour prendre connaissance de la liste des packages disponibles ou installés :
1. Ajoutez un référentiel Helm. Pour ajouter le référentiel Kubernetes Incubator, exécutez la commande suivante :
```
 helm repo add incubator https://kubernetes-charts-incubator.storage.googleapis.com/
```
2. Affichez les chartes disponibles en exécutant la commande suivante :
```
 helm search -l
```
3. Installez une charte. Exécutez la commande suivante :
```
 helm install --name=release_name stable/chart_in_repo --tls
```
  Dans cette commande, release_name est le nom pour l'édition à créer depuis la charte, et chart_in_repo est le nom de la charte disponible à installer. Ainsi, pour installer la charte WordPress, exécutez la commande suivante :
```
 helm install --name=my-wordpress stable/wordpress --tls
```
4. Répertoriez les éditions en exécutant la commande suivante :
```
 helm list --tls
```
  La sortie ressemble au contenu ci-après :
```
 NAME                REVISION    UPDATED                     STATUS      CHART              NAMESPACE
 my-wordpress        1           Wed Jun 28 22:15:13 2017    DEPLOYED    wordpress-0.6.5    default
```
5. Pour retirer une édition, exécutez la commande suivante :
```
 helm delete release_name --purge --tls
```
  Dans cette commande, release_name est le nom de l'édition à retirer. Ainsi, pour retirer l'édition WordPress, exécutez la commande suivante :
```
 helm delete my-wordpress --purge --tls
```