From 53544b95b3746b410c44d21a55141835be1b59c1 Mon Sep 17 00:00:00 2001 From: Manuel Vergara Date: Sat, 12 Nov 2022 13:25:42 +0100 Subject: [PATCH] =?UTF-8?q?M=C3=A1s=20informaci=C3=B3n=20en=20la=20guia=20?= =?UTF-8?q?k9s?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- guias/06-k9s.md | 101 +++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 99 insertions(+), 2 deletions(-) diff --git a/guias/06-k9s.md b/guias/06-k9s.md index 360c033..cb02386 100644 --- a/guias/06-k9s.md +++ b/guias/06-k9s.md @@ -1,12 +1,23 @@ # 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. +Preview de la web oficial: + +[![asciicast](https://asciinema.org/a/305944.svg)](https://asciinema.org/a/305944) **Í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) + - [Visualización de recursos](#visualización-de-recursos) + - [Buscar](#buscar) + - [Navegando por los recursos de Kubernetes](#navegando-por-los-recursos-de-kubernetes) + - [Logs de los recursos de Kubernetes](#logs-de-los-recursos-de-kubernetes) + - [Operaciones en recursos Kubernetes](#operaciones-en-recursos-kubernetes) + - [Herramientas de monitorización](#herramientas-de-monitorización) + - [Aliases](#aliases) + - [Popeye scanning](#popeye-scanning) ## Instalar k9s con el código @@ -31,13 +42,14 @@ make build && ./execs/k9s mv k9s .k9s ``` ```shell -# Se exporta el path del archivo de ejecución -export PATH=/home/v/.k9s/execs +# Se copia el binario a bin local +sudo cp .k9s/execs/k9s /usr/local/bin/. ``` ```shell #Se comprueba si podemos entrar al cluster de nuestro contexto k9s ``` +No es muy ortodoxo pero es funcional. ## Argumentos CLI @@ -66,6 +78,8 @@ k9s --context coolCtx # Inicie K9s en modo de sólo lectura - con todos los comandos de modificación deshabilitados k9s --readonly ``` +Por defecto k9s leerá el KUBECONFIG actual, que a su vez se lee por defecto de $HOME/.kube/config. En todo caso se le puede indicar + ```shell # Exportar archivo de configuración de kubectl k9s --kubeconfig .kube/config @@ -98,6 +112,89 @@ 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 +##Usando k9s + +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 -- /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. + +![pulses](https://k9scli.io/assets/screens/pulses.png) + +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 ` 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. + +

+ +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](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) \ No newline at end of file