O deploy foi aceito, mas a resposta sumiu: um experimento com Hermes e CapRover
Imagine pedir uma atualização, o servidor aceitar o deploy e a conexão cair antes de entregar a resposta. Do lado de quem pediu, apareceu um erro. Do lado do servidor, a aplicação pode já estar sendo atualizada.
Repetir a requisição parece uma solução simples, mas significa executar outra operação sem saber o resultado da primeira. Esse foi o cenário que escolhi explorar no CapRover Operator, um plugin que desenvolvi com assistência de agentes de IA para o hackathon do Hermes Agent.
A motivação vem do self-hosted: projetos open-source precisam conseguir operar o software na infraestrutura que escolheram. Ter acesso ao código é importante; conseguir revisar uma atualização e entender o que aconteceu depois dela também é.
Escolhi o CapRover porque ele já oferece uma base concreta para isso: aplicações existentes, deploy de imagens de contêiner e estado observável. O plugin acrescenta um fluxo pela conversa com o Hermes, limitado a uma aplicação configurada pelo operador.
O funcionamento ficou assim:
- Ler o estado atual e salvar um plano com a imagem pretendida, identificada por digest.
- Exigir a aprovação nativa do Hermes antes da execução.
- Registrar o consumo do plano em SQLite, reler o estado e recusar a operação se houver mudanças em relação ao plano.
- Fazer, no máximo, uma tentativa de requisição de deploy para aquele plano. Se o resultado ficar incerto, consultar o servidor explicitamente.
A ordem do registro importa. Ele é persistido antes da possível escrita no servidor. Se o processo morrer ou a resposta desaparecer, reiniciar o Hermes não torna aquele mesmo plano disponível para outra tentativa.
Isso tem limites: a releitura anterior ao deploy é uma verificação separada da escrita. Outro operador pode alterar a aplicação entre as duas requisições. Não existe atualização condicional no servidor, coordenação entre máquinas independentes ou garantia distribuída de execução exatamente uma vez.
Para validar o comportamento, o laboratório descartável usou CapRover 1.16.0 e uma atualização real do CyberChef 11.4.0 para 11.5.0. A confirmação foi descartada deliberadamente depois de o backend aceitar a requisição. O Hermes foi reiniciado, a repetição do mesmo plano foi recusada e a reconciliação consultou o resultado. A execução registrou uma requisição de deploy feita pelo plugin.
Outra decisão importante: HTTP 200 não prova que a imagem nova está rodando. A versão anterior pode continuar respondendo durante a atualização. Nesse ensaio, foram conferidos separadamente os metadados, a imagem solicitada nas tarefas em execução, uma réplica funcionando e a resposta HTTP.
Essas evidências são observações datadas. Não demonstram que uma migração de banco funcionou, nem garantem disponibilidade futura. A versão atual também não cria aplicações nem faz rollback automático.
O projeto está em desenvolvimento, sob licença MIT, com código e instalação no GitHub. A validação documentada e a demo narrada de 64 segundos estão públicas.
Por transparência: agentes de IA participaram do código, dos testes, deste texto e da produção da demo, que tem narração sintética e representa o ensaio com diagramas. No laboratório, automação autorizada operou o fluxo nativo de aprovação. Não foi um incidente em produção nem uma gravação de uso manual.
Para quem mantém aplicações próprias: quais evidências vocês exigiriam antes de considerar uma atualização concluída?