O MyQ X 10.3 inclui uma atualização do proxy reverso Traefik. A configuração do próprio MyQ é migrada automaticamente. Caso tenha regras personalizadas, será necessário editar seu arquivo de regras para utilizar a sintaxe da versão 3.
Esta página é relevante apenas se o senhor tiver um arquivo `traefik.custom.rules.yaml` não vazio (localização padrão: `C:\ProgramData\MyQ\`).
Etapas para preparar seu arquivo de regras personalizadas
-
Abra o arquivo `
traefik.custom.rules.yaml`. -
Revise todas as regras de roteador, definições de middleware e opções de TLS de acordo com o guia oficial de migração do Traefik v3: Documentação de migração do Traefik V3
-
Aplique as alterações necessárias e salve o arquivo.
-
Execute a atualização do MyQ.
Alterações comuns da v2 para a v3
A lista abaixo abrange as alterações mais comuns. Ela não é exaustiva — verifique seu arquivo em relação ao guia oficial de migração do Traefik v3 para obter o conjunto completo.
|
Sintaxe da v2 |
Substituição na v3 |
|---|---|
|
Middleware |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Espaços reservados de caminho |
|
|
Opções de cabeçalhos |
Middleware |
|
Opção de cabeçalho |
|
|
Opção |
Removido — sem substituição |
|
|
Removido — não é necessário substituto |
|
Opção |
Removida — sem substituto |
Ao combinar vários comparadores, observe as regras de precedência da v3: o operador NOT tem precedência sobre o AND, que, por sua vez, tem precedência sobre o OR.
O Traefik v3 ainda pode processar a sintaxe de regras da v2 quando `core.defaultRuleSyntax` estiver definido como `v2` ou quando a sintaxe da v2 estiver configurada para um roteador específico. Esse modo de compatibilidade está obsoleto e deverá ser removido na próxima versão principal do Traefik. As regras existentes da v2 podem, portanto, continuar funcionando temporariamente, mas devem ser migradas para a sintaxe da v3.
Após a atualização
Verifique o arquivo `C:\ProgramData\MyQ\Logs\traefik.log` quanto aos seguintes erros, que indicam a presença de sintaxe v2 remanescente em seu arquivo de regras personalizadas:
-
error while parsing rule -
headers configuration not valid -
unknown middleware
Caso algum deles apareça, corrija as entradas relevantes e reinicie o Traefik.
Veja também: