In diesem Thema wird die Installation der Tanzu-Befehlszeilenschnittstelle (CLI) auf einer Bootstrap-Maschine erläutert. Die Bootstrap-Maschine ist der Laptop, Host oder Server, über den Sie Verwaltungs- und Arbeitslastcluster bereitstellen und der die Tanzu- und Kubernetes-Konfigurationsdateien für Ihre Bereitstellungen speichert. Die Bootstrap-Maschine ist in der Regel lokal, kann aber auch ein physischer Computer oder eine VM sein, auf die Sie remote zugreifen. Weitere Informationen zur Tanzu CLI, einschließlich einer Befehlsreferenz, finden Sie in der Dokumentation zu VMware Tanzu CLI v1.0.x .
Wenn Sie den vSphere with Tanzu-Supervisor auf vSphere 8 als Verwaltungscluster verwenden, können Sie nach der Installation der Tanzu CLI eine Verbindung mit dem Supervisor herstellen.
HinweisDie Anweisungen in diesem Thema gelten speziell für die Installation der Tanzu CLI zur Verwendung mit einem vSphere with Tanzu Supervisor auf vSphere 8. Wenn Sie die Tanzu CLI installieren, um eigenständige Verwaltungscluster auf vSphere ohne Supervisor, auf AWS oder Azure bereitzustellen, lesen Sie das entsprechende Thema in Bereitstellung und Verwalten von Tanzu Kubernetes Grid 2.3, eigenständige Verwaltungscluster, Installieren der Tanzu CLI und Kubernetes-CLI für die Verwendung mit eigenständigen Verwaltungsclustern.
Die Tanzu CLI kommuniziert mit dem Supervisor, um Arbeitslastcluster in vSphere with Tanzu zu erstellen und zu verwalten.
WichtigDer vSphere with Tanzu-Supervisor in vSphere 8.0.1c oder höher führt TKG v2.2 aus. Frühere Versionen von vSphere 8 führen TKG v2.0 aus, das nicht unabhängig von Supervisor veröffentlicht wurde. Aufgrund der früheren in Supervisor eingebetteten TKG-Version sind einige der Funktionen, die bei Verwendung eines eigenständigen TKG 2.3-Verwaltungsclusters verfügbar sind, nicht verfügbar, wenn Sie einen vSphere with Tanzu Supervisor zum Erstellen von Arbeitslastclustern verwenden. Spätere TKG-Versionen werden in künftigen vSphere-Update-Versionen in Supervisor eingebettet sein. Folglich ist die in die aktuelle Version von vSphere with Tanzu eingebettete Version von TKG zu einem bestimmten Zeitpunkt möglicherweise nicht so aktuell wie die neueste eigenständige Version von TKG. Die Versionen von Tanzu CLI, die mit allen TKG v2.x-Versionen kompatibel sind, werden jedoch für die Verwendung mit Supervisor in allen Versionen von vSphere 8 vollständig unterstützt. Beispielsweise ist Tanzu CLI v1.0.0 vollständig abwärtskompatibel mit den von Supervisor bereitgestellten TKG 2.2-Plug-Ins.
VorsichtDie Versionen der Tanzu CLI, die mit TKG 2.x und mit dem vSphere with Tanzu Supervisor in vSphere 8 kompatibel sind, sind nicht mit dem Supervisor-Cluster in vSphere 7 kompatibel. Um die Tanzu CLI mit einem vSphere with Tanzu Supervisor-Cluster auf vSphere 7 zu verwenden, verwenden Sie die Tanzu CLI-Version von TKG v1.6. Um die Versionen von Tanzu CLI zu verwenden, die mit TKG 2.x mit Supervisor kompatibel sind, führen Sie ein Upgrade auf vSphere 8 durch. Sie können einen eigenständigen TKG 2.x-Verwaltungscluster auf vSphere 7 bereitstellen, wenn der vSphere with Tanzu Supervisor-Cluster nicht vorhanden ist. Informationen zur Kompatibilität zwischen der Tanzu CLI und VMware-Produkten finden Sie in der Tanzu CLI-Dokumentation.
Die Bootstrap-Maschine, auf der Sie die Tanzu CLI für die Verwendung mit Tanzu Kubernetes Grid installieren und ausführen, muss bestimmte Anforderungen erfüllen. Es gibt weitere Anforderungen, je nachdem, ob Sie die Tanzu CLI mit einem vSphere with Tanzu-Supervisor als Verwaltungscluster verwenden oder eigenständige Verwaltungscluster bereitstellen möchten oder beides.
Um die Tanzu CLI mit Tanzu Kubernetes Grid v2.3 auszuführen, benötigen Sie eine Bootstrap-Maschine, auf der Sie die Tanzu CLI installieren und ausführen können. Diese muss über Folgendes verfügen:
Um einen Supervisor-Cluster als Verwaltungscluster zu verwenden, benötigen Sie außerdem Folgendes:
vSphere 8-Konto mit:
Eine der folgenden Bedingungen:
kubectl vsphere
, das auf Ihrer Bootstrap-Maschine wie unter Herunterladen und Installieren der Kubernetes-CLI-Tools für vSphere beschrieben installiert ist.Um die Tanzu CLI für die Verwendung mit Tanzu Kubernetes Grid v2.3 zu installieren, installieren Sie eine kompatible Version der Tanzu Core-CLI und die Tanzu CLI-Plug-Ins für Tanzu Kubernetes Grid v2.3. Von diesen Plug-Ins bereitgestellte Befehle ermöglichen Cluster- und Paketvorgänge. Eine Liste der unterstützten CLI-Versionen finden Sie in der Produkt-Interoperabilitätsmatrix.
Um Tanzu Core-CLI zu installieren, führen Sie die folgenden Schritte aus. Um die Schritte anzuzeigen, klicken Sie auf die Registerkarte Installieren mithilfe eines Paketmanagers (Install using a package manager) oder auf Installieren von einer Binärversion aus (Install from a binary release).
Nachdem Sie die Tanzu Core CLI installiert haben, fahren Sie mit der Installation der Tanzu CLI Plug-Ins für TKG v2.3 fort.
HinweisWenn Sie eine vorhandene Installation der Tanzu CLI beibehalten möchten, verschieben Sie die CLI-Binärdatei von
/usr/local/bin/tanzu
an einen anderen Speicherort, bevor Sie die folgenden Schritte ausführen.
Wählen Sie eine kompatible Version der Tanzu CLI aus. Eine Liste der CLI-Versionen, die mit dieser Version von Tanzu Kubernetes Grid kompatibel sind, finden Sie unter Produkt-Interoperabilitätsmatrix.
Folgen Sie den nachstehenden Anweisungen für Ihren Paketmanager.
APT (Debian oder Ubuntu):
Wenn es sich bei der zu installierenden Version um die neueste verfügbare Version der Tanzu CLI handelt, z. B. v1.0.0
, führen Sie folgenden Befehl aus:
sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install -y tanzu-cli
Wenn Sie eine frühere Version der Tanzu CLI installieren möchten, z. B. v0.90.1
, führen Sie folgenden Befehl aus:
sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install tanzu-cli=0.90.1
Chocolatey (Windows):
Wenn es sich bei der zu installierenden Version um die neueste verfügbare Version der Tanzu CLI handelt, z. B. v1.0.0
, führen Sie folgenden Befehl aus:
choco install tanzu-cli
Wenn Sie eine frühere Version der Tanzu CLI installieren möchten, z. B. v0.90.1
, führen Sie folgenden Befehl aus:
choco install tanzu-cli --version 0.90.1
Homebrew (MacOS):
Wenn es sich bei der zu installierenden Version um die neueste verfügbare Version der Tanzu CLI handelt, z. B. v1.0.0
, führen Sie folgenden Befehl aus:
brew update
brew install vmware-tanzu/tanzu/tanzu-cli
Wenn Sie eine frühere Version der Tanzu CLI installieren möchten, z. B. v0.90.1
, führen Sie folgenden Befehl aus:
brew update
brew tap-new local/tap
brew extract --version=0.90.1 vmware-tanzu/tanzu/tanzu-cli local/tap
brew install [email protected]
YUM oder DNF (RHEL):
Wenn es sich bei der zu installierenden Version um die neueste verfügbare Version der Tanzu CLI handelt, z. B. v1.0.0
, führen Sie folgenden Befehl aus:
cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF
sudo yum install -y tanzu-cli # If you are using DNF, run sudo dnf install -y tanzu-cli.
Wenn Sie eine frühere Version der Tanzu CLI installieren möchten, z. B. v0.90.1
, führen Sie folgenden Befehl aus:
cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF
sudo yum install tanzu-cli-0.90.1 # If you are using DNF, run sudo dnf install tanzu-cli-0.90.1.
Stellen Sie sicher, dass die richtige Version der CLI ordnungsgemäß installiert ist. Beispiel:
tanzu version
version: v1.0.0
...
So laden Sie eine Binärversion von Tanzu CLI von Customer Connect herunter und installieren sie anschließend:
Herunterladen und Entpacken der Tanzu CLI-Binärdatei:
Entpacken Sie die Tanzu CLI-Datei für Ihr Betriebssystem. Verwenden Sie zum Entpacken der Datei ein Extraktionstool Ihrer Wahl. Unter Linux oder macOS können Sie beispielsweise den Befehl tar
verwenden.
macOS:
tar -xvf tanzu-cli-darwin-amd64.tar.gz
Linux:
tar -xvf tanzu-cli-linux-amd64.tar.gz
Windows:
Verwenden Sie das Windows-Extraktionstool, um tanzu-cli-windows-amd64.zip
zu entpacken.
Stellen Sie die CLI für das System zur Verfügung:
macOS:
Installieren Sie die Binärdatei in /usr/local/bin
:
install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
Linux:
Installieren Sie die Binärdatei in /usr/local/bin
:
sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
Windows:
Program Files\tanzu
.tanzu-cli-windows_amd64.exe
in den neuen Ordner Program Files\tanzu
.tanzu-cli-windows_amd64.exe
in tanzu.exe
um.tanzu
, wählen Sie Eigenschaften (Properties) > Sicherheit (Security) aus und stellen Sie sicher, dass Ihr Benutzerkonto über die Berechtigung Vollständige Kontrolle (Full Control) verfügt.env
zu suchen.Path
unter Systemvariablen (System variables) aus und klicken Sie auf Bearbeiten (Edit).tanzu
-CLI ein. Der Pfadwert darf die Erweiterung .exe
nicht enthalten. Zum Beispiel: C:\Program Files\tanzu
.Stellen Sie sicher, dass die richtige Version der CLI ordnungsgemäß installiert ist. Beispiel:
tanzu version
version: v1.0.0
...
Um die Tanzu CLI von einer Binärversion auf GitHub herunterzuladen und zu installieren, folgen Sie den Anweisungen im Abschnitt Von Binärversionen im GitHub-Projekt unter Installieren der Tanzu CLI.
So installieren Sie die eigenständigen Tanzu CLI-Plug-Ins für Tanzu Kubernetes Grid v2.3:
Listen Sie die eigenständigen Tanzu CLI-Plug-Ins für Tanzu Kubernetes Grid v2.3 auf:
tanzu plugin group get vmware-tkg/default:v2.3.1
Die Ausgabe ähnelt der folgenden:
Plugins in Group: vmware-tkg/tkg:v2.3.1
NAME TARGET VERSION
isolated-cluster global v0.30.2
management-cluster kubernetes v0.30.2
package kubernetes v0.30.2
pinniped-auth global v0.30.2
secret kubernetes v0.30.2
telemetry kubernetes v0.30.2
Führen Sie folgenden Befehl aus, um alle verfügbaren Versionen für die Plug-In-Gruppe vmware-tkg/default
aufzulisten:
tanzu plugin group search -n vmware-tkg/default --show-details
Installieren Sie die eigenständigen Plug-Ins für Tanzu Kubernetes Grid v2.3:
tanzu plugin install --group vmware-tkg/default:v2.3.1
Stellen Sie sicher, dass die Plug-Ins erfolgreich installiert wurden:
tanzu plugin list
Jeder Plug-In-Name und jede Plug-In-Version, die von tanzu plugin group get vmware-tkg/default:v2.3.1
zurückgegeben werden, müssen in der Ausgabe von tanzu plugin list
enthalten sein.
HinweisNachdem Sie die Tanzu CLI und die eigenständigen Plug-Ins für Tanzu Kubernetes Grid installiert haben, aber bevor Sie sie zur Verbindung mit einem Verwaltungscluster verwendet haben, sind alle kontextspezifischen CLI-Befehlsgruppen, wie z. B.
tanzu cluster
undtanzu kubernetes-release
, nicht verfügbar und nicht in der Tanzu CLI-Ausgabe--help
enthalten. Die Tanzu CLI installiert automatisch kontextbezogene Plug-Ins, wenn Sie eine Verbindung mit einem Verwaltungscluster herstellen. Weitere Informationen zu Tanzu CLI-Plug-Ins und deren Installation finden Sie unter Installieren von Tanzu CLI-Plug-Ins.
Laden Sie die Kubernetes-CLI kubectl
auf Ihre Bootstrap-Maschine herunter, entpacken Sie sie und stellen Sie sie dann Ihrem System zur Verfügung:
Navigieren Sie zu VMware Customer Connect und melden Sie sich mit Ihren Anmeldedaten für VMware Customer Connect an.
Navigieren Sie zu Produktdownloads von Tanzu Kubernetes Grid v2.3.1.
Scrollen Sie zum Abschnitt mit der Bezeichnung Kubectl 1.26.8 for VMware Tanzu Kubernetes Grid 2.3.1.
(Optional) Stellen Sie sicher, dass die heruntergeladenen Dateien die unveränderten Originaldateien sind. VMware stellt für jeden Download eine SHA-1-, eine SHA-256- und eine MD5-Prüfsumme bereit. Um diese Prüfsummen zu erhalten, klicken Sie unter dem Eintrag, den Sie herunterladen möchten, auf Weitere Informationen (Read More). Weitere Informationen finden Sie unter Verwenden kryptografischer Hashes.
Verwenden Sie zum Entpacken der Binärdatei kubectl
für Ihr Betriebssystem das Extraktionstool Ihrer Wahl. Beispiel: den Befehl gunzip
.
gunzip kubectl-mac-v1.26.8+vmware.2.gz
gunzip kubectl-linux-v1.26.8+vmware.2.gz
kubectl-windows-v1.26.8+vmware.2.exe.gz
zu entpacken.
Stellen Sie die CLI für das System zur Verfügung:
Ändern Sie die heruntergeladene Datei so, dass sie ausführbar ist:
chmod ugo+x kubectl-mac-v1.26.8+vmware.2
Installieren Sie die Binärdatei in /usr/local/bin
:
sudo install kubectl-mac-v1.26.8+vmware.2 /usr/local/bin/kubectl
Führen Sie kubectl version
aus, um zu überprüfen, ob die korrekte Version von kubectl
installiert und ausführbar ist.
kubectl version
Ändern Sie die heruntergeladene Datei so, dass sie ausführbar ist:
chmod ugo+x kubectl-linux-v1.26.8+vmware.2
Installieren Sie die Binärdatei in /usr/local/bin
:
sudo install kubectl-linux-v1.26.8+vmware.2 /usr/local/bin/kubectl
Führen Sie kubectl version
aus, um zu überprüfen, ob die korrekte Version von kubectl
installiert und ausführbar ist.
kubectl version
Program Files\kubectl
.kubectl-windows-v1.26.8+vmware.2.exe
und kopieren Sie sie in den neuen Ordner Program Files\kubectl
.kubectl-windows-v1.26.8+vmware.2.exe
in kubectl.exe
um.kubectl
, wählen Sie Eigenschaften (Properties) > Sicherheit (Security) aus und stellen Sie sicher, dass Ihr Benutzerkonto über die Berechtigung Vollständige Kontrolle (Full Control) verfügt.env
zu suchen.Path
unter Systemvariablen (System variables) aus und klicken Sie auf Bearbeiten (Edit).kubectl
-CLI ein.Führen Sie kubectl version
aus, um zu überprüfen, ob die korrekte CLI-Version ordnungsgemäß installiert ist.
kubectl version
Bevor Sie die Tools Tanzu CLI und kubectl
zum Bereitstellen von Arbeitslastclustern und Dienstpaketen in Tanzu Kubernetes Grid verwenden können, verbinden Sie die Tanzu CLI mit dem Supervisor wie unten beschrieben.
Gehen Sie wie folgt vor, um die Tanzu CLI mit dem Supervisor zu verbinden:
Rufen Sie die IP-Adresse des Supervisor von vCenter ab:
https://192.168.123.3
Kein IDP: Wenn Sie keinen externen Identitätsanbieter verwenden:
(Optional) Konfigurieren Sie das Plug-In kubectl vsphere
mit einem vertrauenswürdigen Zertifikat, wie unter Konfigurieren von sicherer Anmeldung für vSphere with Tanzu-Cluster beschrieben.
Führen Sie kubectl vsphere login
aus, um sich bei vSphere anzumelden. Weitere Informationen zu diesem Schritt finden Sie unter Verbinden mit Supervisor als vCenter Single Sign-On-Benutzer mit Kubectl.
kubectl vsphere login --vsphere-username VSPHERE-USERNAME --server=SUPERVISOR-IP
Dabei ist VSPHERE-USERNAME
der Benutzername Ihres vCenter Single Sign-On-Kontos (SSO), z. B. [email protected]
, und SUPERVISOR-IP
die oben erhaltene Supervisor-IP-Adresse.
Wenn Sie das Plug-In kubectl vsphere
nicht mit einem vertrauenswürdigen Zertifikat konfiguriert haben, können Sie sich unsicher anmelden, indem Sie --insecure-skip-tls-verify=true
an den obigen Befehl anhängen.
VorsichtVerwenden Sie unsichere Anmeldung nur in einer Entwicklungsumgebung.
Geben Sie das Kennwort ein, das Sie für die Anmeldung bei vCenter verwenden.
Wenn Sie sich erfolgreich angemeldet haben, führt der Befehl kubectl vsphere login
Folgendes aus:
kubeconfig
-Datei, um ein Token hinzuzufügen, das sich bei der Kubernetes-API authentifiziertLegen Sie den Kontext von kubectl
auf den Supervisor fest.
kubectl config use-context SUPERVISOR-IP
Dabei ist SUPERVISOR-IP
der Kontext des Supervisors. Weitere Informationen finden Sie in vSphere with Tanzu-Dienste und -Arbeitslasten unter Abrufen und Verwenden des Supervisor-Kontexts.
Erfassen Sie Informationen, um den Befehl tanzu context create
auszuführen, der eine Verbindung mit dem Supervisor herstellt:
kubeconfig
-Datei, die standardmäßig ~/.kube/config
lautet und von der Umgebungsvariable KUBECONFIG
festgelegt wird.Führen Sie den Befehl tanzu context create
aus und übergeben Sie die obigen Werte, z. B.:
Kein IDP:
tanzu context create my-supervisor --kubeconfig ~/.kube/config --kubecontext 192.168.123.3
Dadurch wird der Supervisor-Kontext bei der Tanzu CLI registriert, und die Supervisor-spezifischen Plug-Ins werden heruntergeladen.
[ok] successfully logged in to management cluster using the kubeconfig my-supervisor
[i] Checking for required plugins...
[i] Installing plugin 'cluster:v0.29' with target 'kubernetes'
[i] Plugin binary for 'cluster:v0.29' found in cache
[i] Installing plugin 'feature:v0.29' with target 'kubernetes'
[i] Plugin binary for 'feature:v0.29' found in cache
[i] Installing plugin 'kubernetes-release:v0.29' with target 'kubernetes'
[i] Plugin binary for 'kubernetes-release:v0.29' found in cache
[i] Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
[i] Plugin binary for 'namespaces:v1.0.0' found in cache
[i] Successfully installed all required plugins
Mit einem IDP:
tanzu context create --endpoint https://10.73.27.32 --name oidc-user
tanzu context use https://10.73.27.32 oidc-user
Detected a vSphere Supervisor being used
Log in by visiting this link:
...
https://10.27.62.33/wcp/pinniped/oauth2/authorize?..
...
Optionally, paste your authorization code: G2TcS145Q4e6A1YKf743n3BJlfQAQ_UdjXy38TtEEIo.ju4QV3PTsUvOigVUtQllZ7AJFU0YnjuLHTRVoNxvdZc
...
??? successfully logged in to management cluster using the kubeconfig oidc-user
Checking for required plugins...
All required plugins are already installed and up-to-date
Im obigen Beispiel ist https://10.73.27.32
die IP-Adresse der Steuerungsebene für den Supervisor. Weitere Informationen zu diesem Schritt finden Sie unter Verbinden mit dem Supervisor mithilfe der Tanzu CLI und eines externen IDP.
Stellen Sie sicher, dass der Supervisor hinzugefügt wurde, indem Sie tanzu context list
ausführen. Beispiel:
tanzu context list
NAME ISACTIVE ENDPOINT KUBECONFIGPATH KUBECONTEXT
my-supervisor true https://192.168.123.3:443 /home/vmware/.kube/config 192.168.123.3
tanzu context use
sollte jetzt den Supervisor mit dem von Ihnen angegebenen Namen auflisten:
tanzu context use
? Select a server [Use arrows to move, type to filter]
> my-supervisor ()
+ new server
Führen Sie tanzu plugin list
aus, um die Liste der Supervisor-spezifischen Plug-Ins sowie die eigenständigen CLI-Plug-Ins anzuzeigen.
tanzu plugin list
Standalone Plugins
NAME DESCRIPTION TARGET VERSION STATUS
isolated-cluster Prepopulating images/bundle for internet-restricted environments global v0.30.2 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) global v0.30.2 installed
management-cluster Kubernetes management cluster operations kubernetes v0.30.2 installed
package Tanzu package management kubernetes v0.30.2 installed
secret Tanzu secret management kubernetes v0.30.2 installed
telemetry Configure cluster-wide settings for vmware tanzu telemetry kubernetes v0.30.2 installed
Plugins from Context: my-supervisor
NAME DESCRIPTION TARGET VERSION STATUS
cluster Kubernetes cluster operations kubernetes v0.29.0 installed
feature Operate on features and featuregates kubernetes v0.29.0 installed
kubernetes-release Kubernetes release operations kubernetes v0.29.0 installed
namespaces Discover vSphere Supervisor namespaces you have access to kubernetes v1.0.0 installed
HinweisMit vSphere 8.0.1c haben Plug-Ins für den Supervisor-Kontext Version v0.29.0.