Pular para conteúdo

0027 — Slug de registry onpetro-xls, distinto do app_id

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-09-11 · Decidido em: 2026-08-24

Contexto

Este RD não decide nada novo. A forma do slug (<cliente_id>-<projeto> para app de cliente), a igualdade slug == nome da imagem no registry e a permissão de o slug divergir do app_id são norma da casa — ADR central 0024, que tem este app na tabela de renames da consolidação da frota native. O que faltava era o rastro local.

Decisão

Em 2026-08-24 (commit eddd800, junto do build native no modelo Docker), o slug passou de bi-comercial-xls a onpetro-xls:

  • docs/app.json slug: onpetro-xls, a imagem fonte.xadm.biz/xadm/onpetro-xls (o IMAGE do pipeline.yml) e a doc em https://docs.xadm.biz/aplicacoes/onpetro-xls/ (o site_url do mkdocs.yml).
  • O app_id segue bi-comercial-xls: é a identidade do app no broker (grants, provisão), e renomeá-lo quebraria os grants. O AUTH_ISSUER da sessão também não mudou, pelo mesmo motivo.

Consequências

  • Imagem e doc atendem por onpetro-xls. No central-backend e na Central de Apps, o app segue sendo bi-comercial-xls. A divergência é a que a norma prevê, não acidente.
  • O control-plane casa o recurso Coolify pelo slug da imagem (ADR central 0026, decisão local 0026), não pelo app_id. Por isso o pipeline.yml e o recurso Coolify têm de usar onpetro-xls.
  • Um rename futuro do slug é cosmético (docs + registry). O app_id não se renomeia.
  • Este RD é ponteiro: divergência de mérito sobre a nomenclatura se resolve no ADR central 0024, não aqui.