# `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 # escreve

Isso torna seguro explorar qualquer comando de edicao antes de decidir.

# Inspecao (read-only)

# `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.

# Routers de label (v2.174.0+)

Quando o provider docker esta ativo na configuracao estatica, scan, inspect domain, routers-list e domains-list leem tambem os labels traefik.http.routers.* dos containers. O scan ganha o campo label_router_count. Sem docker, o comando segue so com o arquivo e avisa traefik_labels_indisponivel no stderr.

Limitacao: provider docker ligado por flag ou variavel de ambiente do Traefik, e nao pela estatica, nao e detectado.

# Diagnostico

O check traefik_regra_duplicada acusa o mesmo Host() em router de arquivo e em router de label cujos entrypoints se cruzam e cuja priority efetiva empata (a explicita ou, sem ela, o tamanho da regra). A remediacao e dar uma --priority distinta a um dos dois, por exemplo no router-create:

runner traefik router-create meu-router --rule 'Host(`app.exemplo.com`)' \
  --service meu-service --file app.yml --priority 2000 --apply

runner traefik doctor
runner traefik doctor --check <nome>     # uma checagem so

# Edicao de dominios

# Edicao de routers e services

# Configuracao estatica e recuperacao

# `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

# Ver tambem

• `runner doctor` — saude do servidor, nao do Traefik
• `runner health`
• instances — pesos de trafego pela via do Runner