Préparation du fichier de configuration

Création du dossier de configuration de k3s

sudo mkdir -p /etc/rancher/k3s

sudo vim /etc/rancher/k3s/config.yaml

bind-address: "172.31.10.20"
write-kubeconfig-mode: "0644"
tls-san:
  - "172.31.10.20"
  - "k3s.gmolab.net"

bind-address détermine sur quelle adresse IP l'API k3s écoute. Par défaut l'adresse ip est 127.0.0.0.

Important

L'adresse IP doit être également renseignée dans le tls-san. Sinon vous ne pourrez pas gérer votre cluster

write-kubeconfig-mode détermine les permissions du fichier kubeconfig (/etc/rancher/k3s/k3s.yaml) généré par k3s.

C'est pratique sur un homelab, mais il faut être conscient de l'aspect sécurité.

Attention

Pour de la production priviliéger 0600

tls-san permet d’indiquer les adresses IP et les noms DNS (FQDN) utilisés par les clients pour accéder au serveur k3s.

Cela ne sert à rien d'y renseigner les adresses IP des clients eux-mêmes.

Tip

tls-san = « Sous quels noms ou adresses mon serveur k3s peut-il être appelé ? »

Important

Prenez soin de remplacer k3s.gmolab.net et 172.31.10.20 par le FQDN et l'adresse IP de votre serveur k3s

Version	Date	Change	Auteur
1.0	11.09.2026	Création	GMo