Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

SUSE Rancher Prime CLI

El Rancher CLI (interfaz de línea de comandos) es una herramienta unificada que puedes utilizar para interactuar con Rancher. Con esta herramienta, puedes operar Rancher utilizando la interfaz de línea de comandos en lugar de la GUI.

Descargar Rancher CLI

El binario se puede descargar directamente desde la interfaz de usuario.

En la esquina superior izquierda, haz clic en ☰.
En la parte inferior del menú de la barra lateral de navegación, haz clic en Acerca de.
Bajo la sección de Descargas de CLI, hay enlaces para descargar los binarios para Windows, Mac y Linux. También puedes consultar la página de lanzamientos para nuestro CLI para descargas directas del binario.

Requisitos

Después de descargar el Rancher CLI, necesitas realizar algunas configuraciones. Rancher CLI requiere:

La URL de tu servidor Rancher, que se utiliza para conectarse al servidor Rancher.
Un token de portador de API, que se utiliza para autenticarte con Rancher. Para más información sobre cómo obtener un token de portador, consulta rancher-admin/users/settings/api-keys.adoc[Creando una clave de API].

Autenticación de CLI

Antes de que puedas utilizar Rancher CLI para controlar tu servidor Rancher, debes autenticarte utilizando un token de portador de API. Inicia sesión utilizando el siguiente comando (reemplaza <BEARER_TOKEN> y <SERVER_URL> con tu información):

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

Si el servidor Rancher utiliza un certificado autofirmado, Rancher CLI te pedirá que continúes con la conexión.

Selección de Proyecto

Antes de que puedas realizar cualquier comando, debes seleccionar un proyecto de Rancher para ejecutar esos comandos. Para seleccionar un proyecto en el que trabajar, utiliza el comando ./rancher context switch. Cuando ingreses este comando, se mostrará una lista de proyectos disponibles. Introduce un número para elegir tu proyecto.

Ejemplo: ./rancher context switch Salida

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:

Después de que ingreses un número, la consola mostrará un mensaje indicando que has cambiado de proyecto.

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

Asegúrate de que puedes ejecutar rancher kubectl get pods con éxito.

Comandos

Los siguientes comandos están disponibles para su uso en Rancher CLI.

Comando Resultado

Comando	Resultado
`clusters, [cluster]`	Realiza operaciones en tus clusters.
`context`	Cambia entre Rancher proyectos. Para un ejemplo, consulta Selección de Proyecto.
`inspect [OPTIONS] [RESOURCEID RESOURCENAME]`	Muestra detalles sobre recursos de Kubernetes o recursos de Rancher (es decir: proyectos y cargas de trabajo). Especifica recursos por nombre o ID.
`kubectl`	Ejecuta comandos de kubectl.
`login, [l]`	Inicia sesión en un Servidor Rancher. Para un ejemplo, consulta Autenticación de CLI.
`machines, [machine]`	Realiza operaciones en máquinas.
`namespaces, [namespace]`	Realiza operaciones en espacios de nombres.
`nodes, [node]`	Realiza operaciones en nodos.
`projects, [project]`	Realiza operaciones en proyectos.
`ps`	Muestra cargas de trabajo en un proyecto.
`server`	Realiza operaciones para el servidor.
`settings, [setting]`	Muestra la configuración actual de tu servidor Rancher.
`ssh`	Se conecta a uno de los nodos de tu clúster utilizando el protocolo SSH.
`up`	Aplica la configuración de composición.
`wait`	Espera a los recursos del clúster, app, proyecto, multiClusterApp.
`token`	Se autentica y genera un nuevo token kubeconfig.
`help, [h]`	Muestra una lista de comandos o ayuda para un comando.

clusters, [cluster]

Realiza operaciones en tus clusters.

context

Cambia entre Rancher proyectos. Para un ejemplo, consulta Selección de Proyecto.

inspect [OPTIONS] [RESOURCEID RESOURCENAME]

Muestra detalles sobre recursos de Kubernetes o recursos de Rancher (es decir: proyectos y cargas de trabajo). Especifica recursos por nombre o ID.

kubectl

Ejecuta comandos de kubectl.

login, [l]

Inicia sesión en un Servidor Rancher. Para un ejemplo, consulta Autenticación de CLI.

machines, [machine]

Realiza operaciones en máquinas.

namespaces, [namespace]

Realiza operaciones en espacios de nombres.

nodes, [node]

Realiza operaciones en nodos.

projects, [project]

Realiza operaciones en proyectos.

ps

Muestra cargas de trabajo en un proyecto.

server

Realiza operaciones para el servidor.

settings, [setting]

Muestra la configuración actual de tu servidor Rancher.

ssh

Se conecta a uno de los nodos de tu clúster utilizando el protocolo SSH.

up

Aplica la configuración de composición.

wait

Espera a los recursos del clúster, app, proyecto, multiClusterApp.

token

Se autentica y genera un nuevo token kubeconfig.

help, [h]

Muestra una lista de comandos o ayuda para un comando.

Ayuda de Rancher CLI

Una vez que hayas iniciado sesión en el servidor Rancher utilizando la CLI, introduce ./rancher --help para obtener una lista de comandos.

Todos los comandos aceptan la --help bandera, que documenta el uso de cada comando.

limitaciones

La CLI de Rancher no puede ser utilizada para instalar aplicaciones de panel o gráficos de características de Rancher.