# K9s: Otro estilo de CLI para k8s
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.


**Índice**
- [K9s: Otro estilo de CLI para k8s](#k9s-otro-estilo-de-cli-para-k8s)
  - [Instalar k9s con el código](#instalar-k9s-con-el-código)
  - [Argumentos CLI](#argumentos-cli)
  - [Key Bindings](#key-bindings)

## Instalar k9s con el código

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í:

```shell
# Primero instalar golang si no lo tienes ya
sudo apt install golang
## Se comprueba la versión
go version
```
```shell
# descargamos con git y entramos en la carpeta
git clone https://github.com/derailed/k9s.git && cd k9s
```
```shell
# Se ejecuta el Makefile
make build && ./execs/k9s
```
```shell
# Se mueve el contenido en carpeta oculta
mv k9s .k9s
```
```shell
# Se exporta el path del archivo de ejecución
export PATH=/home/v/.k9s/execs
```
```shell
#Se comprueba si podemos entrar al cluster de nuestro contexto
k9s
```

## Argumentos CLI

K9s CLI viene con una vista de argumentos que puede utilizar para lanzar la herramienta con diferente configuración.
```shell
# Lista de todas las opciones de la CLI disponibles
k9s help
```
```shell
# Obtener información sobre el tiempo de ejecución de K9s (registros, configuraciones, etc.)
k9s info
```
```shell
# Ejecutar K9s en un espacio de nombres determinado.
k9s -n mycoolns
```
```shell
# Ejecutar K9s y lanzarlo en la vista de pod a través del comando pod.
k9s -c pod
```
```shell
# Inicie K9s en un contexto KubeConfig no predeterminado
k9s --context coolCtx
```
```shell
# Inicie K9s en modo de sólo lectura - con todos los comandos de modificación deshabilitados
k9s --readonly
```
```shell
# Exportar archivo de configuración de kubectl
 k9s --kubeconfig .kube/config
```

## Key Bindings

Acción | Comando | Comentario
---|---|---
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` 	 
Alternar columnas anchas | `ctrl-w` | Equivalente a kubectl ... -o wide
Alternar el estado de error | `ctrl-z` | Ver los recursos en estado de error
Lanzar la vista de pulsos | `:pulsos o pu`⏎ 	 
Lanzar vista XRay | `:xray RECURSO [NAMESPACE]`⏎ | RECURSO puede ser uno de po, svc, dp, rs, sts, ds, NAMESPACE es opcional
Lanzar la vista de Popeye | `:popeye o pop`⏎ | Ver https://popeyecli.io

---

[01 Instalación kubctl](guias/01-kubectl.md) --> [02 Clústers](guias/02-clusters.md) --> [03 manifiestos](guias/03-manifiestos.md) --> [04 Cheatsheet kubernetes](guias/04-cheatsheet.md) --> [05 Helm: Control de despliegues en Kubernetes](guias/05-helm.md)