Traefik est un proxy inverse conçu à la base pour des infrastructures ayant des conteneurs (avec du Docker ou Kubernetes). Néanmoins, il est possible de le faire fonctionner directement via le binaire et de profiter de ses capacités des machines n'ayant pas de systÚme de conteneurisation.

L'intĂ©rĂȘt d'utiliser le binaire plutĂŽt que le conteneur peut se discuter longuement, mais ce n'est pas l'objectif ici. Pas de prĂ©sentation ni de rĂ©flexion autour de Traefik dans cette documentation, si vous recherchez une prĂ©sentation ça se passe lĂ -bas.

Préparation du systÚme

Commencez par télécharger le binaire depuis le dépÎt GitHub traefik : https://github.com/containous/traefik/releases. J'utiliserai la version 2.6.6 et une VM ayant comme base une Debian 11.2. Les tests ont aussi été réalisés avec succÚs sur une Ubuntu 20.04.2.

cd /tmp && wget https://github.com/traefik/traefik/releases/download/v2.6.6/traefik_v2.6.6_linux_amd64.tar.gz && tar xzvf traefik_v2.6.6_linux_amd64.tar.gz

Pour tester son fonctionnement rapidement, lancez le binaire et regardez les ports en Ă©coute sur votre machine :

./traefik
ss -ntlp # doit retourner ce genre d'informations :

LISTEN  0       128                  *:80                  *:*      users:(("traefik",pid=450,fd=3))  

Sans fichier de configuration ni autre option, Traefik écoutera par défaut sur le port 80. Il n'y aura ni redirection automatique, pas de gestion du TLS, aucune redirection vers vos services internes, pas d'accÚs au tableau de bord ou autres options... Uniquement une écoute sur le port 80.

Copions le binaire dans l'emplacement systÚme étudié pour, avec les droits d'exécution et le propriétaire "root" :

cp /tmp/traefik /usr/bin/.
chown root: /usr/bin/traefik
chmod 755 /usr/bin/traefik

L'utilisateur root est nĂ©cessaire. En effet, Traefik doit avoir un maximum de privilĂšges systĂšme pour se mettre en Ă©coute sur les ports systĂšme, notamment le 80 et le 443. À l'avenir, j'Ă©tudierai la possibilitĂ© de se passer de l'utilisateur et des droits root.

Tout comme la version docker, Traefik utilise l'utilisateur "traefik" et le dossier par défaut /etc/traefik pour ses fichiers de configuration.
AprÚs avoir téléchargé le binaire, il faut recréer cette configuration (dossiers, utilisateur, droits).

groupadd traefik
useradd -g traefik --no-user-group -d /etc/traefik --no-create-home -s /usr/sbin/nologin -r traefik

mkdir -p /etc/traefik/dynamic
chown -R traefik: /etc/traefik/.

touch /var/log/traefik.log && chown traefik: /var/log/traefik.log

Dans mes précédents fichiers de configuration pour Traefik, j'utilise le dossier /etc/traefik/dynamic pour y stocker les configurations dites "dynamiques".

Le fichier de log se situe dans le dossier /var/log, qui est le chemin habituel. La configuration principale de Traefik se trouvera dans le dossier racine (/etc/traefik) et les configurations personnalisées seront dans le dossier dynamic.

Préparation pour Traefik

Générons maintenant le fichier de configuration principal, ici le fichier /etc/traefik/traefik.yml.

---
global:
  sendAnonymousUsage: false
  checkNewVersion: false

api:
  dashboard: true

pilot:
  dashboard: false

log:
  filePath: "/var/log/traefik.log"
  format: json
  level: "ERROR"

providers:
  file:
    directory: "/etc/traefik/dynamic"
    watch: true

entryPoints:
  web:
    address: ":80"
    #http:
      #redirections:
        #entryPoint:
          #to: websecure
          #scheme: https
  websecure:
    address: ":443"

J'ai commenté la partie redirection automatique HTTP vers HTTPS, à titre indicatif. Ce bloc n'est pas nécessaire ici pour le premier démarrage.

À prĂ©sent, crĂ©ons le fichier service pour systemd Ă  l'emplacement /lib/systemd/system/. Voici le contenu du nouveau fichier traefik.service :

# /lib/systemd/system/traefik.service
[Unit]
Description=traefik service
After=network-online.target

[Service]
Type=simple
User=root
Group=root
Restart=on-failure
TimeoutStopSec=300
ExecStart=/usr/bin/traefik --configFile=/etc/traefik/traefik.yml

[Install]
WantedBy=multi-user.target

Ajoutons les droits au fichier, mettons Ă  jour la base systemd et lancement !

chown root: /lib/systemd/system/traefik.service && chmod 644 /lib/systemd/system/traefik.service

systemctl daemon-reload && systemctl start traefik.service

À prĂ©sent, Traefik doit ĂȘtre actif et prĂȘt Ă  rediriger vos requĂȘtes. Le fichier de configuration traefik.yml citĂ© plus haut est vraiment basique, mais fonctionnel.

Pour accĂ©der au tableau de bord, ouvrez un navigateur et saisissez l'adresse IP de votre serveur suivi du port 8080. Traefik est dĂ©sormais fonctionnel et prĂȘt Ă  l'emploi. À prĂ©sent, il est temps de configurer quelques routeurs pour accĂ©der Ă  vos services
 !

traefik dashboard
Tableau de bord web de Traefik

Bonus - Ansible

Installer manuellement est une chose, pratique pour "se faire la main" et comprendre la mise en place. J'ai créé un rÎle Ansible pour installer Traefik, qui est en fait un résumé de cet article. Tout est récupérable directement dans ce dépÎt GitHub : https://github.com/Mettmett/ansible-traefik

Partager l'article