Garage (object storage S3)

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-09-12

Aplica-se a: perfil app que guarda arquivo, e todo repo que publica site.

O Garage é o object storage S3-compatível da X-Adm, em https://arquivo-api.xadm.biz. É recurso compartilhado: uma key e um bucket por app (ex. onpetro, vantroba).

Regras de uso

• O app fala S3 padrão (path-style), pela xadm-comum-storage quando é server Micronaut.
• O app não cria bucket nem key: quem provisiona é o central-backend, pela Central de Apps, quando a capacidade é ligada. A key do app tem leitura e escrita no bucket dele.
• A região do cliente S3 bate com o s3_region do Garage (garage).
• As credenciais são env Secret do recurso Coolify.

Variáveis típicas num app

O broker do /xadm-setup injeta as envs com o prefixo GARAGE_:

Variável	Exemplo
GARAGE_ENDPOINT	https://arquivo-api.xadm.biz
GARAGE_BUCKET	vantroba
GARAGE_REGION	garage
GARAGE_ACCESS_KEY_ID / GARAGE_SECRET_ACCESS_KEY	(Secret)

Consumo num app Micronaut: Java/Micronaut. O que cada app guarda no Garage é doc de projeto do próprio app.

O bucket docs-sites

A documentação usa um bucket único (docs-sites, um prefixo por app) com duas keys fixas:

Key	Acesso	Onde está
escrita	write em docs-sites	secrets DOCS_S3_* de cada repo no GitHub, mantidos iguais por um laço de gh secret set a partir de uma fonte única (Segurança §Segredos)
leitura	read em docs-sites	envs DOCS_S3_* do site central no Coolify

Repo novo que publica docs não ganha key nova: recebe os três DOCS_S3_* pelo mesmo laço (Publicar docs).