0035 — Adota a chamada app a app pela URL pública com DNS local (ADR central 0039)¶
Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-10-01 · Decidido em: 2026-10-01
Decisão local do central-backend que aponta a decisão CENTRAL 0039 da casa. Os números não se correspondem.
Contexto¶
O central-backend chama outros serviços da casa pelo domínio público: a API do Coolify
(COOLIFY_API_URL), o GlitchTip (SENTRY_DSN e a API de provisionamento), o Garage e o site de docs.
Com dois registros A na zona *.xadm.biz, o hairpin NAT de dentro do host falha por um deles, e a
varredura do ADR central 0039 listou o central-backend entre os apps nesse caminho.
Decisão¶
Desde 2026-10-01 o central-backend segue o ADR central 0039: toda chamada a outro app da casa sai pela
URL pública vinda de env, e o recurso no Coolify leva --dns 10.0.1.1 --dns 1.1.1.1 em Custom Docker
Options, o que faz o xadm-dns do host resolver os *.xadm.biz locais para o Traefik. Na conferência de
2026-10-01 (docker inspect no host), o container em produção já estava com Dns=[10.0.1.1 1.1.1.1].
O banco segue pelo nome do serviço Docker (postgresql:5432), exceção que o ADR mantém.
Consequências¶
- Nenhum código muda: as URLs já vinham de env. O passo entrou no runbook de deploy.
- A
COOLIFY_API_URLde produção seguehttps://admin.xadm.biz/api/v1, que funciona porque a allowlist da API tem10.0.1.0/24. O ADR apontahttp://coolify:8080como preferível (sem TLS nem allowlist); a troca é de env, sem código, e fica para quando houver motivo. - O ADR deixa como pendência do control-plane avisar, no deploy, recurso sem
--dns. O control-plane é este serviço; o aviso não foi implementado. - Este RD é ponteiro: divergência de mérito se resolve no ADR central 0039.