Rancher CLI

Laboratorio: Rancher CLI

Descripción

Esta guía muestra el proceso de instalación de la herramienta de consola para Rancher y sus diferentes usos.

Objetivos

Instalar herramienta Rancher CLI
Conectar la herramienta con un Rancher Server
Manejar recursos de Rancher a través de comandos

Antes de comenzar

Contar con el acceso al ambiente de laboratorio

Inicio de laboratorio

Instalación de CLI

Ingrese a la consola gráfica de Rancher Server
En la esquina superior izquierda desplegar el menú y dirigirse al apartado de abajo dando click en el texto con la versión instalada (ej. v2.6.8)
Copiar el enlace de descarga del CLI para Linux
Ingresar a la maquina student-x-aio

Descargar el archivo comprimido

wget https://releases.rancher.com/cli2/v2.6.7/rancher-linux-amd64-v2.6.7.tar.gz

Descomprimir la carpeta descargada

tar -xvzf rancher-linux-amd64-v2.6.7.tar.gz

Asignar permisos de ejecución al binario y mover al PATH

chmod +x rancher-v2.6.7/rancher
mv rancher-v2.6.7/rancher ~/bin/

Verificar la instalación
```
rancher -v
```

API Token

En la interfaz de Rancher dirigirse al ícono de usuario en la esquina superior derecha y seleccionar Account & API Keys
Click en Create API Key
Escribir en Description Uso para CLI
Click en Create
Copiar y guardar el valor de Bearer Token

Uso de CLI

Haga login contra Rancher Server utilizando el Token anteriormente generado, debe asegurarse de reemplazar la URL de Rancher Server y el Token generado anteriormente
```
rancher login https://rancher.x-x-x-x.nip.io --token your-token
```
Ejemplo:
```
rancher login https://rancher.34-127-95-67.nip.io --token token-nj4m6:ppfd4wz6xqft5k6q77fhh9tjjpql8vvq8ppzm5ljpg788svm5lhdnq
```
Responda con un yes a la pregunta: Do you want to continue connecting

Cuando solicite elegir un proyecto, seleccione el número correspondiente a CLUSTER NAME:cluster-users y PROJECT NAME:System Lo anterior es para seleccionar un Contexto de ejecución de los comandos, posteriormente puede ejecutar el siguiente comando para cambiarse de Contexto:

rancher context switch

Verifique poder listar los clusters ejecutando
```
rancher clusters
```
Inspeccione un cluster de los listados anteriormente, debe utilizar el campo del NAME
```
rancher inspect --type cluster <cluster> --format yaml
```

Obtenga el numero de Pods activos del cluster

rancher inspect --type cluster local --format '{{.name}} {{"# of Pods:"}} {{.requested.pods}}'

rancher inspect --type cluster cluster-users --format '{{.name}} {{"# of Pods:"}} {{.requested.pods}}'

Obtenga la lista de los nodos dicponibles en el cluster
```
rancher node ls
```

Obtenga el numero de Pods activos por nodo

rancher nodes ls --format '{{.Node.ID}} {{"# of Pods:"}} {{.Node.Requested.pods}}'

Obtenga los recursos consumidos por cada nodo

rancher nodes ls --format '{{.Node.ID}} - {{"Memory:"}} {{.Node.Requested.memory}} {{"| CPU:"}} {{.Node.Requested.cpu}}'

Obtenga los Projects de los Clusters
```
rancher project ls
```

Obtenga los Projects junto al nombre del Cluster al que pertenecen

rancher projects ls --format '{{.Project.Name}} {{"ID:"}} {{.ID}} {{"| Cluster:"}} {{.Project.ClusterID}}'

Cree un Project nuevo llamado cli-prueba, debe asegurarse de cambiar el valor de cluster-id

rancher projects create cli-prueba --cluster cluster-id --description "Project de Prueba creado desde CLI"

Vuelva a listar los Projects

rancher projects ls --format '{{.Project.Name}} {{"ID:"}} {{.ID}} {{"| Cluster:"}} {{.Project.ClusterID}}'

Liste los Roles disponibles en Rancher
```
rancher projects list-roles
```

Agregue un usuario al Project cli-prueba como Project Member

rancher projects add-member-role userx project-member --project-id project-id

Verifique desde la UI de Rancher Server que todos los recursos fueron creados junto con los Members del Project creado

Limpieza de ambiente

Elimine el Project cli-prueba
```
rancher projects rm project-id
```