Skip to content

fix: keep Caddy up across app-only seeder releases - #731

Open
rodrigopavezi wants to merge 2 commits into
mainfrom
fix/caddy-stays-up
Open

rodrigopavezi wants to merge 2 commits into
mainfrom
fix/caddy-stays-up

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Na atualização por imagem (pull), toda versão recriava o Caddy, porque a imagem web trazia o commit. Cada recriação derrubava todos os apps com um 1006 seco, sem a espera de discagem do #718. Esta é a etapa P1 da fase B (implantação do semeador sem porta escura).

  • o release publica a imagem assinada ghcr.io/varanda-org/varanda-caddy (de deploy/seeder/Dockerfile.caddy, refeita só quando esse arquivo muda) e grava o digest dela em /app/caddy.json dentro da imagem assinada do semeador. O release.json não muda: os servidores instalados conferem esse arquivo com uma expressão exata, e um campo novo os faria recusar toda versão;
  • no perfil full, o update.sh roda o web com essa imagem, monta o Caddyfile por um caminho que só muda com o conteúdo e o app pelo link /opt/varanda-release/web, trocado de uma vez;
  • a ordem é semeador e conta, depois a troca do link, e o Caddy só é recriado quando o digest dele ou o Caddyfile mudou;
  • a verificação de saúde de 180 s continua, e a volta põe de novo o Caddy, o Caddyfile e o link anteriores;
  • uma versão sem caddy.json segue o modo antigo. Um erro do Docker ao ler o arquivo adia a versão, sem cair no modo antigo;
  • o deploy.sh (SSH) monta o app novo ao lado e o troca arquivo a arquivo por rename, com index.html por último, em vez de esvaziar o www com o Caddy servindo. Um passo que falha faz a volta falhar, e um link no caminho nunca é seguido.

Este PR mexe em CI e implantação (release.yml, Dockerfile, update.sh, deploy.sh): quem mantém faz o merge.

Antes da segunda versão com caddy.json, quem mantém precisa tornar público o pacote varanda-caddy. Sem isso, os servidores não baixam a imagem e ficam na versão atual, tentando a cada ciclo.

Limites conhecidos (detalhes em docs/verification/fix-caddy-stays-up.md):

  • nenhuma VM real foi exercitada. Não está verificado que o Compose real deixa o web em paz quando só o diretório da versão muda, nem que o Caddy segue o link /srv/web a cada pedido;
  • num servidor que já atualiza por imagem, a primeira versão com caddy.json é aplicada pelo update.sh antigo, que recria o Caddy como hoje. A segunda o recria uma última vez, porque os binds mudam. Daí em diante ele fica de pé;
  • o caminho SSH ainda recria o Caddy em todo deploy. Só a troca do www ficou atômica;
  • o Caddy passa a ler /opt/varanda-release inteiro, só leitura. São os pacotes públicos das versões; os segredos ficam em /var/lib/varanda-update;
  • a primeira publicação do pacote novo não foi executada.

Issue

Closes # (não há issue aberta para este problema)

Como verificar

node apps/cli/test/update.test.js
node apps/cli/test/release.test.js
node apps/cli/test/deploy.test.js
node apps/cli/test/caddyfile.test.js
bash -n deploy/seeder/update.sh deploy/seeder/deploy.sh

Checklist

  • npm run lint, npm test (ou npm test -- --affected=origin/main) e npm run demo passam
  • docs/protocol.md ou docs/rpc.md atualizados, se um formato mudou
  • Entrada do changelog em docs/changelog/<branch>.md e verificação em docs/verification/<branch>.md, se houver, sem editar o CHANGELOG.md nem acrescentar seção ao docs/verification.md
  • Textos para o usuário estão em pt-BR
  • Conferido no Android (emulador ou aparelho) e no simulador iOS antes da web/PWA, ou explicado por que não se aplica: não se aplica; a mudança é só na implantação do servidor
  • Nenhum segredo, chave ou dado pessoal no diff

On the pull/release path every release recreated the web (Caddy)
container, because the web image baked the commit, so every app client
dropped with a bare 1006 and nothing held its redial.

release.yml now builds a separately pinned, signed varanda-caddy image
(rebuilt only when Dockerfile.caddy changes) and records its digest in
/app/caddy.json inside the signed seeder image; release.json is
unchanged, so installed servers keep accepting releases. In the full
profile update.sh runs web from that image, binds the Caddyfile from a
content-addressed path and serves www through an atomically swapped
link, brings up seeder and account first, and recreates web only when
the Caddy digest or the Caddyfile changed. The health gate and rollback
are kept; rollback restores the previous Caddy. A release without
caddy.json runs in the old mode.

deploy.sh now stages the app beside www and merges it file by file with
renames (index.html last) instead of emptying www while Caddy serves it.
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 08:47

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant