Atualizar sync rules do PowerSync

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-07-06

Atualizar sync rules do PowerSync

Este guia explica como aplicar alterações ao config.yaml (sync rules e restantes opções) depois de um commit no repositório.

1. Modelo atual: uma pasta por cliente

O Compose está em powersync/<cliente>/ (ex.: powersync/sulplata/), com config.yaml na mesma pasta. No servidor, trabalha-se dentro dessa pasta (ou cópia equivalente).

cd /caminho/para/powersync/sulplata

(Ajusta o caminho: clone do mono-repo em /xadm/integrador, ou só a pasta desdobrada em /xadm/powersync-sulplata, etc.)

2. Atualizar ficheiros

• git pull (ou copiar o config.yaml novo para esta pasta).

3. Aplicar (só o PowerSync)

O config.yaml monta-se só no serviço powersync; o Mongo não precisa de reinício para mudanças de sync rules.

docker compose restart powersync

Se precisares de recriar o container:

docker compose up -d powersync

Evita docker compose down em todo o stack só por mudança de YAML — ver Fase 5 — runbook.

4. Verificar

docker compose ps
docker compose logs -f powersync

5. docker compose down -v

Não uses -v em produção sem ler o runbook — remove o volume do Mongo desse cliente. Ver migration-phase5-powersync-runbook.md.