Installieren und Verwalten von Paketen

In diesem Thema wird die Installation und Verwaltung von Paketen und Paketrepositorys mithilfe der Tanzu CLI beschrieben.

Hinweis
Das tanzu package-CLI-Plug-In ist nur für CLI-verwaltete Pakete vorgesehen. Verwenden Sie die in diesem Thema bereitgestellten Befehle nicht zum Installieren und Verwalten automatisch verwalteter Pakete. Ihr Lebenszyklus wird automatisch von Tanzu Kubernetes Grid verwaltet. Weitere Informationen zu automatisch verwalteten Paketen finden Sie unter Automatisch verwaltete Pakete.

Vorbereiten der Installation CLI-verwalteter Pakete

Vor der Installation CLI-verwalteter Pakete aus dem standard-Paketrepository:

Installieren der Tanzu CLI.
Hinzufügen des tanzu-standard-Paketrepositorys. Wenn Sie einen planbasierten Cluster (Legacy) als Ziel verwenden, überspringen Sie diesen Schritt. Für planbasierte Cluster wird das tanzu-standard-Paket-Repository automatisch in jedem Cluster im Namespace tanzu-package-repo-global aktiviert.
Überprüfen Sie die Inhalte des Tanzu-Standardrepositorys.
Installieren von cert-manager für die Zertifikatsverwaltung in Arbeitslastclustern.

Übersicht über die Installation

Anweisungen zum Installieren und Verwalten von Paketen mithilfe der Tanzu CLI finden Sie in den folgenden Abschnitten.

Paketrepositorys: In diesem Abschnitt erhalten Sie Informationen zum Durchführen folgender Aufgaben:
- Auflisten aller Paketrepositorys, die dem Zielcluster zur Verfügung stehen oder dem Zielcluster hinzugefügt wurden
- Abrufen der Details eines verfügbaren oder hinzugefügten Paketrepositorys
- Hinzufügen, Aktualisieren oder Löschen eines Paketrepositorys
Pakete: In diesem Abschnitt erhalten Sie Informationen zum Durchführen folgender Aufgaben:
- Auflisten aller Pakete, die dem Zielcluster zur Verfügung stehen oder im Zielcluster installiert wurden
- Abrufen der Details eines verfügbaren oder installierten Pakets
- Installieren, Aktualisieren oder Löschen eines Pakets

Weitere Informationen zu tanzu package-Befehlen finden Sie unter tanzu-Paket.

Paket-Namespaces und System-Namespaces

Sie installieren Paketrepositorys und Pakete im gewünschten Namespace. Wenn Sie die Option --namespace nicht festlegen, verwendet die Tanzu CLI den Namespace default.

Die Komponenten der Paketdienste werden in einem System-Namespace ausgeführt, der vom Bereitstellungsort der Pakete selbst getrennt ist. Beispielsweise werden Contour- und Envoy-Komponenten im Namespace tanzu-system-ingress und Harbor-Komponenten in tanzu-system-registry ausgeführt.

Installieren Sie keine Pakete in einem beliebigen tanzu-system--Namespace.

Paketrepositorys

In den folgenden Abschnitten wird das Auflisten, Hinzufügen, Aktualisieren und Löschen von Paketrepositorys beschrieben.

Auflisten von Paketrepositorys

Mit dem Befehl tanzu package repository list werden alle Paketrepositorys aufgelistet, die im Zielcluster verfügbar sind. Diese Liste enthält Paketrepositorys, die dem Zielcluster durch Ausführen des Befehls tanzu package repository add hinzugefügt wurden. Informationen zum Hinzufügen eines Paketrepositorys zu Ihrem Cluster finden Sie im Folgenden unter Hinzufügen eines Paketrepositorys.

Führen Sie folgenden Befehl aus, um Paketrepositorys für alle Namespaces im Zielcluster aufzulisten:
```
tanzu package repository list -A
```
Führen Sie folgenden Befehl aus, um Paketrepositorys in einem spezifischen Namespace aufzulisten:
```
tanzu package repository list -n NAMESPACE
```
Dabei gilt: NAMESPACE ist der Name des Ziel-Namespace. Die Option --namespace oder -n ist erforderlich, wenn Sie Paketrepositorys in einem anderen Namespace als default auflisten möchten.

Zum Auflisten von Paketrepositorys im Namespace default können Sie auch folgenden Befehl ausführen:
```
tanzu package repository list
```

Abrufen der Details eines Paketrepositorys

Mit dem Befehl tanzu package repository get werden die Details eines Paketrepositorys abgerufen.

Führen Sie folgenden Befehl aus, um die Details eines Paketrepositorys abzurufen:

tanzu package repository get REPOSITORY-NAME -n REPOSITORY-NAMESPACE

Dabei gilt:

REPOSITORY-NAME ist der Name des Paketrepositorys im Zielcluster.
REPOSITORY-NAMESPACE ist der Namespace des Paketrepositorys im Zielcluster.

Hinzufügen eines Paketrepositorys

Mit dem Befehl tanzu package repository add wird ein Paketrepository hinzugefügt.

Führen Sie folgenden Befehl aus, um dem Zielcluster ein Paketrepository hinzuzufügen:

tanzu package repository add REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

Dabei gilt:

REPOSITORY-NAME ist ein Name, den Sie für das Paketrepository auswählen.
REPOSITORY-URL ist die OCI-Registrierungs-URL des Paketrepositorys.
- Informationen zum Abrufen dieses Werts über die Tanzu CLI finden Sie unter Listen von Paketrepositorys oder in Tanzu Mission Control in der Liste Add-Ons (Addons) > Repositorys (Repositories) im Fensterbereich Cluster.
- Wenn Sie ein Paketrepository-Tag am Ende der URL weglassen, verwendet das System das Tag der aktuellen Tanzu Kubernetes Grid-Version.
- Diese URL kann nicht unter projects.registry.vmware.com/tce sein.
REPOSITORY-NAMESPACE ist der Ziel-Namespace für das Paketrepository. Wenn diese Option nicht angegeben ist, fügt die Tanzu CLI das Paketrepository zum Namespace default hinzu.

Fügen Sie beispielsweise das Paketrepository standard mit CLI-verwalteten Paketen hinzu, die sich im Lieferumfang von Tanzu Kubernetes Grid befinden. Der Ziel---namespace für das Paketrepository standard ist tkg-system.

Hinweis
Wenn Sie einen planbasierten Cluster (Legacy) als Ziel verwenden, überspringen Sie diesen Schritt. Für planbasierte Cluster wird das tanzu-standard-Paket-Repository automatisch in jedem Cluster im Namespace tanzu-package-repo-global aktiviert.

tanzu package repository add tanzu-standard --url projects.registry.vmware.com/tkg/packages/standard/repo:v2.1.1 --namespace tkg-system

Aktualisieren eines Paketrepositorys

Mit dem Befehl tanzu package repository update wird ein Paketrepository mit einer neuen Version aktualisiert, die unter einer URL veröffentlicht wurde.

Führen Sie folgenden Befehl aus, um ein Paketrepository im Zielcluster zu aktualisieren:

tanzu package repository update REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

Dabei gilt:

REPOSITORY-NAME ist der Name des Paketrepositorys im Cluster.
REPOSITORY-URL ist die neue URL des Paketrepositorys. Wenn Sie kein Paketrepository-Tag in der URL angeben, verwendet das System das Paketrepository-Tag aus der aktuellen Tanzu Kubernetes Grid-Version.
REPOSITORY-NAMESPACE ist der Namespace des Paketrepositorys im Cluster.

Löschen eines Paketrepositorys

Mit dem Befehl tanzu package repository delete wird ein Paketrepository entfernt. Führen Sie folgenden Befehl aus, um ein Paketrepository aus dem Zielcluster zu löschen:

tanzu package repository delete REPOSITORY-NAME -n REPOSITORY-NAMESPACE

Dabei gilt:

REPOSITORY-NAME ist der Name des Paketrepositorys.
REPOSITORY-NAMESPACE ist der Namespace des Paketrepositorys.

Pakete

In den folgenden Abschnitten wird das Auflisten, Installieren, Aktualisieren und Löschen von Paketen beschrieben.

Auflisten verfügbarer Pakete

Mit dem Befehl tanzu package available list werden alle verfügbaren Pakete und Paketversionen aufgelistet.

Auflisten verfügbarer Pakete:

Führen Sie folgenden Befehl aus, um verfügbare Pakete für alle Namespaces im Zielcluster aufzulisten:
```
tanzu package available list -A
```
Führen Sie folgenden Befehl aus, um verfügbare Pakete in einem spezifischen Namespace aufzulisten:
```
tanzu package available list -n NAMESPACE
```
Dabei gilt: NAMESPACE ist der Namespace, aus dem die Liste der verfügbaren Pakete abgerufen werden soll. Zum Auflisten verfügbarer Pakete im Namespace default können Sie auch folgenden Befehl ausführen:
```
tanzu package available list
```

Auflisten verfügbarer Paketversionen:

Führen Sie folgenden Befehl aus, um verfügbare Paketversionen für ein Paket in allen Namespaces im Zielcluster aufzulisten:
```
tanzu package available list AVAILABLE-PACKAGE-NAME -A
```
Dabei gilt: AVAILABLE-PACKAGE-NAME ist der Paketname, den Sie mithilfe des Befehls tanzu package available list abgerufen haben.
Führen Sie folgenden Befehl aus, um verfügbare Paketversionen für ein Paket in einem spezifischen Namespace aufzulisten:
```
tanzu package available list AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE
```
Dabei gilt:
- AVAILABLE-PACKAGE-NAME ist der Paketname, den Sie mithilfe des Befehls tanzu package available list abgerufen haben.
- AVAILABLE-PACKAGE-NAMESPACE ist der Namespace des verfügbaren Pakets.
Zum Auflisten verfügbarer Paketversionen für ein Paket im Namespace default können Sie auch folgenden Befehl ausführen:
```
tanzu package available list AVAILABLE-PACKAGE-NAME
```

Abrufen der Details eines verfügbaren Pakets

Mit dem Befehl tanzu package available get werden die Details eines verfügbaren Pakets abgerufen.

Führen Sie folgenden Befehl aus, um die Details eines verfügbaren Pakets abzurufen:

tanzu package available get AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE

Oder:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE

Dabei gilt:

AVAILABLE-PACKAGE-NAME ist der Name des verfügbaren Pakets. Sie können diesen Namen abrufen, indem Sie den Befehl tanzu package available list ausführen.
AVAILABLE-PACKAGE-VERSION ist die Version des verfügbaren Pakets. Sie können die Liste der verfügbaren Paketversionen abrufen, indem Sie den Befehl tanzu package available list AVAILABLE-PACKAGE-NAME ausführen.
AVAILABLE-PACKAGE-NAMESPACE ist der Namespace des verfügbaren Pakets.

Um die Standardkonfiguration eines verfügbaren Pakets abzurufen, verwenden Sie das Flag --default-values-file-output des Befehls tanzu package available get:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --default-values-file-output FILE-PATH

Verwenden Sie zum Abrufen des Werteschemas für ein verfügbares Paket, einschließlich des Standardwerts für jeden Schlüssel, das Flag --values-schema des Befehls tanzu package available get. Auf diese Weise wird der Abschnitt valuesSchema aus der Kubernetes-API-Ressource Package für das verfügbare Paket abgerufen. Sie können das Ausgabeformat -o für das Werteschema auf yaml, json oder table festlegen.

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --values-schema

Auflisten installierter Pakete

Mit dem Befehl tanzu package installed list werden alle Pakete aufgelistet, die aktuell im Zielcluster installiert sind.

Führen Sie folgenden Befehl aus, um installierte Pakete für alle Namespaces in einem Cluster aufzulisten:

tanzu package installed list -A

Führen Sie folgenden Befehl aus, um installierte Pakete in einem spezifischen Namespace aufzulisten:

tanzu package installed list -n NAMESPACE

Dabei gilt: NAMESPACE ist der Namespace, aus dem die Liste der installierten Pakete abgerufen werden soll.

Abrufen der Details eines installierten Pakets

Mit dem Befehl tanzu package installed get werden die Details eines installierten Pakets abgerufen.

Führen Sie folgenden Befehl aus, um die Details eines installierten Pakets abzurufen:

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

Dabei gilt:

INSTALLED-PACKAGE-NAME ist der Name des installierten Pakets.
INSTALLED-PACKAGE-NAMESPACE ist der Namespace, in dem das Paket installiert ist.

Wenn Sie die aktuelle Konfiguration eines installierten Pakets in einer Datei speichern möchten, führen Sie folgenden Befehl aus:

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE --values-file-output FILE-PATH

Dabei gilt: FILE-PATH ist der Pfad der Datei. Beispiel: values.yaml.

Installieren eines Pakets

Mit dem Befehl tanzu package install wird ein CLI-verwaltetes Paket installiert.

So installieren Sie ein CLI-verwaltetes Paket im Zielcluster:

Fügen Sie gegebenenfalls das Paketrepository hinzu, das das Paket enthält. Weitere Informationen finden Sie oben unter Hinzufügen eines Paketrepositorys.
Notieren Sie sich den Namen und die Version des zu installierenden Pakets. Führen Sie zum Anzeigen des Namens und der Version des Pakets den Befehl tanzu package available list aus. Weitere Informationen finden Sie oben unter Auflisten verfügbarer Pakete.
Installieren des Pakets:
```
tanzu package install PACKAGE-NAME -p AVAILABLE-PACKAGE-NAME -v AVAILABLE-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n TARGET-NAMESPACE
```
Dabei gilt:
- PACKAGE-NAME ist ein von Ihnen ausgewählter Name für das Paket.
- AVAILABLE-PACKAGE-NAME ist der Paketname, den Sie oben notiert haben.
- AVAILABLE-PACKAGE-VERSION ist die Paketversion, die Sie oben notiert haben.
- PACKAGE-CONFIGURATION-FILE ist die Konfigurationsdatei, die Sie für das Paket vorbereitet haben. Wenn diese Option nicht festgelegt ist, wird das Paket mit der Standardkonfiguration installiert.
- TARGET-NAMESPACE ist der Namespace, in dem das Paket (PackageInstall), die Paketanwendung (App) und alle anderen Kubernetes-Ressourcen installiert werden sollen, die das Paket beschreiben. Beispielsweise der Namespace my-packages oder tanzu-cli-managed-packages.
  - Wenn das Flag -n nicht angegeben ist, verwendet die Tanzu CLI den Namespace default. Installieren Sie die Inhalte des Pakets, wie z. B. Pods und Dienste, nicht in diesem Namespace. Der Namespace für die Paketinhalte wird separat in der Paketkonfiguration festgelegt.
  - Der angegebene Namespace muss bereits vorhanden sein, wie z. B. durch die Ausführung von kubectl create namespace my-packages.
Zum Anzeigen der vollständigen Liste der unterstützten Flags für diesen Befehl verwenden Sie die Option --help.
Führen Sie den Befehl tanzu package installed list aus, um die Installation des Pakets zu bestätigen. Weitere Informationen finden Sie oben unter Auflisten installierter Pakete.

Aktualisieren eines Pakets

Mit dem Befehl tanzu package installed update werden die Version und Konfiguration eines CLI-verwalteten Pakets aktualisiert.

Vor dem Update der Version eines CLI-verwalteten Pakets aktualisieren Sie in der Regel das zugehörige Repository gemäß der Beschreibung unter Aktualisieren eines Paketrepositorys.

Führen Sie folgenden Befehl aus, um sowohl die Version als auch die Konfiguration eines CLI-verwalteten Pakets zu aktualisieren:

tanzu package installed update INSTALLED-PACKAGE-NAME -v TARGET-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n INSTALLED-PACKAGE-NAMESPACE

Dabei gilt:

INSTALLED-PACKAGE-NAME ist der Name, den Sie für das Paket ausgewählt haben. Zum Anzeigen des Paketnamens können Sie den Befehl tanzu package installed list ausführen. Weitere Informationen finden Sie unter Auflisten installierter Pakete.
(Optional) TARGET-PACKAGE-VERSION ist die Version, auf die das Paket aktualisiert werden soll. Nicht erforderlich, wenn Sie die Paketkonfiguration und nicht die Version aktualisieren.
(Optional) PACKAGE-CONFIGURATION-FILE ist der Pfad der Datei .yaml, die die aktualisierte Paketkonfiguration enthält. Nicht erforderlich, wenn Sie die Paketversion und nicht die Konfiguration aktualisieren. Informationen zum Abrufen der aktuellen Konfiguration finden Sie unter Abrufen der Details eines installierten Pakets.
INSTALLED-PACKAGE-NAMESPACE ist der Namespace, in dem das Paket installiert ist.

Hinweis
Bei Arbeitslastclustern, für die ein Upgrade von TKG v2.1.0 auf v2.1.1 durchgeführt wird, kann für die Aktualisierung der cert-manager-, external-dns- und grafana-Konfigurationen ein Upgrade der Paketversion erforderlich sein, wie in der Liste „Bekannte Probleme“ unter Konfigurations-Update erfordert ein Upgrade für einige Pakete beschrieben.

Löschen eines Pakets

Mit dem Befehl tanzu package installed delete wird ein CLI-verwaltetes Paket gelöscht.

Um ein CLI-verwaltetes Paket aus dem Zielcluster zu löschen, führen Sie folgenden Befehl aus:

tanzu package installed delete INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

Dabei gilt:

INSTALLED-PACKAGE-NAME ist der Name des zu löschenden Pakets. Zum Anzeigen des Paketnamens können Sie den Befehl tanzu package installed list ausführen. Weitere Informationen finden Sie unter Auflisten installierter Pakete.
INSTALLED-PACKAGE-NAMESPACE ist der Namespace, in dem das Paket installiert ist. Wenn Sie keinen Namespace angeben, wird der Namespace, default verwendet.

Anwenden von Overlays auf Pakete

Sie können Overlays vom Typ ytt verwenden, um CLI-verwaltete Pakete anzupassen.