traefik

History

Quentin Duchemin 570d35d2e3 [Traefik] Enable access logs		2020-12-01 20:55:00 +01:00
..
docker-compose.yml	[Traefik] Create a common network for Traefik and services	2020-09-04 14:47:29 +02:00
README.md	[Traefik] Add wiki link	2020-10-13 12:06:35 +02:00
traefik_dynamic.toml	[Peertube] Put CSP for iframe and CORS headers in file for re-use	2020-12-01 20:13:06 +01:00
traefik.toml	[Traefik] Enable access logs	2020-12-01 20:55:00 +01:00

README.md

Traefik

Ce dossier contient les ressources nécessaires pour lancer Traefik, un reverse proxy adapté pour Docker. C'est la pièce la plus importante de l'infrastructure, puisque l'ensemble des communications HTTP(S) passent d'abord par Traefik, et il est aussi utilisé pour générer des certificats pour les services TCP.

Ce service doit être lancé sur l'ensemble des machines de l'infrastructure.

Les explications sont sur le Wiki et doivent être modifiées en cas de changement majeur de configuration : https://wiki.picasoft.net/doku.php?id=technique:docker:general:traefik

Configuration

La configuration a lieu dans les fichiers traefik.toml et traefik_dynamic.toml. Notez que toute modification dans ce fichier impactera l'ensemble des machines, puisque le même fichier est utilisé pour l'ensemble des machines.

À des fins de tests, il peut être modifié localement sur les machines, mais doit toujours rester synchronisé avec ce dépôt à long terme.

Pour la génération des certificats, Traefik utilise Let's Encrypt. Il n'y a aucune configuration à faire de ce côté. Attention, le nombre de certificats générables est limité à 50 par semaine.

Si on lance plein de conteneurs de tests, on utilisera temporairement l'environnement de qualification de Let's Encrypt, en ajoutant la directive caServer = "https://acme-staging-v02.api.letsencrypt.org/directory" sous la section [certificatesResolvers.letsencrypt.acme].

Lancement

Au premier lancement, assurez-vous que :

Le dossier /DATA/docker/traefik/certs existe
Créez un fichier acme.json à l'intérieur
Changez son propriétaire à root
Changez ses permissions à 600

C'est dans ce fichier que seront conservés tous les certificats générés par Traefik.

Mise à jour

Il suffit de mettre à jour le tag de l'image dans Compose. Lire la documentation sur les mises à jour mineures pour voir s'il y a des opérations à effectuer ou des options dépréciées.

La mise à jour vers Traefik v2 a été effectuée ; quelques détails sont à consulter sur le wiki.