# Ecossistema CCS

O Runner faz parte do ecossistema CCS (Cloud Container Systems), um conjunto de ferramentas para automacao de infraestrutura.

# Componentes do Ecossistema

┌─────────────────────────────────────────────────────────────────┐
│                     ECOSSISTEMA CCS                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐        │
│  │  Runner  │  │ DeployAlly│  │BackupAlly│  │  GitOps  │        │
│  │  CI/CD   │  │  Deploy   │  │  Backup   │  │ Content  │        │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘        │
│       │             │             │             │                │
│       └─────────────┴─────────────┴─────────────┘                │
│                            │                                     │
│                            v                                     │
│                     ┌──────────┐                                │
│                     │  Implant │                                │
│                     │  Client  │                                │
│                     └────┬─────┘                                │
│                          │                                       │
│                          v                                       │
│                     ┌──────────┐                                │
│                     │   CDN    │                                │
│                     │ Storage  │                                │
│                     └──────────┘                                │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

# Runner

Funcao: Automacao de CI/CD

Responsabilidades:

• Deploy automatizado via Git
• Blue-green deployment
• Canary deployments
• Staging de PRs
• Notificacoes
• Integracao MCP com Claude Code

Integracao:

• Usa Traefik para routing
• Docker para containers
• GitHub para codigo
• Telegram/Discord para notificacoes

# DeployAlly

Funcao: Deploy multi-servidor

Quando usar:

• Multiplos servidores de producao
• Load balancing manual
• Deploys coordenados

vs Runner:

• Runner: single-server, automatico via Git
• DeployAlly: multi-server, comandos manuais

# BackupAlly

Funcao: Backup automatizado

Responsabilidades:

• Backup de bancos de dados
• Backup de arquivos
• Retencao configuravel
• Upload para cloud (B2, S3)

Integracao com Runner:

• Backup antes de deploy (opcional)
• Backup de versoes antigas

# GitOps

Funcao: Distribuicao de conteudo

Responsabilidades:

• Sincronizar releases do GitHub com CDN
• Distribuir binarios e documentacao
• Manter versoes historicas

Usado por:

• Runner (download de binarios)
• Implant (download de ferramentas)
• Documentacao (PimDocs)

# Implant

Funcao: Cliente de linha de comando

Responsabilidades:

• Download de ferramentas CCS
• Instalacao automatica
• Atualizacao de binarios
• Configuracao de ambiente

Exemplo:

# Instalar Runner
implant install runner

# Instalar BackupAlly
implant install backupally

# Atualizar todos
implant update

# CDN / Storage

Funcao: Armazenamento e distribuicao

Tecnologia: Backblaze B2 + Cloudflare

Conteudo:

• Binarios de ferramentas
• Documentacao (PimDocs)
• Assets de aplicacoes

URLs:

• Binarios: get.ccs.systems/{tool}
• Docs: docs.ccs.systems/{tool}

# Fluxo de Deploy Completo

1. DESENVOLVIMENTO
   └── Codigo em dev
   └── Tests locais

2. RELEASE
   └── Merge para main
   └── Tag vX.Y.Z

3. BUILD
   └── Build local
   └── Artefatos em dist

4. DEPLOY (Runner)
   └── Push na dist
   └── Runner detecta
   └── Pipeline executa
   └── Traefik roteia

5. BACKUP (BackupAlly)
   └── Backup agendado
   └── Upload para B2

6. MONITORIA
   └── Health checks
   └── Logs
   └── Notificacoes

# Integracao MCP

O ecossistema CCS expoe ferramentas via MCP para Claude Code:

Uso no Claude Code:

User: Liste as apps do Runner

Claude: [usa runner_list_apps]
        Apps registradas:
        - meu-app
        - outro-app

# Labels CCS

Containers usam labels padronizadas:

ccs.systems/project: meu-app
ccs.systems/instance: production
ccs.systems/version: v1.0.0
ccs.systems/type: sys
ccs.systems/env: production

Uso:

# Listar por projeto
docker ps --filter "label=ccs.systems/project=meu-app"

# Listar por ambiente
docker ps --filter "label=ccs.systems/env=production"

# Proximos Passos

O ecossistema esta em expansao:

• MCP Server para BackupAlly
• MCP Server para DeployAlly
• Dashboard unificado
• Metricas centralizadas
• Alertas integrados