wiki/HowtoK3s.md
Tom David--Broglio e84577b01b HowtoK3s wip
2024-01-22 19:11:31 +01:00

79 lines
2.3 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
categories: sysadmin
title: HowtoK3s
...
* Documentation : <https://docs.k3s.io/>
K3s est une distribution de Kubernetes légère et facile à installer (packagé dans un seul binaire).
On peut installer Kubernetes avec different composants, avec K3s, Rancher a fait un certain nombre de choix par défaut sur pour ses composant ce qui va grandement simplifier l'installation.
## Installation
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 >= 5.8
* Vérifier la version de iptable installée https://docs.k3s.io/known-issues#iptables
* 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
$ 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
~~~
## Configuration
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
## Optimisation
## Monitoring
### Nagios
### Munin
## Plomberie
## FAQ