# 📂 Guia de Compartilhamento da Pasta de Instruções entre VPSs

Este documento descreve as melhores estratégias e o passo a passo técnico para que **agentes (humanos, automatizados ou IA)** em outras VPSs da sua rede segura (`10.99.0.0/24`) tenham acesso de leitura e escrita à pasta `/home/deploy/instrucoes`.

Como você já possui uma infraestrutura de rede privada criptografada baseada em **WireGuard**, podemos aproveitar essa segurança para compartilhar os arquivos de forma extremamente protegida e eficiente.

---

## 🗺️ Tabela Comparativa de Abordagens

| Abordagem | Tipo | Sincronização | Segurança | Complexidade | Recomendação |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **1. Git Privado** | Repositório | Manual / CI-CD | 🟢 **Máxima** (Chaves SSH) | 🟡 Baixa | **Altamente Recomendado** para desenvolvimento e IA |
| **2. Syncthing** | P2P Ativo | Instantânea | 🟢 **Excelente** (TLS + VPN) | 🟡 Média | **Ideal** para espelhamento em tempo real bidirecional |
| **3. SSHFS** | Mount Direto | Sob demanda | 🟢 **Excelente** (SSH s/ VPN) | 🟢 Muito Baixa | **Excelente** para montagem rápida sem duplicar arquivos |
| **4. Rsync + Cron** | Script Push/Pull | Periódica | 🟢 **Excelente** (SSH) | 🟢 Muito Baixa | Para espelhamento simples de leitura apenas |

---

## 🕸️ Opção 1: Repositório Git Privado (Recomendado para Agentes & IA)

Esta é a abordagem padrão da indústria. Em vez de compartilhar a pasta fisicamente via rede (o que gera dependência de conexão direta), transformamos a pasta `instrucoes` em um **repositório Git privado** (ex: no GitHub ou GitLab).

### Como funciona:
Cada VPS possui um clone local em `/home/deploy/instrucoes`. Quando um agente ou você altera algo, faz um `git commit` e `git push`. As outras VPSs fazem `git pull`.

### Vantagens para Agentes de IA:
Os agentes de IA (como o Antigravity e outros) lidam nativamente de forma excelente com comandos Git. Isso garante controle de versão, histórico de quem alterou o quê, facilidade de rollback e elimina riscos de corrupção de arquivos por escrita simultânea.

### Passo a Passo de Configuração:

1. **Inicializar o Git localmente na máquina de origem (ex: VPS 1):**
   ```bash
   cd /home/deploy/instrucoes
   git init
   # Adicionar um .gitignore para ignorar arquivos temporários ou chaves sensíveis que não devem subir
   echo "gcal_key.json" >> .gitignore
   echo "ssh_alerts_config.json" >> .gitignore
   git add .
   git commit -m "feat: commit inicial das instrucoes"
   ```

2. **Criar um Repositório Privado** no GitHub/GitLab.

3. **Gerar chaves de acesso SSH (Deploy Keys) nas outras VPSs:**
   Em cada VPS que precisa de acesso, gere uma chave SSH para o usuário `deploy`:
   ```bash
   ssh-keygen -t ed25519 -C "vps-instrucoes-deploy" -f ~/.ssh/id_ed25519_github
   ```
   Adicione a chave pública (`.pub`) gerada como **Deploy Key** (com permissão de escrita, se necessário) nas configurações do repositório no GitHub.

4. **Clonar o repositório nas outras VPSs:**
   ```bash
   cd /home/deploy
   git clone git@github.com:seu-usuario/seu-repositorio.git instrucoes
   ```

5. **Automatizar o Pull (Opcional):**
   Se quiser que as outras VPSs atualizem as instruções automaticamente sempre que houver mudanças no repositório remoto, configure um cronjob de 5 em 5 minutos para rodar o pull:
   ```bash
   crontab -e
   # Adicione a linha abaixo:
   */5 * * * * cd /home/deploy/instrucoes && git pull origin main > /dev/null 2>&1
   ```

---

## 🔄 Opção 2: Syncthing (Sincronização em Tempo Real Descentralizada)

O **Syncthing** é um serviço peer-to-peer de sincronização contínua de arquivos. Ele roda como um daemon leve nas VPSs e garante que qualquer arquivo criado ou modificado em uma pasta seja propagado instantaneamente para as outras em questão de segundos.

### Como configurar de forma segura via VPN WireGuard:

1. **Instalar o Syncthing em todas as VPSs:**
   ```bash
   sudo apt-get update
   sudo apt-get install -y syncthing
   ```

2. **Configurar para escutar apenas no IP da VPN (Zero-Trust):**
   Edite o arquivo de configuração do Syncthing (gerado após a primeira execução em `~/.config/syncthing/config.xml`) e ajuste o endereço da interface gráfica e de sincronização para rodar apenas nos IPs locais ou de VPN, prevenindo exposição pública.
   * Altere a linha do GUI para escutar localmente: `<address>127.0.0.1:8384</address>` (Você pode acessar usando um túnel SSH do seu notebook: `ssh -L 8384:127.0.0.1:8384 deploy@10.99.0.1`).

3. **Adicionar os Servidores como Peers:**
   * No painel do Syncthing da VPS 1, copie o **Device ID**.
   * Adicione esse Device ID no painel da VPS 4/5, especificando o endereço fixo da VPN (ex: `tcp://10.99.0.1:22000`).
   * Compartilhe a pasta `/home/deploy/instrucoes` entre eles.

4. **Habilitar o Serviço na inicialização:**
   ```bash
   sudo systemctl enable syncthing@deploy.service
   sudo systemctl start syncthing@deploy.service
   ```

---

## 🔗 Opção 3: SSHFS (Montagem de Pasta sobre SSH na VPN)

O **SSHFS** permite montar um diretório remoto de um servidor em outro servidor de forma transparente, utilizando o próprio protocolo SSH de transporte. Como a sua porta SSH (22) está aberta e protegida dentro da rede privada da VPN (`10.99.0.0/24`), este método é extremamente simples e não exige serviços extras rodando em segundo plano além do próprio SSH.

### Como configurar:

Digamos que a pasta física está na **VPS 1 (IP `10.99.0.1`)** e você deseja acessá-la em tempo real na **VPS 4 (IP `10.99.0.4`)**:

1. **Instalar o SSHFS na VPS de destino (ex: VPS 4):**
   ```bash
   sudo apt-get update
   sudo apt-get install -y sshfs
   ```

2. **Garantir que o usuário `deploy` da VPS 4 tem acesso SSH sem senha à VPS 1:**
   Adicione a chave SSH pública (`~/.ssh/id_ed25519.pub`) do usuário `deploy` da VPS 4 no arquivo `/home/deploy/.ssh/authorized_keys` da VPS 1.

3. **Criar a pasta de montagem na VPS de destino (VPS 4):**
   ```bash
   mkdir -p /home/deploy/instrucoes
   ```

4. **Montar o diretório manualmente para testar:**
   ```bash
   sshfs deploy@10.99.0.1:/home/deploy/instrucoes /home/deploy/instrucoes -o IdentityFile=/home/deploy/.ssh/id_ed25519 -o allow_other -o reconnect -o ServerAliveInterval=15
   ```

5. **Tornar a montagem permanente pós-reboot (fstab):**
   Adicione a seguinte linha ao final do arquivo `/etc/fstab` na VPS de destino:
   ```text
   deploy@10.99.0.1:/home/deploy/instrucoes /home/deploy/instrucoes fuse.sshfs x-systemd.automount,IdentityFile=/home/deploy/.ssh/id_ed25519,allow_other,reconnect,ServerAliveInterval=15,ServerAliveCountMax=3,_netdev 0 0
   ```

---

## 🚀 Opção 4: Rsync Automatizado via Cron (Espelhamento Simples)

Se os agentes nas outras VPSs precisam apenas ler as instruções ou executar instaladores (como o `install.sh`) e você quer uma solução extremamente leve e direta sem montagens de disco.

### Script de sincronização unidirecional (VPS 1 -> VPS de Destino):

Na **VPS 1**, crie um script simples ou configure uma tarefa recorrente no Cron para enviar as atualizações:

```bash
# Sincroniza a pasta de instruções para a VPS 4 através da VPN segura
rsync -avz --delete -e "ssh -i /home/deploy/.ssh/id_ed25519" /home/deploy/instrucoes/ deploy@10.99.0.4:/home/deploy/instrucoes/
```

Você pode programar isso para rodar a cada hora ou a cada 15 minutos de forma silenciosa e imperceptível.

---

## 🎯 Veredito: Qual escolher?

* **Escolha o Git Privado (Opção 1)** se você deseja que múltiplos agentes (incluindo IAs) façam alterações nos scripts e nos documentos de forma colaborativa, sem riscos de conflitos cegos de escrita e mantendo histórico de auditoria perfeito.
* **Escolha o SSHFS (Opção 3)** se você quer facilidade máxima de implementação imediata: a pasta fica unificada, consome armazenamento físico de apenas uma máquina e reflete edições instantaneamente sem sincronizações adicionais.
