Colliers × Costal — Interno

Sync Options — Google Drive ↔ git

Leitura de 3 min

Sync Options | Google Drive ↔ git

governanca publicacao infra

O vault vive em Google Drive (para o time Obsidian). O Quartz precisa do conteúdo em um repo git. Este documento compara 3 caminhos.

Trade-offs em uma tabela

OpçãoEsforço inicialManutençãoRisco de conflitoDrive canônico?
A. rclone em CI (recomendado)30 minbaixabaixosim
B. obsidian-git plugin15 minbaixamédionão (repo vira canônico)
C. Mover vault p/ repo + Obsidian Sync2 hbaixamuito baixonão (repo vira canônico, adeus Drive)

A. rclone em CI (recomendado)

Como funciona: GitHub Action roda diariamente (+ webhook opcional). Baixa o vault do Drive via rclone sync, commita em content/, dispara build.

Prós:

  • Vault permanece canônico no Drive — time não muda rotina
  • Simples: um secret + um comando rclone
  • Fácil de auditar (cada sync gera commit)
  • Zero custo adicional

Contras:

  • Atraso de até 24h entre edição e publicação (configurável: cron mais frequente)
  • Conflitos se alguém edita content/ manualmente no repo (resolve com rclone sync sobrescrevendo)

Setup:

  1. Instalar rclone localmente: brew install rclone (Mac)
  2. Configurar remote Google Drive: 
    rclone config
# escolher "n" (new remote), nome: gdrive, type: drive, acessar URL
  3. Pegar conteúdo do config: 
    cat ~/.config/rclone/rclone.conf
  4. Criar secret VAULT_REMOTE_CONFIG no GitHub com esse conteúdo (todo o arquivo)
  5. Workflow já está em workflows/wiki.yml — job sync-vault

Cadência:

  • Default no workflow: 06:00 UTC diário (cron: "0 6 * * *") + manual dispatch
  • Mais frequente: mudar para "0 */4 * * *" (a cada 4h) ou "*/30 * * * *" (a cada 30 min — gasta budget Action)

B. obsidian-git plugin

Como funciona: plugin Obsidian autocommita o vault para um repo git em tempo real (ou intervalo configurado).

Prós:

  • Publicação quase em tempo real
  • Cada mudança = commit rastreável

Contras:

  • Conflito com Google Drive sync — plugin faz git pull/push no mesmo diretório que Drive está syncando. Drive pode sobrescrever .git ou vice-versa.
  • Recomenda-se sair do Drive e usar Obsidian Sync (pago) ou git como único mecanismo
  • Setup exige mudar rotina do time

Setup (se escolher esta opção):

  1. Mover vault para fora de Google Drive (ou configurar Drive para ignorar .git)
  2. Instalar plugin via Community Plugins do Obsidian → “Obsidian Git”
  3. Configurar: Auto commit-and-sync interval: 5 minutes, Commit message: "docs: vault update"

Não recomendado para este projeto enquanto o time estiver habituado a Drive.

C. Mover vault para o repo + Obsidian Sync

Como funciona: vault passa a viver diretamente no repo git. Time usa Obsidian Sync (oficial, pago ~US$ 8/mês) ou git manual.

Prós:

  • Zero conflitos
  • Publicação imediata a cada commit
  • Histórico git nativo (blame, diff)

Contras:

  • Migração custosa
  • Drive perde status de canônico (mudança cultural para o time)
  • Custo recorrente de Obsidian Sync (ou dependência de git para devs)
  • Perde acesso Drive-como-compartilhamento (quem não for dev perde facilidade)

Setup:

  1. Criar repo Anouk-Partners/colliers-costal-vault (privado, separado do repo wiki)
  2. git clone + copiar conteúdo do Drive
  3. Desabilitar sync Drive para essa pasta
  4. Cada membro: habilitar Obsidian Sync (ou cada um roda git pull/push)

Recomendação

Opção A (rclone em CI) — é a mais compatível com o status quo do time, preserva o vault em Drive como canônico, e é setup de 30 min.

Evoluir para opção B ou C apenas se:

  • Publicação em tempo real virar requisito claro
  • Time migrar para workflow 100% git

Testes mínimos para validar a opção escolhida

Para A (rclone):

# teste local antes de colocar em CI
rclone sync "gdrive:Colliers_Projeto" ./content-test --dry-run
# deve listar arquivos que entrariam

Para B (obsidian-git): editar nota simples → aguardar commit → ver no repo.

Para C: criar nota → git pull outro dispositivo → verificar chegada.

Ver também

Visão de gráfico

Backlinks