MyQ X Server
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish

Migrazione delle regole personalizzate di Traefik

MyQ X 10.3 include un aggiornamento del proxy inverso Traefik. La configurazione propria di MyQ viene migrata automaticamente. Se si dispone di regole personalizzate, è necessario modificare il file delle regole per utilizzare la sintassi v3.

Questa pagina è rilevante solo se si dispone di un file non vuoto traefik.custom.rules.yaml (posizione predefinita C:\ProgramData\MyQ\).


Procedura per preparare il file delle regole personalizzate

  1. Aprire il file traefik.custom.rules.yaml.

  2. Verificare ogni regola del router, definizione di middleware e opzione TLS confrontandole con la guida ufficiale alla migrazione a Traefik v3: Documentazione sulla migrazione a Traefik V3

  3. Applicare le modifiche richieste e salvare il file.

  4. Eseguire l’aggiornamento di MyQ.

Modifiche comuni dalla v2 alla v3

L’elenco riportato di seguito illustra le modifiche più comuni. Non è esaustivo: si raccomanda di verificare il proprio file confrontandolo con la guida ufficiale alla migrazione a Traefik v3 per l’elenco completo.

Sintassi v2

Sostituzione nella v3

ipWhiteList middleware

ipAllowList

Host("a", "b") (corrispondenze a più valori)

Host("a") || Host("b") (valore singolo con OR)

Headers(...) / HeadersRegexp(...)

Header(...) / HeaderRegexp(...)

HostHeader(...)

Host(...)

PathPrefix("/foo", "/bar")

PathPrefix("/foo") || PathPrefix("/bar")

PathPrefix con espressioni regolari

PathRegexp("...")

Segnaposto del percorso {name} all’interno dei comparatori

PathRegexp("...") con un’espressione regolare Go

sslRedirect, sslTemporaryRedirect, sslHost, sslForceHost opzioni delle intestazioni

redirectScheme middleware

featurePolicy Opzione delle intestazioni

permissionsPolicy

stripPrefix opzione forceSlash

Rimosso - nessun sostituto

tls.options.default.preferServerCipherSuites

Rimosso - non è necessaria alcuna sostituzione

tls.caOptional opzione

Rimosso - nessun sostituto

Quando si combinano più matcher, note le regole di precedenza della v3: l’operatore NOT ha una precedenza maggiore rispetto all’operatore AND, il quale a sua volta ha una precedenza maggiore rispetto all’operatore OR.

<P>Traefik v3 è ancora in grado di elaborare la sintassi delle regole v2 quando l’opzione <CODE_INLINE> core.defaultRuleSyntax </CODE_INLINE> è impostata su <CODE_INLINE> v2 </CODE_INLINE> o quando la sintassi v2 è configurata per un singolo router. Questa modalità di compatibilità è deprecata e dovrebbe essere rimossa nella prossima versione principale di Traefik. Le regole v2 esistenti potrebbero quindi continuare a funzionare temporaneamente, ma dovrebbero essere migrate alla sintassi v3.</P>

Dopo l’aggiornamento

Verificare in C:\ProgramData\MyQ\Logs\traefik.log la presenza dei seguenti errori, che indicano la presenza di sintassi v2 residua nel file di regole personalizzate:

  • error while parsing rule

  • headers configuration not valid

  • unknown middleware

Se ne dovesse comparire qualcuno, correggere le voci pertinenti e riavviare Traefik.