Archon/DEPLOY_ARGOCD_SUMMARY.md
Luis Erlacher d36597fe43
Some checks failed
Build Images / build-server-docker (push) Has been cancelled
Build Images / build-mcp-docker (push) Has been cancelled
Build Images / build-agents-docker (push) Has been cancelled
Build Images / build-frontend-docker (push) Has been cancelled
Build Images / build-server-k8s (push) Has been cancelled
Build Images / build-mcp-k8s (push) Has been cancelled
Build Images / build-agents-k8s (push) Has been cancelled
Build Images / build-frontend-k8s (push) Has been cancelled
feat(config): Add sprint and workflow management configuration
Introduced new sections in core-config.yaml for managing sprints and workflows:
- Defined locations for sprint documentation and current sprint file.
- Added workflow management settings including current workflow file and templates.
- Included AI agent context configuration for better context management.

This enhancement supports improved organization and tracking of project workflows and sprints.
2025-10-28 14:41:00 -03:00

9.0 KiB

Resumo Executivo - Deploy Archon via ArgoCD

Status Atual

ArgoCD CLI instalado e conectado Aplicação Archon localizada e analisada Problemas identificados Manifestos corrigidos criados

Problemas Encontrados

🔴 Críticos

  1. ConfigMap vazio - Todas as variáveis de ambiente faltando
  2. MCP sem comunicação com backend - Tentava localhost:8181 em vez do service Kubernetes
  3. Deployment de Agents ausente - Serviço não configurado

🟡 Importantes

  1. Variáveis de ambiente incompletas em todos os deployments
  2. Ingress sem path para agents

Correções Aplicadas

Arquivos Criados em /home/luis/projetos/Archon/k8s-argocd/

  1. configmap.yaml - ConfigMap preenchido com todas as variáveis
  2. deployment-server.yaml - Deployment do backend com variáveis corretas
  3. deployment-mcp.yaml - MCP com API_SERVICE_URL e AGENTS_SERVICE_URL
  4. deployment-agents.yaml - Novo deployment para AI agents
  5. deployment-frontend.yaml - Frontend mantido com ajustes
  6. service-server.yaml - Service para backend
  7. service-mcp.yaml - Service para MCP
  8. service-agents.yaml - Novo service para agents
  9. service-frontend.yaml - Service para frontend
  10. ingress.yaml - Ingress com novo path /agents
  11. kustomization.yaml - Kustomize config
  12. README.md - Documentação completa

Documentação Criada

  • ARCHON_ARGOCD_DIAGNOSTIC.md - Diagnóstico detalhado completo
  • DEPLOY_ARGOCD_SUMMARY.md - Este arquivo (resumo executivo)

Próximos Passos

Passo 1: Atualizar Repositório Git

Você precisa copiar os manifestos para o repositório k8s-templates:

# Clone o repositório (se ainda não tiver)
git clone git@github.com:LuisErlacher/k8s-templates.git
cd k8s-templates

# Faça backup do diretório atual
mv apps/custom/archon/base apps/custom/archon/base.backup

# Copie os novos manifestos
cp -r /home/luis/projetos/Archon/k8s-argocd apps/custom/archon/base

# Commit e push
git add apps/custom/archon/base/
git commit -m "fix: Corrige configuração do Archon

- Preenche ConfigMap com todas as variáveis necessárias
- Adiciona API_SERVICE_URL no MCP para comunicação interna
- Adiciona deployment e service do archon-agents
- Atualiza ingress com path /agents
- Corrige variáveis de ambiente em todos os deployments

Closes: Problemas de conectividade entre MCP e backend"

git push origin main

Passo 2: Sync no ArgoCD

Após o push, faça sync da aplicação:

# Já logado no ArgoCD
argocd app sync argocd/archon --prune

Passo 3: Verificar Deploy

# Verificar status
argocd app get argocd/archon

# Ver logs do MCP (deve mostrar conexão OK)
argocd app logs argocd/archon --kind Deployment --name archon-mcp --tail 50

# Ver logs do novo agents
argocd app logs argocd/archon --kind Deployment --name archon-agents --tail 50

Passo 4: Testar Endpoints

# Health checks
curl https://archon.automatizase.com.br/health
curl https://archon.automatizase.com.br/api/health
curl https://archon.automatizase.com.br/agents/health

# Frontend
curl -I https://archon.automatizase.com.br/

O Que Foi Corrigido

ConfigMap (Antes vs Depois)

Antes:

apiVersion: v1
kind: ConfigMap
metadata:
  name: archon-config
# VAZIO - sem data!

Depois:

apiVersion: v1
kind: ConfigMap
metadata:
  name: archon-config
data:
  ARCHON_SERVER_PORT: "8181"
  ARCHON_MCP_PORT: "8051"
  ARCHON_AGENTS_PORT: "8052"
  HOST: "archon.automatizase.com.br"
  SERVICE_DISCOVERY_MODE: "kubernetes"
  LOG_LEVEL: "INFO"

MCP Deployment (Variáveis Críticas Adicionadas)

Adicionado:

- name: API_SERVICE_URL
  value: http://archon-server-service:8181  # ← CRÍTICO! Era localhost antes
- name: AGENTS_ENABLED
  value: "true"
- name: AGENTS_SERVICE_URL
  value: http://archon-agents-service:8052
- name: TRANSPORT
  value: "sse"

Agents Deployment (Novo)

Criado completamente novo:

  • Image: coleam00/archon-agents:latest
  • Port: 8052
  • Resources: 500m CPU / 1Gi RAM → 2 CPU / 4Gi RAM
  • Health checks configurados
  • Conectado ao Supabase

Ingress (Path Adicionado)

Adicionado:

- path: /agents
  pathType: Prefix
  backend:
    service:
      name: archon-agents-service
      port:
        number: 8052

Recursos Totais

Antes

  • 8 recursos principais
  • ConfigMap vazio
  • 3 deployments (server, mcp, frontend)
  • 3 services
  • 1 ingress

Depois

  • 11 recursos principais
  • ConfigMap preenchido
  • 4 deployments (server, mcp, agents, frontend)
  • 4 services
  • 1 ingress (com path /agents)

Logs Esperados Após Correção

MCP (Antes - Com Erro)

2025-10-07 23:38:57 | mcp | WARNING | API service health check failed: All connection attempts failed
2025-10-07 23:38:57 | __main__ | WARNING | Health check failed: {'status': 'degraded', 'api_service': False, 'agents_service': False}

MCP (Depois - Esperado)

2025-10-27 XX:XX:XX | mcp | INFO | API service health check: OK
2025-10-27 XX:XX:XX | mcp | INFO | Agents service health check: OK
2025-10-27 XX:XX:XX | __main__ | INFO | Health check success: {'status': 'healthy', 'api_service': True, 'agents_service': True}

Arquitetura de Serviços

┌─────────────────────────────────────────────────────┐
│                     Ingress                          │
│        archon.automatizase.com.br                   │
└──────────────┬──────────────────────────────────────┘
               │
       ┌───────┴────────┬─────────┬──────────┬────────┐
       │                │         │          │        │
   /api & /health    /socket.io  /mcp    /agents    /
       │                │         │          │        │
       v                v         v          v        v
┌──────────────┐  ┌─────────┐ ┌─────┐  ┌────────┐ ┌──────────┐
│   Backend    │  │ Backend │ │ MCP │  │ Agents │ │ Frontend │
│   :8181      │  │ :8181   │ │:8051│  │ :8052  │ │  :3737   │
└──────────────┘  └─────────┘ └──┬──┘  └───┬────┘ └──────────┘
                                  │         │
                                  │ Comunicação Interna
                                  │         │
                       ┌──────────┴─────────┴──────────┐
                       │ archon-server-service:8181    │
                       │ archon-agents-service:8052    │
                       └───────────────────────────────┘

Checklist de Verificação

Após o deploy, verifique:

Troubleshooting

Se MCP ainda mostrar erro de conexão

  1. Verificar se o service backend está acessível:

    kubectl run -it --rm debug --image=curlimages/curl --restart=Never -n automatizase -- \
      curl http://archon-server-service:8181/health
    
  2. Verificar logs do MCP em detalhes:

    argocd app logs argocd/archon --kind Deployment --name archon-mcp --tail 200
    

Se Agents não iniciar

  1. Verificar secret do Supabase:

    kubectl get secret supabase-jwt -n automatizase -o yaml
    
  2. Verificar logs:

    argocd app logs argocd/archon --kind Deployment --name archon-agents --tail 100
    

Se Sync falhar

  1. Ver detalhes do erro:

    argocd app get argocd/archon
    
  2. Verificar diff:

    argocd app diff argocd/archon
    

Contatos e Referências

Arquivos de Referência

  • k8s-argocd/README.md - Instruções detalhadas
  • ARCHON_ARGOCD_DIAGNOSTIC.md - Diagnóstico completo
  • k8s-argocd/*.yaml - Manifestos corrigidos

Status: Pronto para deploy Data: 2025-10-27 Criado por: Claude Code (Archon deployment fix)