====== Kubernetes ======
===== Commandes =====

  * Activer l'auto-complétion dans bash : <code bash>source <(kubectl completion bash) && echo "source <(kubectl completion bash)" >> ~/.bashrc</code>
  * Activer l'auto-complétion en utilisant un alias : <code bash># Dans .bash_aliases
alias k='kubectl'
complete -F __start_kubectl k</code>
  * Créer un Port-forward pour service : <code bash>kubectl port-forward svc/mon-service port-local:port-service</code>
  * Se connecter dans un pod: <code bash>kubectl exec -it nom-container -- /bin/bash</code>
  * Se connecter dans un container spécifique :<code bash>kubectl exec -ti nom-pod -c nom-container -- bash</code>
  * Sauvegarder la conf d'une ressource dans un fichier yaml :<code>kubectl get pvc mon-pvc-0 -o yaml > pvc0.yml</code>
  * Copier un fichier dans un pod et un container spécifique : <code bash>kubectl cp archive.tar.gz namespace/mon-pod:/foo/ -c  mon-container</code>
  * Supprimer tous les pods evicted : <code>kubectl get pod | grep Evicted | awk '{print $1}' | xargs kubectl delete pod</code>
  * Supprimer tous les pods bloqués en statut Terminating : <code>kubectl get po| grep Terminating | awk '{print $1}' | xargs kubectl delete pod --force</code>
  * Supprimer un namespace bloqué en statut Terminating : <code>kubectl get namespace "MYNAMESPACE" -o json | tr -d "\n" | sed "s/\"finalizers\": \[[^]]\+\]/\"finalizers\": []/" | kubectl replace --raw /api/v1/namespaces/MYNAMESPACE/finalize -f -</code>
  * Drainer un node : <code>kubectl drain --ignore-daemonsets --delete-emptydir-data mon-node</code>
  * Restaurer un dump SQL dans un pod MariaDB :<code>gzcat dump.sql.gz | kubectl exec -i pod-mariadb-0 -- mysql -u root -pPASSWORD ma_db</code>

==== Diagnostic ====
  * Voir les metrics d'un pod ou node : <code>kubectl top [node|pod] nom-pod-node</code>
  * Voir les metrics de tous les nodes d'un cluster : <code>kubectl get no | kubectl top no</code> 
  * Lister tous les pods d'un node : <code>kubectl get pod -A -o wide|grep NODE</code> 
  * Lister les ip des pods d'un cluster : <code>kubectl get pod -A -o wide</code>
  * Voir l'espace disque restant dans un pod : <code>kubectl exec nom-pod -- df -h</code>  


===== Ressources de test =====
==== Pod ====
<code yaml| download>
apiVersion: v1
kind: Pod
metadata:
  name: debian-test
spec:
  containers:
  - name: debian
    image: debian:stable-slim
    command:
      - "sleep"
      - "86400"
    volumeMounts:
    - name: data
      mountPath: /mnt/data
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: data-debian-test-0
</code>
==== Volume ====
<code yaml| download>
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: data-debian-test-0
spec:
  accessModes:
    - ReadWriteOnce
  volumeMode: Filesystem
  resources:
    requests:
      storage: 50Gi
  storageClassName: csi-cinder-classic
</code>

===== Debug =====
==== Gérer un conflit de versions API de ressources ====
Suite à une mise à jour du cluster, des ressources peuvent être dans une version API obsolète.
Exemple : 
<code>Error: UPGRADE FAILED: unable to build kubernetes objects from current release manifest: [resource mapping not found for name: "XXXXXXXX" namespace: "" from "": no matches for kind "PodDisruptionBudget" in version "policy/v1beta1"
ensure CRDs are installed first, resource mapping not found for name: "XXXXXXXX" namespace: "" from "": no matches for kind "PodDisruptionBudget" in version "policy/v1beta1"</code>
La solution consiste à faire tourner Mapkubeapis : 
  - <code>helm plugin install https://github.com/helm/helm-mapkubeapis</code>
  - <code>helm mapkubeapis RELEASE </code>
==== Supprimer une namespace bloqué en statut terminating ====
  - <code>kubectl get namespace <YOUR_NAMESPACE> -o json > <YOUR_NAMESPACE>.json</code>
  - <code># Supprimer le finalizer: kubernetes
vim <YOUR_NAMESPACE>.json</code>
  - <code>kubectl replace --raw "/api/v1/namespaces/<YOUR_NAMESPACE>/finalize" -f ./<YOUR_NAMESPACE>.json</code>
source : [[https://stackoverflow.com/questions/52369247/namespace-stuck-as-terminating-how-i-removed-it]]

==== Augmenter la taille d'un volume déclaré dans un statefulset ====

<WRAP center round important 60%>
Ce processus n'a été testé que chez AWS avec gp2 pour storageclass
</WRAP>
  - Supprimer le statefulset : <code>k delete sts MON-STS</code>
  - Modifier la taille du PVC : <code>k edit pvc MON-PVC</code>
  - Appliquer la modification de taille dans le chart Helm du déploiement
  - Pousser et déployer la modification
=== Méthode alternative ===
  - Unscale le statefulset
  - Modifier le pv pour mettre reclaimpolicy à Retain
  - Supprimer le pvc
  - Modifier le pv pour supprimer le claimref
  - Supprimer le statefulet
  - Relancer le deploiement
Méthode chez OVH : https://support.us.ovhcloud.com/hc/en-us/articles/1500005033982-How-to-Resize-Persistent-Volumes
===== Minikube =====
  * Accéder au dashboard : minikube dashboard
  * Connaître l'url pour accéder à un service : minikube service service-name --url
  * Démarrer Minikube en intégrant un volume : minikube start --mount-string="<source directory>:<target directory>" --mount
  * Importer des fichiers dans la VM Minikube : <code>rsync -arv -e "ssh -i $(minikube ssh-key)" --rsync-path="sudo rsync" /path/to/source/files/ docker@$(minikube ip):/data/</code>

Ressources de commandes essentielles : 
  * [[https://www.tutorialspoint.com/kubernetes/kubernetes_kubectl_commands]]
  * [[https://kubernetes.io/docs/reference/kubectl/cheatsheet/]]
  * [[https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/]]