scoreodonto.com/doc/REGISTRY.md

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):

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)

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)

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).