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
-
Aprire il file
traefik.custom.rules.yaml. -
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
-
Applicare le modifiche richieste e salvare il file.
-
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Segnaposto del percorso |
|
|
|
|
|
|
|
|
|
Rimosso - nessun sostituto |
|
|
Rimosso - non è necessaria alcuna sostituzione |
|
|
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.
Vedi anche: