`runner traefik`
CLI para inspecionar e editar a configuracao do Traefik que o Runner gerencia. E o maior grupo do binario — 30 subcomandos.
A regra que vale para o grupo inteiro
Tudo e dry-run por padrao. Os 16 subcomandos que mutam so escrevem com --apply;
sem ela mostram o diff e nao tocam na configuracao.
runner traefik domain-add meu-router novo.dominio.com # mostra o diff
runner traefik domain-add meu-router novo.dominio.com --apply # escreveIsso torna seguro explorar qualquer comando de edicao antes de decidir.
Inspecao (read-only)
| Subcomando | O que faz |
|---|---|
info |
Instancia de Traefik descoberta + config resolvida |
scan |
Snapshot de todos os providers ativos (file + api + docker labels) |
schema |
JSON Schema de um recurso de saida |
routers-list |
Lista routers |
services-list |
Lista services |
middlewares-list |
Lista middlewares |
domains-list |
Lista os dominios unicos |
inspect |
Inspeciona um domain, router, service ou file |
api |
Debug cru da API do Traefik (ping, overview, routers, services, certs) |
diff |
Diff pendente entre o HEAD do journal e o disco |
`scan` cobre os tres providers
Um sintoma comum — "o dominio responde mas nao esta no meu arquivo" — vem de a rota
existir em outro provider. O scan olha os tres de uma vez: arquivo, API e labels
de container.
Diagnostico
| Subcomando | O que faz |
|---|---|
doctor |
Roda as 12 checagens padrao |
history |
Inspeciona o historico (list, show, snapshot-show) |
validate |
Valida um conjunto de ops e roda o preflight — com --apply, aplica |
runner traefik doctor
runner traefik doctor --check <nome> # uma checagem soEdicao de dominios
| Subcomando | O que faz |
|---|---|
domain-add |
Acrescenta um dominio a regra de um router |
domain-remove |
Remove um dominio da regra |
domain-replace |
Troca um host literal por outro (--scope, --router) |
Edicao de routers e services
| Subcomando | O que faz |
|---|---|
router-create |
Cria um router via flags (--rule, --service, --file) |
router-delete |
Remove um router |
router-edit-rule |
Edita a regra de um router |
service-target |
Aponta o service de um router para uma URL de backend |
service-weight |
Define pesos explicitos num service ponderado |
service-bluegreen-init |
Inicializa um service ponderado blue/green |
service-promote |
Promove um slot blue/green a 100% |
middleware-attach |
Anexa um middleware a um router |
middleware-detach |
Remove um middleware de um router |
Configuracao estatica e recuperacao
| Subcomando | O que faz |
|---|---|
static |
Editor da config estatica (get, set-api, set-log-level, set-access-log, set-entry-point) |
adopt |
Adota um arquivo nao gerenciado sob um id logico |
rollback |
Volta para um snapshot anterior |
failover-switch |
Chave de failover manual |
`adopt` traz um arquivo para o controle do runner
Configuracao escrita a mao antes do Runner existir fica fora do journal — e portanto
fora do diff, do history e do rollback. O adopt a registra sob um id logico, e a
partir dai ela participa dos mesmos mecanismos.
Flags comuns
| Flag | Descricao |
|---|---|
--apply |
Escreve a mudanca. Sem ela, dry-run: mostra o diff e nao toca na config |
--json |
Output em JSON |
-o, --output |
human | json | yaml |
Ver tambem
- `runner doctor` — saude do servidor, nao do Traefik
- `runner health`
- instances — pesos de trafego pela via do Runner
By Borlot.com.br on 19/08/2026