Migrer les règles Traefik personnalisées | MyQ X Server (Print Server)

MyQ X 10.3 inclut une mise à jour du proxy inverse Traefik. La configuration propre à MyQ est migrée automatiquement. Si vous disposez de règles personnalisées, vous devez modifier votre fichier de règles afin d’utiliser la syntaxe de la version 3.

Cette page ne vous concerne que si vous disposez d’un fichier traefik.custom.rules.yaml non vide (emplacement par défaut : C:\ProgramData\MyQ\).

Étapes de préparation de votre fichier de règles personnalisées

Ouvrez le fichier traefik.custom.rules.yaml.
Vérifiez chaque règle de routeur, chaque définition de middleware et chaque option TLS à l’aide du guide officiel de migration vers Traefik v3 : Documentation sur la migration vers Traefik v3
Appliquez les modifications requises et enregistrez le fichier.
Exécutez la mise à niveau de MyQ.

Modifications courantes entre la v2 et la v3

La liste ci-dessous répertorie les modifications les plus courantes. Elle n’est pas exhaustive : veuillez recouper votre fichier avec le guide officiel de migration vers Traefik v3 pour obtenir la liste complète.

Syntaxe v2	Remplacement en v3
`ipWhiteList` middleware	`ipAllowList`
`Host("a", "b")` (correspondances à valeurs multiples)	`Host("a") \|\| Host("b")` (valeur unique avec « OR »)
`Headers(...)` / `HeadersRegexp(...)`	`Header(...)` / `HeaderRegexp(...)`
`HostHeader(...)`	`Host(...)`
`PathPrefix("/foo", "/bar")`	`PathPrefix("/foo") \|\| PathPrefix("/bar")`
`PathPrefix` avec des expressions régulières	`PathRegexp("...")`
`{name}` des espaces réservés de chemin d’accès à l’intérieur des opérateurs de correspondance	`PathRegexp("...")` avec une expression régulière Go
`sslRedirect`, `sslTemporaryRedirect`, `sslHost`, `sslForceHost`, options d’en-têtes	`redirectScheme` middleware
`featurePolicy` option d’en-têtes	`permissionsPolicy`
`stripPrefix` option `forceSlash`	Supprimé – aucun remplacement
`tls.options.default.preferServerCipherSuites`	Supprimé – aucun remplacement nécessaire
`tls.caOptional` option	Supprimée – aucun remplacement

Lorsque vous combinez plusieurs opérateurs de correspondance, tenez compte des règles de priorité de la v3 : l’opérateur NOT a une priorité plus élevée que l’opérateur AND, qui a lui-même une priorité plus élevée que l’opérateur OR.

Traefik v3 peut toujours traiter la syntaxe des règles v2 lorsque l’option core.defaultRuleSyntax est définie sur v2 ou lorsque la syntaxe v2 est configurée pour un routeur individuel. Ce mode de compatibilité est obsolète et devrait être supprimé dans la prochaine version majeure de Traefik. Les règles v2 existantes peuvent donc continuer à fonctionner temporairement, mais elles doivent être migrées vers la syntaxe v3.

Après la mise à niveau

Vérifiez C:\ProgramData\MyQ\Logs\traefik.log pour détecter les erreurs suivantes, qui indiquent la présence de syntaxe v2 résiduelle dans votre fichier de règles personnalisées :

error while parsing rule
headers configuration not valid
unknown middleware

Si l’une d’entre elles apparaît, corrigez les entrées concernées et redémarrez Traefik.

Voir également :

Documentation sur la migration vers Traefik V3