K9s es una interfaz de usuario basada en un terminal para interactuar con sus clústeres Kubernetes. El objetivo de este proyecto es facilitar la navegación, la observación y la gestión de sus aplicaciones desplegadas en la naturaleza. K9s observa continuamente a Kubernetes en busca de cambios y ofrece comandos posteriores para interactuar con sus recursos observados.
Para estar seguro de como se instala lo mejor es mirar la [documentación oficial](https://k9scli.io/topics/install/) o el [repositorio git](https://github.com/derailed/k9s), teniendo en cuenta que actualizan más el repo. Yo lo he instalado así:
Mostrar los mnemónicos de teclado activos y la ayuda | `?`
Mostrar todos los alias y recursos disponibles en el clúster | `ctrl-a` o `:alias`
Salir de K9s | `:q`, `ctrl-c`
Ver un recurso de Kubernetes utilizando el singular/plural o el nombre corto | `:po`⏎ | acepta el singular, el plural, el nombre corto o el alias, es decir, pod o pods
Ver un recurso de Kubernetes en un espacio de nombres dado | `:alias namespace`⏎
Filtrar una vista de recursos dado un filtro | `/filter`⏎ | Regex2 soportado ie `fred\|blee` para filtrar recursos llamados fred o blee
Filtro regex inverso | `/ ! filter`⏎ | Guarda todo lo que no coincide. No se ha implementado para los registros.
Filtrar la vista de recursos por etiquetas | `/-l label-selector`⏎
Buscar difusamente un recurso dado un filtro | `/-f filter`⏎
Sale del modo de vista/comando/filtro | `<esc>`
Mapeo de teclas para describir, ver, editar, ver registros,... | `d`,`v`, `e`, `l`,...
Para ver y cambiar a otro contexto de Kubernetes | `:ctx`⏎
Para ver y cambiar a otro contexto de Kubernetes | `:ctx context-name`⏎
Para ver y cambiar a otro espacio de nombres de Kubernetes | `:ns`⏎
Para ver todos los recursos guardados | `:screendump o sd`⏎
Para eliminar un recurso (TAB y ENTER para confirmar) | `ctrl-d`
Para eliminar un recurso (¡no hay diálogo de confirmación!) | `ctrl-k`
Ya con `k9s` iniciado tendremos una pantalla de visualización en la que podremos darle [ordenes](#key-bindings). Por ejemplo, y como se indica en la anterior tabla, `?` es para pedir ayuda.
### Visualización de recursos
Si estás familiarizado con los [comandos de vim](https://gitea.vergaracarmona.es/man-linux/Guia-VIM), te sentirás como en casa con K9s. La forma de cambiar de introducir las ordenes es con dos puntos. Así, para ver los pods del cluster se debe escribir `:pods` y pulsar enter. Para ver los nodos se escribe `:node` e Intro. Se pueden ver sugerencias en la línea de comandos a medida que escribes, por lo que se puede aprovechar la opción de completar con el tabulador y ahorrar en pulsaciones. Así, para ver todos los espacios de nombres del clúster, sólo tendrá que escribir:
```shell
:na <tab><enter
```
### Buscar
Si tienes muchos recursos de un tipo particular en un cluster, puedes buscar rápidamente a través de ellos usando el comando /. Si, por ejemplo, quieres filtrar todos los espacios de nombres que has recuperado en la sección anterior hasta llegar a los que contienen "kube" en su nombre, escribirías
```shell
/kube
```
### Navegando por los recursos de Kubernetes
Podrás moverte por los recursos usando `j` para bajar y `k` para subir. ¿Te suena? También es como vim. Para aquellos que nunca han aprendido a navegar con vim, las teclas de flecha funcionan igual de bien.
Puedes seleccionar el recurso que quieras y pulsar `d` para describirlo.
### Logs de los recursos de Kubernetes
Puedes ver los logs de cualquier pod, job u otro recurso de Kubernetes utilizando el comando `l` con el recurso seleccionado. Sin embargo, ¿qué pasa con la visualización de eventos pasados, si un recurso ha sido reemplazado por una nueva instancia de sí mismo que ahora está escribiendo sus propios logs? K9s permite ver logs anteriores para ese recurso con el comando `p`, que es increíblemente útil para rastrear errores u otros problemas.
Si estás viendo los registros y quieres ver exactamente cuándo ocurrió un evento, puedes usar `t` para insertar automáticamente marcas de tiempo.
### Operaciones en recursos Kubernetes
Con K9s puedes **editar configuraciones** sobre la marcha. Pulsando `e` en cualquier recurso, se presentará el editor por defecto (probablemente vim si no has especificado otro) para editar el yaml de configuración de ese pod, despliegue u recurso en concreto.
Obviamente, editando estas configuraciones afectará al clúster inmediatamente pero si se utiliza CI/CD podrá ser sobrescritas por posteriores despliegues.
También se puede realizar **operaciones a nivel de nodo** con K9. Por ejemplo, se puede acordonar un nodo, o incluso vaciarlo para poder eliminarlo del pool o realizar otro tipo de mantenimiento en él.
Si existe algún pod que se está comportando mal, también **se puede eliminar**. En la vista `:pods`, se selecciona y se pulsa `CTRL +d`. Pide confirmación de la eliminación.
Otra cosa que se pueda haces es **configurar port-forwarding** desde un pod específico utilizando `SHIFT+f` y eligiendo el puerto local. Por ejemplo, si se elige el 3000 se podrá ver el recurso en `localhost:3000`.
Aun hay más, se puede **abrir un intérprete de comandos** en un pod que se esta ejecutando, claro, si lo soporta. Se selecciona el pod y se pulsa `s`. Esto es el equivalente a ejecutar `kubectl exec --stdin --tty <nombredelpod> -- /bin/bash`. Para salir es igual, con `exit`.
### Herramientas de monitorización
K9s dispone de un conjunto de herramientas de monitorización, además del polling periódico del recurso seleccionado (pod, nodo, etc) que se obtiene en la pantalla principal. Una de las visualizaciones más interesantes es el modo `:pulses`. Con esta vista aparecen gráficos live-updating y codificados por colores de los principales aspectos del clúster.
Permite navegar para profundizar en cada pulso mostrado utilizando el tabulador o seleccionando el número correspondiente al recurso concreto en la barra superior.
Para salir de cualquier vista es pulsando `Esc`.
### Aliases
Al igual que con la shell se pueden crear alias en K9s para acelerar los comandos comunes que se ejecuten. Para crear un alias, necesitas crear un archivo en el directorio `.k9s/`. Por defecto, éste se encuentra en la HOME de usuario: `$HOME/.k9s`. Es necesario crear un archivo llamado `alias.yml` en este directorio.
El formato de las definiciones de alias es en forma de `alias:grupo/versión/recurso`. Por ejemplo, si quieres hacer un alias `dep` para ver todos los despliegues, tendrías que definirlo en `alias.yml` como
```yaml
alias:
dep: apps/v1/deployments
```
Ahora en k9s se podrá escribir `:dep <enter>` y ver sus despliegues.
En la [documentación oficial](https://k9scli.io/topics/aliases/) hay más detalles sobre la estructura y el uso del archivo de alias.
### Popeye scanning
K9s incluye la herramienta de desinfección de Kubernetes Popeye. Permite comparar la configuración de un clúster con las mejores prácticas. Se abre con el comando `:popeye`. Esto abrirá una página de resumen de escaneo que dará una puntuación general y los componentes que Popeye ha analizado. Puede desglosar cualquier componente, como los conjuntos de demonios, para ver las razones de los resultados.
Para mitigar alguno de los problemas de configuración detectados por el análisis de Popeye se puede buscar el mensaje de error concreto.
<br><br>
Si aun tienes dudas puedes ver los [Vídeo-tutoriales](https://k9scli.io/topics/video/) de [Fernand Galiana](https://github.com/derailed).
[01 Instalación kubctl](01-kubectl.md) --> [02 Clústers](02-clusters.md) --> [03 manifiestos](03-manifiestos.md) --> [04 Cheatsheet kubernetes](04-cheatsheet.md) --> [05 Helm: Control de despliegues en Kubernetes](05-helm.md) --> [K9s: Otro estilo de CLI para k8s](06-k9s.md)
