37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# 🤖 Instruções para Agentes Gemini
|
|
|
|
Este arquivo contém diretrizes críticas para qualquer agente de IA que interaja com este repositório.
|
|
|
|
## 🚀 Workflow de Deploy (OBRIGATÓRIO)
|
|
|
|
**NUNCA faça commit direto na branch `producao` sem antes validar a configuração.**
|
|
|
|
O repositório conta com um script de automação híbrido (`producao/scripts/deploy_pathfinder.py`) que deve ser usado para **todo e qualquer deploy**.
|
|
|
|
### Passo a Passo para Agentes:
|
|
|
|
1. **Faça suas alterações** nos arquivos de configuração (`nginx/`).
|
|
2. **Valide e Deploye** rodando o script abaixo no terminal do Windows:
|
|
```powershell
|
|
python producao/scripts/deploy_pathfinder.py sync --all
|
|
```
|
|
3. **Verifique a Saída**:
|
|
- O script fará o upload, testará a configuração (`nginx -t`) no servidor e fará o reload.
|
|
- Se houver erro, **corrija antes de prosseguir**. O script fará rollback automático no servidor, mas seu código local estará "quebrado".
|
|
4. **Commit**: Somente após o sucesso do comando acima ("Deploy Remoto Concluído com Sucesso!"), faça o commit das alterações.
|
|
|
|
## 🛠️ Comandos Úteis
|
|
|
|
- **Sincronizar Tudo (Nginx + Fail2Ban + GeoIP)**:
|
|
`python producao/scripts/deploy_pathfinder.py sync --all`
|
|
- **Deploy de Novo Site**:
|
|
`python producao/scripts/deploy_pathfinder.py site --deploy dominio.com`
|
|
- **Atualizar GeoIP Manualmente**:
|
|
`python producao/scripts/deploy_pathfinder.py geoip --update`
|
|
|
|
## ⚠️ Pontos de Atenção
|
|
|
|
- **GeoIP**: O script baixa automaticamente os bancos GeoIP se faltarem. Não precisa baixar manualmente.
|
|
- **Paramiko**: O script usa `paramiko` para SSH. Se não estiver instalado, instale com `pip install paramiko`.
|
|
- **Credenciais**: As credenciais de acesso ao servidor estão embutidas no cabeçalho do script. Não as exponha em logs públicos.
|