O PID 1 é seu
O agente é um filho em segundo plano. O Docker sinaliza o seu processo diretamente, e o código de saída dele é o do container.
Dockerfile
FROM your-image # unchanged
COPY --from=markolofsen/cmdop:latest /cmdop /usr/local/bin/cmdop
ENTRYPOINT ["cmdop", "sidecar", "--"]
CMD ["your-app", "--your", "flags"] # unchangedSua imagem base e seu comando não mudam.
O Cmdop chega como um único binário.
O control plane vem junto com o container em vez de esperar por ele em outro lugar.
- Sem servidor de banco de dados
- Sem Redis
- Sem message broker
- Sem serviço de backend
- Sem web app para implantar ao lado
Copie um arquivo para a sua imagem. Esse mesmo binário é o agente de máquina, o relay ao qual outras máquinas se juntam, o console do navegador, o host do terminal e o runtime de IA — depende só de como você o invoca.
Um único sistema de produtos
Comece com uma máquina. Cresça para uma frota.
Um agente por container, não um daemon por host.
Um agente compartilhado no host acumula o estado operacional de todos os containers, precisa de acesso a todos eles e vira infraestrutura por conta própria. Um agente que viaja dentro da imagem, não.
Daemon no hostCmdop no container
- Escopo
- Daemon no host: Todos os containers da máquina
- Cmdop no container: O próprio container, e nada além
- Acesso
- Daemon no host: Socket do Docker ou privilégios de host
- Cmdop no container: Só o que o container já tem
- Ciclo de vida
- Daemon no host: Instalado, atualizado e monitorado à parte
- Cmdop no container: Sobe e para junto com o container
- Estado operacional
- Daemon no host: Compartilhado por tudo que ele gerencia
- Cmdop no container: Isolado por container
- Escala
- Daemon no host: Um agente para dar conta da frota inteira
- Cmdop no container: A gerenciabilidade se replica com a sua imagem
O container continua sendo do seu processo.
O cmdop sidecar sobe o agente em segundo plano e então faz exec do seu comando. Sua aplicação vira o PID 1, então docker stop, sinais, códigos de saída e restart policies funcionam exatamente como antes.
Um agente com falha não é uma queda
Se o agente não subir ou não alcançar o relay, sua aplicação continua rodando. Sem join key definida, o sidecar é um exec puro.
Só de saída
É o container que disca para o relay. Nenhuma porta de entrada é aberta e nenhuma regra de ingress é necessária.
Qualquer imagem base
O binário não linka nenhuma libc, então Alpine, Debian, distroless e scratch funcionam.
O que a máquina faz depois de entrar na frota.
Terminal
Abra um shell dentro do container em execução pelo navegador, pela CLI ou pelo celular.
Acesso a arquivos
Leia, compare e edite os arquivos dentro do container, restrito ao diretório que você aponta para o agente.
Operações de IA
Peça a um agente para inspecionar, alterar, executar ou depurar o que está dentro do container.
Execução remota
Rode comandos e passe trabalho entre máquinas a partir de qualquer superfície do Cmdop.
Um container, depois uma frota.
A mesma imagem roda no seu notebook, no Compose e onde mais você já roda containers. Suba quinhentas e você tem quinhentos agentes independentes, porque gerenciabilidade é propriedade da imagem e não algo que você implanta ao lado dela.
- Um container
- Uma máquina na frota
- Uma frota que você consegue operar
Depois entregue a join key da frota.
Construa a imagem e passe o endereço do relay e a join key como variáveis de ambiente. A máquina aparece na sua frota ao iniciar, e não há mais nada para configurar.
O repositório público traz um Dockerfile de quinze linhas sobre um app Node comum — as variáveis, o que cada uma evita e um container que você pode subir agora.
O ambiente de demo
Veja o loop inteiro antes de adotar.
A demo pública é um arranjo maior de propósito: ela hospeda o próprio relay, monta um projeto gravável e sobe um dev server, então você acompanha um agente editando uma aplicação real e a mudança entrando no histórico Git.
Ela mostra o que o Cmdop faz de ponta a ponta. Adicionar o agente a um container que já é seu continua sendo duas linhas.
Duas linhas, e o container é seu para operar.
Adicione o binário a uma imagem que você já publica, ou clone o exemplo e veja uma máquina entrar na frota.