MyQ X 10.3 enthält ein Upgrade des Traefik-Reverse-Proxys. Die MyQ-eigene Konfiguration wird automatisch migriert. Falls Sie benutzerdefinierte Regeln haben, müssen Sie Ihre Regeldatei bearbeiten, um die v3-Syntax zu verwenden.
Diese Seite ist nur relevant, wenn Sie über eine nicht leere Datei traefik.custom.rules.yaml verfügen (Standardpfad: C:\ProgramData\MyQ\).
Schritte zur Vorbereitung Ihrer benutzerdefinierten Regeldatei
-
Öffnen Sie die Datei
traefik.custom.rules.yaml. -
Überprüfen Sie jede Router-Regel, jede Middleware-Definition und jede TLS-Option anhand des offiziellen Traefik-v3-Migrationsleitfadens: Traefik-v3-Migrationsdokumentation
-
Nehmen Sie die erforderlichen Änderungen vor und speichern Sie die Datei.
-
Führen Sie das MyQ-Upgrade durch.
Häufige Änderungen von v2 auf v3
Die folgende Liste enthält die häufigsten Änderungen. Sie ist nicht vollständig – vergleichen Sie Ihre Datei mit dem offiziellen Traefik-v3-Migrationsleitfaden, um den vollständigen Umfang zu erhalten.
|
v2-Syntax |
Ersatz in v3 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Pfad-Platzhalter |
|
|
Optionen für die Header |
|
|
Header-Option |
|
|
Option |
Entfernt – kein Ersatz |
|
|
Entfernt – kein Ersatz erforderlich |
|
Option |
Entfernt – kein Ersatz |
Beachten Sie bei der Kombination mehrerer Matcher die Prioritätsregeln von v3: Der Operator NOT hat eine höhere Priorität als AND, der wiederum eine höhere Priorität hat als OR.
Traefik v3 kann die v2-Regelsyntax weiterhin verarbeiten, wenn core.defaultRuleSyntax auf v2 gesetzt ist oder wenn die v2-Syntax für einen einzelnen Router konfiguriert ist. Dieser Kompatibilitätsmodus ist veraltet und wird voraussichtlich in der nächsten Hauptversion von Traefik entfernt. Bestehende v2-Regeln funktionieren daher möglicherweise vorübergehend weiterhin, sollten jedoch auf die v3-Syntax umgestellt werden.
Nach dem Upgrade
Überprüfen Sie die Datei C:\ProgramData\MyQ\Logs\traefik.log auf folgende Fehler, die auf verbleibende v2-Syntax in Ihrer benutzerdefinierten Regeldatei hinweisen:
-
error while parsing rule -
headers configuration not valid -
unknown middleware
Sollten solche Fehler auftreten, korrigieren Sie die entsprechenden Einträge und starten Sie Traefik neu.
Siehe auch: