From e84577b01b2f0335895e747d12c4cfc2aada71fd Mon Sep 17 00:00:00 2001
From: Tom David--Broglio <tdavid+git@evolix.fr>
Date: Mon, 22 Jan 2024 19:11:31 +0100
Subject: [PATCH] HowtoK3s wip

---
 HowtoK3s.md | 45 +++++++++++++++++++++++++++++++++++++++------
 1 file changed, 39 insertions(+), 6 deletions(-)

diff --git a/HowtoK3s.md b/HowtoK3s.md
index 0f382964..0d116bf8 100644
--- a/HowtoK3s.md
+++ b/HowtoK3s.md
@@ -10,13 +10,37 @@ On peut installer Kubernetes avec different composants, avec K3s, Rancher a fait
 
 ## Installation
 
-Documentation : TODO:lien
+Documentation : <https://docs.k3s.io/quick-start> et <https://docs.k3s.io/installation>
 
 Prérequis :
 
-* Il faut avoir un noyau récent qui supporte les CGroupv2
+* Il faut avoir un noyau récent qui supporte les CGroupv2 >= 5.8
 * Vérifier la version de iptable installée https://docs.k3s.io/known-issues#iptables
-* désactiver ufw si ou minifirewall ( les regels iptables de k3s passerons devant )
+* Désactiver ufw si présent (les règles iptables de k3s passerons devant) 
+* Il faut mettre minifirewall à DOCKER='on'
+
+> Attention k3s rajoutera ses regles iptables par-dessus; il faut faire attention a ce qu'on expose si la machine est sur internet.
+
+Pour installer on peut simplement jouer le script d'installation qui va récupérer le binaire et mettre en place l'unitée systemd ou openrc.
+
+~~~{.bash}
+### Installer
+# curl -sfL https://get.k3s.io | sh -
+### Installer, configurer et lancer avec des arguement (exemple)
+curl -sfL https://get.k3s.io | K3S_TOKEN=12345 sh -s - server --flannel-backend none
+~~~
+
+On peut ensuite lancer k3s en mode server ou agent avec des options de configurations
+
+~~~{.bash}
+k3s server ...
+~~~
+
+### Mise à jour
+
+On peut rejouer le script d'installation ou installer le binaire d'une version en particulier :
+
+> **Attention** : si à l'installation on à joué le script d'installation argument, il ne faut pas en donné cette fois-ci ! autrement ils ecraseront les anciens argument.
 
 ~~~{.bash}
 # Installer le binaire d'une release https://github.com/k3s-io/k3s/releases
@@ -24,11 +48,20 @@ $ tag=v1.29.0+k3s1
 $ curl -Lo /usr/local/bin/k3s https://github.com/k3s-io/k3s/releases/download/${tag}/k3s; chmod a+x /usr/local/bin/k3s
 ~~~
 
-Lancer en moder server ou agent avec des options de configurations
-
 ## Configuration
 
-Documentation : TODO
+Selon les besoins, on peut configuer K3s de différentes manière en même temps :
+
+* Au lancement avec des ENVs et argument
+
+* Avec un fichier de configuration dans `/etc/rancher/k3s/config.yaml` ou des fichiers dans `/etc/rancher/k3s/config.yaml.d/*.yaml`
+
+~~~{.ini}
+### /etc/rancher/k3s/config.yaml
+write-kubeconfig-mode: "0644"
+disable: 
+  - servicelb
+~~~
 
 ## Administration