From beeea9bab4098996e8b0045d59fb4dd1b714e12b Mon Sep 17 00:00:00 2001 From: Rui Date: Sun, 17 May 2026 09:38:03 +0200 Subject: [PATCH] docs: add new project auto-config protocol to doutrina_agentes --- global/doutrina_agentes.md | 26 ++++++++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/global/doutrina_agentes.md b/global/doutrina_agentes.md index 0d43f0c..b123ce8 100644 --- a/global/doutrina_agentes.md +++ b/global/doutrina_agentes.md @@ -37,15 +37,33 @@ Todo arquivo `.vps_identity` deve conter exatamente a seguinte estrutura: - **Nível de Perigo BAIXO** (ex: VPS 4): O agente possui total autonomia para realizar testes, compilar códigos, reinstalar pacotes e reiniciar contêineres Docker de staging. 3. **Resiliência (Fallback)**: Caso o arquivo `.vps_identity` não exista ou esteja ilegível, o agente deve fazer o fallback dinâmico (buscando o IP `10.99.x.x` via `hostname -I`) e assumir o perfil de segurança mais restritivo por padrão. -## 🗣️ Comunicação -- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**. -- Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs. - ## 🚫 NUNCA... - Nunca tente acessar servidores fora da rede 10.99.0.x. - Nunca exponha senhas ou chaves privadas em logs ou comentários. - Nunca altere o serviço `swarm-listener` sem autorização. +## 🔄 Protocolo de Criação e Configuração de Novos Projetos (Auto-Config de Webhook) + +Sempre que um novo projeto for criado no ecossistema Swarm, os agentes e desenvolvedores **devem** seguir e configurar automaticamente a seguinte rotina de integração de CI/CD para que o GitOps funcione perfeitamente: + +### 1. Criação Obrigatória do Webhook de Deploy +Todo novo repositório criado no Gitea **DEVE** possuir um Webhook de deploy ativo configurado da seguinte forma: +* **URL de Destino**: `http://10.99.0.3:5000/webhook` (Se configurado externamente) ou `http://127.0.0.1:5000/webhook` (Se configurado de dentro da VPS 3). +* **Tipo de Conteúdo**: `application/json` +* **Segredo (Secret)**: Em branco ou chave secreta padrão. +* **Eventos que disparam**: Apenas o evento de **Push** (Commit enviado). + +> [!IMPORTANT] +> **Autonomia do Agente (Auto-Identificação)**: +> Se você (o Agente de IA) identificar que está trabalhando em um **novo projeto** ou que o repositório do projeto atual **não possui** o webhook do Swarm Dispatcher (`http://127.0.0.1:5000/webhook`) configurado no Gitea: +> 1. Você **DEVE** usar a API REST do Gitea para criar ou corrigir esse webhook automaticamente. +> 2. Você **DEVE** garantir a criação do arquivo `.vps_identity` apropriado nas VPSs correspondentes. +> 3. Você **DEVE** estruturar o `docker-compose.yml` do projeto sob a pasta `/home/deploy/stack//` seguindo o padrão rootless. + +## 🗣️ Comunicação +- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**. +- Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs. + ## 📂 Diretórios de Projetos e Stacks Ativos (Mapeamento de Preservação) ### 🖥️ VPS 1 - Produção (10.99.0.1)