Dieses Dokument wurde mithilfe automatisierter maschineller Übersetzungstechnologie übersetzt. Wir bemühen uns um korrekte Übersetzungen, übernehmen jedoch keine Gewähr für die Vollständigkeit, Richtigkeit oder Zuverlässigkeit der übersetzten Inhalte. Im Falle von Abweichungen ist die englische Originalversion maßgebend und stellt den verbindlichen Text dar.

SUSE Rancher Prime CLI

Die Rancher CLI (Kommandozeilenschnittstelle) ist ein einheitliches Tool, mit dem Sie mit Rancher interagieren können. Mit diesem Tool können Sie Rancher über die Befehlszeile anstelle der GUI bedienen.

Laden Sie die Rancher CLI herunter

Die Binärdatei kann direkt über die Benutzeroberfläche heruntergeladen werden.

Klicken Sie oben links auf ☰.
Klicken Sie unten im Navigationsseitenleistenmenü auf Über.
Unter dem Abschnitt CLI-Downloads finden Sie Links zum Herunterladen der Binärdateien für Windows, Mac und Linux. Sie können auch die Release-Seite für unsere CLI überprüfen, um die Binärdatei direkt herunterzuladen.

Anforderungen

Nachdem Sie die Rancher CLI heruntergeladen haben, müssen Sie einige Konfigurationen vornehmen. Die Rancher CLI benötigt:

Ihre Rancher Server-URL, die verwendet wird, um eine Verbindung zum Rancher Server herzustellen.
Ein API-Bearer-Token, das zur Authentifizierung bei Rancher verwendet wird. Für weitere Informationen zum Erhalten eines Bearer-Tokens siehe rancher-admin/users/settings/api-keys.adoc[Erstellen eines API-Schlüssels].

CLI-Authentifizierung

Bevor Sie die Rancher CLI zur Steuerung Ihres Rancher Servers verwenden können, müssen Sie sich mit einem API-Bearer-Token authentifizieren. Melden Sie sich mit dem folgenden Befehl an (ersetzen Sie <BEARER_TOKEN> und <SERVER_URL> durch Ihre Informationen):

$ ./rancher login https://<SERVER_URL> --token <BEARER_TOKEN>

Wenn der Rancher Server ein selbstsigniertes Zertifikat verwendet, fordert die Rancher CLI Sie auf, mit der Verbindung fortzufahren.

Projektauswahl

Bevor Sie Befehle ausführen können, müssen Sie ein Rancher-Projekt auswählen, gegen das Sie diese Befehle ausführen können. Um ein Projekt auszuwählen, an dem Sie arbeiten möchten, verwenden Sie den Befehl ./rancher context switch. Wenn Sie diesen Befehl eingeben, wird eine Liste der verfügbaren Projekte angezeigt. Geben Sie eine Nummer ein, um Ihr Projekt auszuwählen.

Beispiel: ./rancher context switch Ausgabe

User:rancher-cli-directory user$ ./rancher context switch
NUMBER    CLUSTER NAME   PROJECT ID              PROJECT NAME
1         cluster-2      c-7q96s:p-h4tmb         project-2
2         cluster-2      c-7q96s:project-j6z6d   Default
3         cluster-1      c-lchzv:p-xbpdt         project-1
4         cluster-1      c-lchzv:project-s2mch   Default
Select a Project:

Nachdem Sie eine Nummer eingegeben haben, zeigt die Konsole eine Nachricht an, dass Sie das Projekt gewechselt haben.

INFO[0005] Setting new context to project project-1
INFO[0005] Saving config to /Users/markbishop/.ranchcli2.json

Stellen Sie sicher, dass Sie rancher kubectl get pods erfolgreich ausführen können.

Befehle

Die folgenden Befehle stehen zur Verwendung in Rancher CLI zur Verfügung.

Kommando Ergebnis

Kommando	Ergebnis
`clusters, [cluster]`	Führt Operationen an Ihren Cluster durch.
`context`	Wechselt zwischen Rancher Projekten. Für ein Beispiel siehe Projektauswahl.
`inspect [OPTIONS] [RESOURCEID RESOURCENAME]`	Zeigt Details zu Kubernetes-Ressourcen oder Rancher-Ressourcen (d.h.: Projekte und Workloads) an. Geben Sie Ressourcen nach Name oder ID an.
`kubectl`	Führt kubectl-Befehle aus.
`login, [l]`	Meldet sich bei einem Rancher-Server an. Für ein Beispiel siehe CLI-Authentifizierung.
`machines, [machine]`	Führt Operationen an Maschinen durch.
`namespaces, [namespace]`	Führt Operationen an Namespaces durch.
`nodes, [node]`	Führt Operationen an Knoten durch.
`projects, [project]`	Führt Operationen an Projekten durch.
`ps`	Zeigt Workloads in einem Projekt an.
`server`	Führt Operationen für den Server aus.
`settings, [setting]`	Zeigt die aktuellen Einstellungen für Ihren Rancher-Server an.
`ssh`	Stellt eine Verbindung zu einem Ihrer Cluster-Knoten über das SSH-Protokoll her.
`up`	Wendet die Compose-Konfiguration an.
`wait`	Wartet auf Ressourcen: Cluster, App, Projekt, MultiClusterApp.
`token`	Authentifiziert und generiert ein neues kubeconfig-Token.
`help, [h]`	Zeigt eine Liste von Befehlen oder Hilfe für einen Befehl an.

clusters, [cluster]

Führt Operationen an Ihren Cluster durch.

context

Wechselt zwischen Rancher Projekten. Für ein Beispiel siehe Projektauswahl.

inspect [OPTIONS] [RESOURCEID RESOURCENAME]

Zeigt Details zu Kubernetes-Ressourcen oder Rancher-Ressourcen (d.h.: Projekte und Workloads) an. Geben Sie Ressourcen nach Name oder ID an.

kubectl

Führt kubectl-Befehle aus.

login, [l]

Meldet sich bei einem Rancher-Server an. Für ein Beispiel siehe CLI-Authentifizierung.

machines, [machine]

Führt Operationen an Maschinen durch.

namespaces, [namespace]

Führt Operationen an Namespaces durch.

nodes, [node]

Führt Operationen an Knoten durch.

projects, [project]

Führt Operationen an Projekten durch.

ps

Zeigt Workloads in einem Projekt an.

server

Führt Operationen für den Server aus.

settings, [setting]

Zeigt die aktuellen Einstellungen für Ihren Rancher-Server an.

ssh

Stellt eine Verbindung zu einem Ihrer Cluster-Knoten über das SSH-Protokoll her.

up

Wendet die Compose-Konfiguration an.

wait

Wartet auf Ressourcen: Cluster, App, Projekt, MultiClusterApp.

token

Authentifiziert und generiert ein neues kubeconfig-Token.

help, [h]

Zeigt eine Liste von Befehlen oder Hilfe für einen Befehl an.

Rancher CLI Hilfe

Nachdem Sie sich über die CLI beim Rancher-Server angemeldet haben, geben Sie ./rancher --help für eine Liste von Befehlen ein.

Alle Befehle akzeptieren das --help Flag, das die Verwendung jedes Befehls dokumentiert.

Nutzungsbeschränkungen

Die Rancher CLI kann nicht verwendet werden, um Dashboard-Apps oder Rancher-Funktionsdiagramme zu installieren.