Docker

O Docker Host é a máquina que executa os bots do tipo Docker. Nela roda o agente de Docker Host: um container que se conecta ao orquestrador do Sinfonia, recebe as execuções da fila, baixa a imagem do bot e a executa como container no Docker da própria máquina.

Este agente é diferente dos agentes para Windows e Linux, usados pelos bots dos tipos Script, Zip e Git. Bots Docker só podem ser executados em um Docker Host. A comparação entre eles está na visão geral de Agentes.

Como funciona

    flowchart LR
    O["Orquestrador<br/>Sinfonia"] <-->|HTTPS| A["Agente de<br/>Docker Host"]
    A -->|docker.sock| D["Docker Engine<br/>do host"]
    D --> C["Container<br/>do bot"]
    R[("Registry ou<br/>arquivo de imagem")] -->|imagem| D
  

1. O agente consulta a fila de execuções do orquestrador.
2. Ao receber uma execução, verifica se a imagem do bot já existe no host. Se não existir, obtém a imagem conforme a origem configurada no bot: pull em registry público, pull com autenticação ou carga do arquivo enviado.
3. Cria e inicia o container, repassando as variáveis de ambiente da execução.
4. Captura a saída do container (stdout e stderr) e a envia ao orquestrador como log da execução.
5. Ao final, remove o container e registra o resultado: código de saída 0 indica sucesso, qualquer outro valor indica erro.

Requisitos

• Máquina Linux com Docker Engine e o plugin Docker Compose instalados.
• Recurso de Docker Host contratado na plataforma.
• Acesso de saída ao orquestrador do Sinfonia em grpc.sinfonia.live por HTTPS (porta 443), como descrito nos pré-requisitos.
• Acesso de saída aos registries de onde as imagens dos bots serão baixadas (Docker Hub, GHCR, Amazon ECR etc.).
• Portas UDP 49252 a 49292 liberadas no firewall para o host, usadas na visualização dos logs dos containers em tempo real pelo portal.
• Um token de agente. Use o token master da conta ou crie um novo em tokens.
• CPU, memória e disco suficientes para o agente e para os containers dos bots que rodarão no host.

Implantação

docker load --input <arquivo-da-imagem>

services:
  sinfonia-docker-host:
    image: <nome>:<tag>
    container_name: sinfonia-docker-host
    restart: unless-stopped
    environment:
      AGENT_NAME: DOCKER-HOST-01
      AGENT_TOKEN: <seu-token>
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro
      - /etc/os-release:/etc/os-release:ro
    ports:
      - 49252-49292:49252-49292/udp
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: "2000MB"

cd /opt/sinfonia-docker-host
docker compose up -d

docker logs -f sinfonia-docker-host

Gerenciar imagens e containers

Na tela Docker Hosts do portal você acompanha cada host conectado, com as imagens armazenadas e os containers existentes, e pode:

• consultar os logs de um container;
• iniciar, pausar, reiniciar, parar, encerrar ou remover um container;
• remover uma imagem do host.

Comportamento das execuções

• Tempo de início: com a fila vazia, o agente consulta o orquestrador a cada 30 segundos. Uma execução pode levar até esse tempo para começar.
• Cache de imagens: o agente só baixa a imagem quando ela ainda não existe no host. Se você publicar um conteúdo novo reutilizando a mesma tag (por exemplo latest), o host continua executando a imagem antiga.
• Limpeza: o container é removido ao final de cada execução. A imagem permanece no host para as execuções seguintes.

Atualizar ou remover o agente

Para atualizar, baixe a nova versão da imagem na plataforma, carregue-a no host e recrie o container:

docker load --input <arquivo-da-imagem>
docker compose up -d

Se a tag da nova imagem for diferente, atualize o campo image do docker-compose.yml antes de recriar o container.

Para remover o agente do host:

docker compose down

Solução de problemas

Próximo passo