Plataforma de Desenvolvimento de IA para Homelab: OpenCode + GitOps para Atualizações de Contêineres Mais Seguras

Um operador de homelab construiu uma plataforma de desenvolvimento de IA em torno do modo servidor web do OpenCode, colocando o código gerado por IA por trás de revisões de PR e implantando via GitOps. O objetivo: reduzir a sobrecarga manual de manter uma dúzia de stacks Docker Compose, mantendo código não revisado fora da produção.

Configuração

A plataforma roda em uma VM simples no TrueNAS com ferramentas básicas de desenvolvimento. O OpenCode é instalado como uma unidade systemd, expondo uma interface web com terminal embutido, navegador de arquivos, diffs Git e suporte a Git worktree para sessões de codificação paralelas. O servidor possui seu próprio usuário no servidor Git com chaves SSH dedicadas — ele pode clonar projetos e enviar branches, mas não pode fazer push diretamente para o branch de implantação.

A VM tem acesso à internet e conectividade com o servidor Git, mas não tem acesso de rede aos serviços reais. Isso minimiza o raio de explosão, permitindo que o autor conceda acesso root ao OpenCode quando ele precisa instalar ferramentas de compilação ou dependências de teste.

Fluxo de Trabalho

1. Planeje o recurso ou melhoria no OpenCode: especificação, plano de implementação, auto-revisões.
2. Teste ou verifique as alterações quando possível.
3. Itere com o OpenCode em coisas que precisam de ajustes.
4. O OpenCode envia as alterações para um branch de recurso.
5. O proprietário abre e mescla um PR após revisão.
6. GitOps assume: Arcane para alterações de serviço Docker, plugin GitOps para configuração do Home Assistant, workers do Cloudflare Pages para atualizações do blog.

Ganhos Concretos

O caso de uso mais impactante até agora: atualizações de contêineres. Anteriormente, o autor gastava horas por ciclo de atualização lendo notas de versão para cada serviço, verificando mudanças que quebram compatibilidade, executando atualizações e verificando serviços manualmente. Agora o OpenCode produz um resumo das notas de versão em minutos, tornando as atualizações de versão mais rápidas e seguras. A IA também adicionou healthchecks à maioria dos contêineres, acelerando a detecção de problemas.

Peça Faltante: Feedback de CI

A configuração carece de integração com CI. No GitHub, o autor apontaria um agente de codificação para logs do Actions para diagnosticar testes com falha, erros de linter, stack traces e mudanças no plano de IaC. O Forgejo (servidor Git auto-hospedado) não expõe logs de jobs através da API pública, embora APIs não documentadas existam. O autor considera essa a principal lacuna.

Conclusão

Esta é uma plataforma de IA para homelab pragmática e com consciência de segurança. Ela permite que o proprietário faça alterações na infraestrutura de qualquer dispositivo (incluindo celular) sem dar acesso direto da IA aos serviços de produção. O atrito da revisão de PR e a VM isolada tornam-na segura o suficiente para uso pessoal, enquanto destacam a lacuna no feedback de CI para servidores Git auto-hospedados.