Ce document a été traduit à l'aide d'une technologie de traduction automatique. Bien que nous nous efforcions de fournir des traductions exactes, nous ne fournissons aucune garantie quant à l'exhaustivité, l'exactitude ou la fiabilité du contenu traduit. En cas de divergence, la version originale anglaise prévaut et fait foi.

SUSE Rancher Prime CLI

Le Rancher CLI (interface de ligne de commande) est un outil unifié que vous pouvez utiliser pour interagir avec Rancher. Avec cet outil, vous pouvez utiliser Rancher via une ligne de commande plutôt que la GUI.

Téléchargez Rancher CLI

Le binaire peut être téléchargé directement depuis l’interface utilisateur.

Dans le coin supérieur gauche, cliquez sur ☰.
En bas du menu de la barre latérale de navigation, cliquez sur À propos.
Sous la section Téléchargements CLI, il y a des liens pour télécharger les binaires pour Windows, Mac et Linux. Vous pouvez également consulter la page des versions pour notre CLI pour des téléchargements directs du binaire.

Configuration requise

Après avoir téléchargé le Rancher CLI, vous devez effectuer quelques configurations. Rancher CLI nécessite :

L’URL de votre serveur Rancher, qui est utilisée pour se connecter au serveur Rancher.
Un jeton d’API Bearer, qui est utilisé pour s’authentifier auprès de Rancher. Pour plus d’informations sur l’obtention d’un jeton Bearer, consultez rancher-admin/users/settings/api-keys.adoc[Création d’une clé API].

Authentification CLI

Avant de pouvoir utiliser Rancher CLI pour contrôler votre serveur Rancher, vous devez vous authentifier à l’aide d’un jeton d’API Bearer. Connectez-vous en utilisant la commande suivante (remplacez <BEARER_TOKEN> et <SERVER_URL> par vos informations) :

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

Si le serveur Rancher utilise un certificat auto-signé, Rancher CLI vous invite à continuer avec la connexion.

Sélection de projet

Avant de pouvoir exécuter des commandes, vous devez sélectionner un projet Rancher sur lequel exécuter ces commandes. Pour sélectionner un projet sur lequel travailler, utilisez la commande ./rancher context switch. Lorsque vous entrez cette commande, une liste des projets disponibles s’affiche. Entrez un numéro pour choisir votre projet.

Exemple : ./rancher context switch Sortie

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:

Après avoir entré un numéro, la console affiche un message indiquant que vous avez changé de projet.

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

Assurez-vous de pouvoir exécuter rancher kubectl get pods avec succès.

Commandes

Les commandes suivantes sont disponibles pour une utilisation dans Rancher CLI.

Commande Résultat

Commande	Résultat
`clusters, [cluster]`	Effectue des opérations sur vos clusters.
`context`	Change entre les projets Rancher. Pour un exemple, voir Sélection de projet.
`inspect [OPTIONS] [RESOURCEID RESOURCENAME]`	Affiche les détails sur ressources Kubernetes ou les ressources Rancher (c’est-à-dire : projets et charges de travail). Spécifiez les ressources par nom ou ID.
`kubectl`	Exécute commandes kubectl.
`login, [l]`	Se connecte à un serveur Rancher. Pour un exemple, voir Authentification CLI.
`machines, [machine]`	Effectue des opérations sur des machines.
`namespaces, [namespace]`	Effectue des opérations sur espaces de noms.
`nodes, [node]`	Effectue des opérations sur nœuds.
`projects, [project]`	Effectue des opérations sur projets.
`ps`	Affiche charges de travail dans un projet.
`server`	Effectue des opérations pour le serveur.
`settings, [setting]`	Affiche les paramètres actuels de votre serveur Rancher.
`ssh`	Se connecte à l’un de vos nœuds de cluster en utilisant le protocole SSH.
`up`	Applique la configuration de composition.
`wait`	Attend les ressources du cluster, de l’appli, du projet, de l’appli multi-cluster.
`token`	S’authentifie et génère un nouveau token kubeconfig.
`help, [h]`	Affiche une liste de commandes ou d’aide pour une commande.

clusters, [cluster]

Effectue des opérations sur vos clusters.

context

Change entre les projets Rancher. Pour un exemple, voir Sélection de projet.

inspect [OPTIONS] [RESOURCEID RESOURCENAME]

Affiche les détails sur ressources Kubernetes ou les ressources Rancher (c’est-à-dire : projets et charges de travail). Spécifiez les ressources par nom ou ID.

kubectl

Exécute commandes kubectl.

login, [l]

Se connecte à un serveur Rancher. Pour un exemple, voir Authentification CLI.

machines, [machine]

Effectue des opérations sur des machines.

namespaces, [namespace]

Effectue des opérations sur espaces de noms.

nodes, [node]

Effectue des opérations sur nœuds.

projects, [project]

Effectue des opérations sur projets.

ps

Affiche charges de travail dans un projet.

server

Effectue des opérations pour le serveur.

settings, [setting]

Affiche les paramètres actuels de votre serveur Rancher.

ssh

Se connecte à l’un de vos nœuds de cluster en utilisant le protocole SSH.

up

Applique la configuration de composition.

wait

Attend les ressources du cluster, de l’appli, du projet, de l’appli multi-cluster.

token

S’authentifie et génère un nouveau token kubeconfig.

help, [h]

Affiche une liste de commandes ou d’aide pour une commande.

Aide de Rancher CLI

Une fois connecté au serveur Rancher via la CLI, entrez ./rancher --help pour obtenir une liste de commandes.

Toutes les commandes acceptent le drapeau --help, qui documente l’utilisation de chaque commande.

limites

Le Rancher CLI ne peut pas être utilisé pour installer applis de tableau de bord ou graphiques de fonctionnalités Rancher.