VPS 4 Deploy Agent
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
# Deploy — Versionamento e saúde
|
|
|
|
> Situação: **como a versão é definida e onde ela aparece; como checar saúde.**
|
|
|
|
## Versão
|
|
- A versão é **definida pela tag git** (`vX.Y.Z`) — **não** se escreve versão à mão em arquivo (não existe mais `constants.ts`/`update-version.js`).
|
|
- `commit`/`build` são carimbados no **build** da imagem (imutáveis); `version`/`environment` são **injetados no deploy em runtime** (a partir da tag).
|
|
- Em **DEV** a versão aparece como `dev` (não há release); o número só existe em produção.
|
|
|
|
## Onde a versão aparece (tudo em runtime, lendo `/api/version`)
|
|
- **`vX.Y.Z` fixo no canto inferior direito** de toda página.
|
|
- Tela de **Configurações → "Sobre o sistema"**.
|
|
- O frontend **não embute** versão — consome `GET /api/version`. Fonte única = backend.
|
|
|
|
## Endpoints
|
|
- **`GET /api/version`** → `{ name, version, commit, build, environment }`.
|
|
- **`GET /api/health`** → `{ status, version, commit, environment, uptime_s, checks }`.
|
|
- **banco** é crítico: se cair → `status: down` + **HTTP 503**.
|
|
- **cache** é opcional: se cair → `status: degraded` (HTTP 200); `disabled` se desligado.
|