Document using K9s on the seed (azimuth-cloud#159)

Co-authored-by: John Garbutt <[email protected]>

Author: MoteHue

docs/debugging/k9s-all-pods.png

@@ -0,0 +1,37 @@
+# Using K9s
+
+K9s is installed onto the seed VM. You can use this for a more interactive view
+of the Kubernetes clusters. From the seed, either run `k9s` with `KUBECONFIG`
+unset to view the K3s cluster, or export the provided `KUBECONFIG` file to view
+the HA cluster.
+
+```console
+$ ./bin/seed-ssh
+ubuntu@azimuth-staging-seed:~$ export KUBECONFIG=./kubeconfig-azimuth-staging.yaml
+ubuntu@azimuth-staging-seed:~$ k9s
+```
+
+By default, you are viewing the pods in the default namespace.
+
+![Pods view in K9s](k9s-default-pods.png)
+
+Here's some simple commands to get started:
+
+* View all namespaces by pressing `0`.
+
+  ![All pods in K9s](k9s-all-pods.png)
+
+* Select a pod with the arrow keys and view its logs with `l`.
+
+  ![capo-controller logs in K9s](k9s-pod-logs.png)
+
+* Switch between resources with `:<resource-type>`. For example:
+
+  ```console
+  :machines
+  :clusters
+  :pods
+  ```
+
+
+See the [k9s docs](https://k9scli.io/) for more details.

docs/debugging/k9s-default-pods.png

@@ -41,6 +41,7 @@ nav:
       - debugging/index.md
       - debugging/access-k3s.md
       - debugging/access-ha.md
+      - debugging/using-k9s.md
       - debugging/access-monitoring.md
       - debugging/zenith-services.md
       - debugging/consul.md