1

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:

  1. Ler o estado atual e salvar um plano com a imagem pretendida, identificada por digest.
  2. Exigir a aprovação nativa do Hermes antes da execução.
  3. Registrar o consumo do plano em SQLite, reler o estado e recusar a operação se houver mudanças em relação ao plano.
  4. 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?

Carregando publicação patrocinada...
1

Pra app próprio, eu exigiria mais três coisas:

  1. A versão na própria resposta: /version ou header com o commit ou build id gravado no build. Aí o HTTP diz qual versão respondeu. A imagem não consegue conter o próprio digest, então o plano guarda o par digest e build id. Com várias réplicas, faça vários requests: cada um só testa uma task.

  2. Uma segunda observação depois de N minutos, comparando o ID da task. No Swarm, o update só conta falhas dentro do --update-monitor; um crash depois não pausa nem reverte nada, então uma observação única pode dar sucesso logo antes de um crash loop. Como restart cria task nova, ID diferente mostra que ela foi recriada.

  3. Pra migração: faça o /version devolver também a versão do schema, lida do banco, e compare com a esperada pro release. Não prova que os dados migraram certo, mas pega código novo rodando em schema velho.