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

Migrar regras personalizadas do Traefik

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

  1. Abra o arquivo `traefik.custom.rules.yaml`.

  2. 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

  3. Aplique as alterações necessárias e salve o arquivo.

  4. 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 ipWhiteList

ipAllowList

Host("a", "b") (comparadores de múltiplos valores)

Host("a") || Host("b") (valor único com OR)

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

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

HostHeader(...)

Host(...)

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

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

PathPrefix com expressões regulares

PathRegexp("...")

Espaços reservados de caminho {name} dentro de comparadores

PathRegexp("..."), com uma expressão regular do Go

Opções de cabeçalhos sslRedirect, sslTemporaryRedirect, sslHost e sslForceHost

Middleware redirectScheme

Opção de cabeçalho featurePolicy

permissionsPolicy

Opção stripPrefix forceSlash

Removido — sem substituição

tls.options.default.preferServerCipherSuites

Removido — não é necessário substituto

Opção tls.caOptional

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.