VPS 4 Builder
5049ce9b8b
- Pasta única scoreodonto.com/doc/ com 9 docs que prestam: VERDADE-HOJE (estado, principal), DEPLOY-PRODUCAO (runbook), BANCO-DEV-ESTRATEGIA, REGISTRY, AUDITORIA-FUNCIONAL, BACKLOG-FINANCEIRO-V1, CRM_Ortodontia, RX_ARQUITETURA, RX_BACKLOG. - Removidos os docs de infra sobrepostos/desatualizados (estado consolidado em VERDADE-HOJE; histórico fica no git): arquitetura.md, deploy.md, CHECKLIST-DEPLOY-PRODUCAO.md, PENDENCIAS.md, PENDENCIAS_E_DEPLOY.md. - Pasta documentação/ eliminada. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
90 lines
3.8 KiB
Markdown
90 lines
3.8 KiB
Markdown
# Registry de imagens — Container Registry do Gitea
|
|
|
|
> **Estado: ATIVO e validado** (16/jun/2026, Etapa 4). Não há serviço novo a manter: usamos o **Container Registry embutido do Gitea** (v1.26.1) na VPS3.
|
|
|
|
---
|
|
|
|
## 1. O que é
|
|
|
|
O Gitea já expõe um **registry OCI/Docker** nativo. Não foi preciso instalar `registry:2` nem tocar em `daemon.json`/`insecure-registries`. As imagens do ScoreOdonto ficam versionadas junto do código, no mesmo Gitea que é a fonte da verdade.
|
|
|
|
| Item | Valor |
|
|
|------|-------|
|
|
| Endereço (push/pull) | **`git.clube67.com`** (HTTPS, TLS válido via Traefik) |
|
|
| Namespace | `ruicesar/` (dono do repo no Gitea) |
|
|
| Alternativa interna | `10.99.0.3:3000` — **NÃO usar**: HTTP exige `insecure-registries` + restart do Docker (derruba produção) |
|
|
| Auth | usuário Gitea + **token** com escopo `write:package` / `read:package` |
|
|
|
|
> Usamos sempre o domínio **HTTPS** justamente para **não** precisar reconfigurar nem reiniciar o Docker em VPS4/VPS1 (Live Restore está desligado → restart bouncearia todos os containers).
|
|
|
|
---
|
|
|
|
## 2. Login (uma vez por máquina)
|
|
|
|
Em cada máquina que vai dar push/pull (VPS4 builda; VPS1 consome):
|
|
|
|
```bash
|
|
docker login git.clube67.com -u <usuario_gitea>
|
|
# senha = TOKEN do Gitea (Configurações → Aplicações → Gerar Token, escopos write:package + read:package)
|
|
```
|
|
|
|
A credencial fica no keystore do Docker (`~/.docker/config.json`). **Nunca** colocar token em código, doc, script ou log. Se um token vazar (ex.: colado em chat), **revogue no Gitea** e gere outro.
|
|
|
|
---
|
|
|
|
## 3. Convenção de nomes
|
|
|
|
```
|
|
git.clube67.com/ruicesar/scoreodonto-backend:<versão>
|
|
git.clube67.com/ruicesar/scoreodonto-frontend:<versão>
|
|
```
|
|
|
|
- `<versão>` = semver com o mesmo valor de `APP_VERSION` (ex.: `v1.0.13`).
|
|
- Mantém-se também a tag móvel `:latest` apontando para a última.
|
|
- A tag semântica é o que a **Etapa 6 (deploy por tag)** usa para promover à produção.
|
|
|
|
---
|
|
|
|
## 4. Build + push (fluxo manual de hoje, na VPS4)
|
|
|
|
```bash
|
|
cd /home/deploy/stack/scoreodonto.com
|
|
export APP_VERSION=$(grep -oE 'V[0-9]+\.[0-9]+\.[0-9]+' frontend/constants.ts | head -1)
|
|
export GIT_COMMIT=$(git rev-parse --short HEAD)
|
|
export BUILD_TIME=$(date -u +'%Y-%m-%d %H:%M UTC')
|
|
export APP_ENV=PROD # ou DEV para imagens de teste
|
|
|
|
docker compose build scoreodonto-backend scoreodonto-frontend
|
|
|
|
V=$(echo "$APP_VERSION" | tr 'V' 'v') # V1.0.13 -> v1.0.13
|
|
docker tag scoreodontocom-scoreodonto-backend:latest git.clube67.com/ruicesar/scoreodonto-backend:$V
|
|
docker tag scoreodontocom-scoreodonto-frontend:latest git.clube67.com/ruicesar/scoreodonto-frontend:$V
|
|
docker push git.clube67.com/ruicesar/scoreodonto-backend:$V
|
|
docker push git.clube67.com/ruicesar/scoreodonto-frontend:$V
|
|
```
|
|
|
|
> ⚠️ **HTTP 499 em camada grande = timeout transitório do proxy.** O push é resumível: basta **repetir o `docker push`** que as camadas já enviadas são puladas e a faltante completa. (Visto e contornado na validação inicial.)
|
|
|
|
---
|
|
|
|
## 5. Pull (na VPS1, quando a Etapa 6 estiver pronta)
|
|
|
|
```bash
|
|
export DOCKER_HOST=unix:///run/user/1000/docker.sock
|
|
docker pull git.clube67.com/ruicesar/scoreodonto-backend:v1.0.13
|
|
docker pull git.clube67.com/ruicesar/scoreodonto-frontend:v1.0.13
|
|
# depois: compose apontando para essas imagens + docker compose up -d
|
|
```
|
|
|
|
Rollback = `docker pull` da tag anterior + `up -d`. Sem rebuild.
|
|
|
|
---
|
|
|
|
## 6. Validação feita (16/jun/2026)
|
|
|
|
- `docker login git.clube67.com` (usuário `ruicesar`) → **Login Succeeded**.
|
|
- Push de `scoreodonto-backend:v1.0.13`/`:latest` e `scoreodonto-frontend:v1.0.13`/`:latest` → OK (com 1 retry por 499 transitório).
|
|
- Teste de pull (remover tag local + `docker pull`) → **Downloaded** OK.
|
|
|
|
Próximos: **Etapa 5** (automatizar build+push no Gitea Actions) e **Etapa 6** (deploy por tag na VPS1 consumindo este registry).
|