chore: moved articles to the specific subsection

knowledge base/kubernetes/check a pod can connect to an external db.md

@@ -1,5 +1,11 @@
 # Check a Pod can connect to an external DB
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -15,3 +21,19 @@ nc -vz -w3 10.0.2.15 3306
 # test the client can connect
 mysql --host 10.0.2.15 --port 3306 --user root
 ```
+
+## Further readings
+
+- [Kubernetes]
+- [`kubectl`][kubectl]
+
+## Sources
+
+All the references in the [further readings] section, plus the following:
+
+<!-- internal references -->
+[further readings]: #further-readings
+[kubectl]: kubectl.md
+[kubernetes]: README.md
+
+<!-- external references -->

knowledge base/kubernetes/drain a node.md

@@ -1,16 +1,24 @@
 # Drain a K8S cluster node
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL:DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
+## TL:DR
+
 1. mark the node as unschedulable (_cordon_):
 
    ```sh
-   $ kubectl cordon kworker-rj2
+   $ kubectl cordon 'kworker-rj2'
    node/kworker-rj2 cordoned
    ```
 
 1. remove pods running on the node:
 
    ```sh
-   $ kubectl drain kworker-rj2 --grace-period=300 --ignore-daemonsets=true
+   $ kubectl drain 'kworker-rj2' --grace-period=300 --ignore-daemonsets=true
    node/kworker-rj2 already cordoned
    WARNING: ignoring DaemonSet-managed Pods: kube-system/calico-node-fl8dl, kube-system/kube-proxy-95vdf
    evicting pod default/my-dep-557548758d-d2pmd
@@ -22,12 +30,23 @@
 1. make the node available again:
 
    ```sh
-   $ kubectl uncordon kworker-rj2
+   $ kubectl uncordon 'kworker-rj2'
    node/kworker-rj2 uncordoned
    ```
 
+## Further readings
+
+- [Kubernetes]
+- [`kubectl`][kubectl]
+
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [How to drain a node in Kubernetes]
 
+<!-- internal references -->
+[further readings]: #further-readings
+
+<!-- external references -->
 [how to drain a node in kubernetes]: https://linuxhandbook.com/kubectl-drain-node/

knowledge base/kubernetes/get the environment of a process running in a container.md

@@ -1,5 +1,11 @@
 # Get the environment of a process running in a container
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -11,9 +17,19 @@ kubectl exec pod-name -- cat /proc/1/environ
 # Only works if the onboard `ps` is not from busybox.
 ps e -p $PID
 ```
+## Further readings
+
+- [Kubernetes]
+- [`kubectl`][kubectl]
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Get the environment variables of running process in container]
 
+<!-- internal references -->
+[further readings]: #further-readings
+
+<!-- external references -->
 [get the environment variables of running process in container]: https://unix.stackexchange.com/a/412730

knowledge base/kubernetes/kubectl.md

@@ -21,7 +21,9 @@ kubectl get pod etcd-minikube -n kube-system
 kubectl get pods -l app=nginx,tier=frontend
 ```
 
-### Table of contents
+One possible output format is [JSONpath].
+
+## Table of contents <!-- omit in toc -->
 
 1. [TL;DR](#tldr)
 1. [Configuration](#configuration)
@@ -563,6 +565,7 @@ Verbosity | Description
 
 ## Further readings
 
+- [Kubernetes]
 - [Assigning Pods to Nodes]
 - [Taints and Tolerations]
 - [Commands reference]
@@ -572,6 +575,8 @@ Verbosity | Description
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Cheatsheet]
 - [Run a single-instance stateful application]
 - [Run a replicated stateful application]
@@ -586,7 +591,11 @@ Verbosity | Description
 [enforce pod security standards with namespace labels]: https://kubernetes.io/docs/tasks/configure-pod-container/enforce-standards-namespace-labels/
 [taints and tolerations]: https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/
 
-<!-- external references articles -->
+<!-- internal references -->
+[jsonpath]: ../jsonpath.md
+[kubernetes]: README.md
+
+<!-- external references -->
 [accessing an application on kubernetes in docker]: https://medium.com/@lizrice/accessing-an-application-on-kubernetes-in-docker-1054d46b64b1
 [run a replicated stateful application]: https://kubernetes.io/docs/tasks/run-application/run-replicated-stateful-application/
 [run a single-instance stateful application]: https://kubernetes.io/docs/tasks/run-application/run-single-instance-stateful-application/

knowledge base/kubernetes/minikube.md

@@ -1,5 +1,14 @@
 # Minikube
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Troubleshooting](#troubleshooting)
+   1. [What happens if I use the _LoadBalancer_ type with Services?](#what-happens-if-i-use-the-loadbalancer-type-with-services)
+   1. [Can I use custom certificates?](#can-i-use-custom-certificates)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -67,10 +76,15 @@ Minikibe's certificates are available in the `~/.minikube/certs` folder.
 
 ## Further readings
 
+- [Website]
 - [Drivers]
+- [Kubernetes]
+- [`kubectl`][kubectl]
 
 ## Sources
 
+All the references in the [further readings] section, plus the following:
+
 - [Accessing] the services
 - [Getting started] guide
 - Cluster [configuration]
@@ -81,13 +95,22 @@ Minikibe's certificates are available in the `~/.minikube/certs` folder.
 - How to [use local docker images] in Minikube
 - How to [use untrusted certs]
 
+<!-- project's references -->
 [accessing]: https://minikube.sigs.k8s.io/docs/handbook/accessing
 [completion]: https://minikube.sigs.k8s.io/docs/commands/completion
 [configuration]: https://minikube.sigs.k8s.io/docs/handbook/config
 [docker driver]: https://minikube.sigs.k8s.io/docs/drivers/docker
 [drivers]: https://minikube.sigs.k8s.io/docs/drivers
 [getting started]: https://minikube.sigs.k8s.io/docs/start
-[hello world]: https://kubernetes.io/docs/tutorials/hello-minikube
 [ssh]: https://minikube.sigs.k8s.io/docs/commands/ssh
-[use local docker images]: https://stackoverflow.com/questions/42564058/how-to-use-local-docker-images-with-minikube#62303945
 [use untrusted certs]: https://minikube.sigs.k8s.io/docs/handbook/untrusted_certs
+[website]: https://minikube.sigs.k8s.io
+
+<!-- internal references -->
+[further readings]: #further-readings
+[kubectl]: kubectl.md
+[kubernetes]: README.md
+
+<!-- external references -->
+[hello world]: https://kubernetes.io/docs/tutorials/hello-minikube
+[use local docker images]: https://stackoverflow.com/questions/42564058/how-to-use-local-docker-images-with-minikube#62303945