Helm-CLI (helm) installieren

Sie können die Helm-CLI verwenden, um die Releases in Ihrem Cluster zu verwalten.

Weitere Informationen zu Helm finden Sie unter Helm-Dokumente in GitHub .

Da IBM Cloud Private eine rollenbasierte Zugriffssteuerung bietet, müssen Sie eine bestimmte Version des Helm-CLI-Clients installieren und Zertifikate bereitstellen, die das IBM Cloud Private-Zugriffstoken für ein bestimmtes Konto enthalten.

Wichtig: Nachdem Sie eine Verbindung konfiguriert haben, müssen Sie die Option --tls zu Helm-Befehlen hinzufügen, die über Tiller auf den Server zugreifen.

Bevor Sie die Helm-CLI einrichten, müssen Sie die folgenden Schritte ausführen:

• Installieren Sie das Kubernetes-Befehlszeilentool kubectl und konfigurieren Sie den Zugriff auf Ihren Cluster. Informationen hierzu finden Sie im Abschnitt Kubernetes-CLI (kubectl) installieren.
• Installieren Sie die IBM Cloud Private-CLI und melden Sie sich bei Ihrem Cluster an. Weitere Informationen finden Sie in Installieren der IBM Cloud Private-CLI.
• Fordern Sie den Zugriff auf den Bootknoten und das Clusteradministratorkonto an oder fordern Sie an, dass ein Benutzer mit dieser Zugriffsebene Ihr Zertifikat erstellt. Wenn Sie nicht auf das Clusteradministratorkonto zugreifen können, müssen Sie über ein IBM Cloud Private-Konto verfügen, dem die Rolle "Administrator" für ein Team zugeordnet ist und das auf den Namensbereich kube-system zugreifen kann.

Helm-CLI installieren

Sie können die Helm-CLI über die IBM Cloud Private-CLI installieren.

Führen Sie folgende Schritte aus, um die Helm-CLI unter Verwendung der IBM Cloud Private-CLI zu installieren:

1. Klicken Sie in der Managementkonsole von IBM Cloud Private auf der Seite Erste Schritte auf CLI-Tools installieren.

2. Erweitern Sie die Anzeige für Helm-CLI installieren. Lesen Sie den Text. Kopieren Sie dann den 'curl'-Befehl für Ihr Betriebssystem und führen Sie ihn aus. Fahren Sie mit der in der Produktdokumentation beschriebenen Installationsprozedur fort.

   Wählen Sie den 'curl'-Befehl für das jeweilige Betriebssystem aus. Für Mac OS können Sie zum Beispiel den folgenden Befehl ausführen:

   curl -kLo <Installationsdatei> https://<Cluster-Master-Host>:<Cluster-Master-API-Port>/api/cli/helm-darwin-amd64.tar.gz
   

3. Erstellen Sie nach dem Ausführen des 'curl'-Befehls für das Betriebssystem das Verzeichnis helm-unpacked und entpacken Sie die Installationsdatei in diesem Verzeichnis mit den folgenden Befehlen:

   mkdir helm-unpacked
   

   tar -xvzf ./<Pfad_zum_Installationsprogramm> -C helm-unpacked
   <!-- DOC-Test hier blockiert -->
   

4. Ändern Sie die Datei in eine ausführbare Datei und verschieben Sie die Datei anschließend in das Verzeichnis:

   • Führen Sie unter Linux® und Mac OS die folgenden Befehle aus, um die Datei zu ändern und zu verschieben:

     chmod 755 ./helm-unpacked/<unpacked_dir>/helm
     

     sudo mv ./helm-unpacked/<unpacked_dir>/helm /usr/local/bin/helm
     

   • Benennen Sie unter Windows™ die heruntergeladene Datei in helm um und platzieren Sie die Datei in der Umgebungsvariablen PATH.

5. Löschen Sie das Installationsprogramm und zusätzliche entpackte Archive:

    rm -rf ./helm-unpacked ./<Pfad_zum_Installationsprogramm>
   

Hinweis: Sie können die Helm-CLI auch über die Helm-Community herunterladen. Informationen zur Installationsprozedur finden Sie unter Helm v2.12.3 - Bug Fix Release .

Installation überprüfen

1. Wenn Sie Helm 2.12.3 verwenden, müssen Sie einen Wert für HELM_HOME festlegen:

    export HELM_HOME=~/.helm
   

2. Initialisieren Sie Ihre Helm-CLI. Wichtig: Verwenden Sie das Flag --upgrade nicht mit dem Befehl helm init. Durch das Hinzufügen des Flags --upgrade wird die Serverversion von Helm Tiller ersetzt, die mit IBM Cloud Private installiert wird.

   • Führen Sie für Umgebungen mit Internetzugang den folgenden Befehl aus:

     helm init --client-only
     

   • Führen Sie bei Airgap-Umgebungen den folgenden Befehl aus:

     helm init --client-only --skip-refresh
     

3. Überprüfen Sie, ob die Helm-CLI initialisiert ist. Führen Sie den folgenden Befehl aus:

    helm version --tls
   

   Die Ausgabe ähnelt dem folgenden Inhalt:

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

4. Führen Sie die folgenden Schritte aus, um eine Liste der verfügbaren oder installierten Pakete zu überprüfen:

   1. Fügen Sie ein Helm-Repository hinzu. Führen Sie den folgenden Befehl aus, um das Repository von Kubernetes Incubator hinzuzufügen:

       helm repo add incubator https://kubernetes-charts-incubator.storage.googleapis.com/
      

   2. Zeigen Sie die verfügbaren Diagramme durch Ausführen des folgenden Befehls an:

       helm search -l
      

   3. Installieren Sie ein Diagramm. Führen Sie den folgenden Befehl aus:

       helm install --name=release_name stable/chart_in_repo --tls
      

      In diesem Befehl ist release_name der Name für das Release, das aus dem Diagramm erstellt werden soll, und chart_in_repo der Name des verfügbaren Diagramms, das installiert werden soll. Führen Sie beispielsweise den folgenden Befehl aus, um das WordPress-Diagramm zu installieren:

       helm install --name=my-wordpress stable/wordpress --tls
      

   4. Listen Sie die Releases durch Ausführen des folgenden Befehls auf:

       helm list --tls
      

      Die Ausgabe ähnelt dem folgenden Inhalt:

       NAME                REVISION    UPDATED                     STATUS      CHART              NAMESPACE
       my-wordpress        1           Wed Jun 28 22:15:13 2017    DEPLOYED    wordpress-0.6.5    default
      

   5. Führen Sie den folgenden Befehl aus, um ein Release zu entfernen:

       helm delete release_name --purge --tls
      

      In diesem Befehl ist release_name der Name des Release, das entfernt werden soll. Führen Sie beispielsweise den folgenden Befehl aus, um das WordPress-Release zu entfernen:

       helm delete my-wordpress --purge --tls