Instalar workers em Linux, Windows Server e cloud

Escolher o caminho de instalação

Você pode instalar Dova Worker Agent em um servidor autorizado existente ou provisionar uma VM por Administrator → Cloud workers. O primeiro caminho usa infraestrutura já disponível; o segundo usa uma conexão cloud e um perfil. Nenhum atribui automaticamente todas as Sessions existentes. Confirme tenant, sistema operacional, capacidade aprovada, conectividade de saída e responsável pelo servidor.

Obtenha o pacote atual no catálogo suportado e confira sua integridade. A versão do agente pode diferir da versão Dova 22.0.5. Siga as instruções incluídas no pacote exato e as geradas para seu sistema. Os comandos abaixo representam o fluxo documentado de laboratório; não os execute em um servidor de produção como simples teste de leitura.

Pré-requisitos e instalação em Linux

O fluxo documentado utiliza Python 3.10 ou posterior, ambiente virtual, systemd, util-linux com flock, acesso administrativo e HTTPS de saída para Dova e o registro de pacotes ou mirror autorizado. O instalador verifica requisitos; não presuma que trocará o Python ou o sistema operacional. Confira os requisitos do pacote publicado, pois eles também precisam ser compatíveis com a máquina de destino.

1. Extraia o pacote verificado no servidor de laboratório.
2. No diretório do pacote, execute a verificação de pré-requisitos e resolva os avisos antes de instalar.
3. Complete a instalação conforme o pacote selecionado.
4. Em Dova, abra Register worker, escolha o sistema, nome e concorrência permitida. Gere as instruções e execute o comando no servidor correto.
5. Forneça o token pelo prompt oculto suportado. Nunca o coloque em argumentos de exemplo, histórico de terminal, notas ou capturas.
6. Depois da inscrição bem-sucedida, habilite e consulte o serviço.

# Diretório do pacote verificado; laboratório Linux.
sudo sh execution-worker/install.sh --check
sudo sh execution-worker/install.sh

# Somente após a inscrição concluída.
sudo systemctl enable --now dovaetl-execution-worker
sudo systemctl status dovaetl-execution-worker

Pré-requisitos e instalação em Windows Server

Use Windows Server de 64 bits suportado, PowerShell 5.1 ou posterior e Python 3.10+ de 64 bits instalado para toda a máquina e acessível à conta de serviço. Um alias da Windows Store ou Python instalado somente para o usuário interativo não é adequado. Confira a documentação da distribuição escolhida antes de prosseguir.

1. Extraia o pacote Windows verificado e abra PowerShell elevado em seu diretório.
2. Siga o instalador incluído e identifique o executável Python real da instalação para toda a máquina. Não desabilite globalmente a política de execução.
3. Gere a inscrição para Windows Server e complete o fluxo de prompt oculto.
4. Após inscrição e instalação concluídas, inicie e consulte o serviço.
5. Confirme que a conta de serviço tem os acessos autorizados aos arquivos e conexões necessários à tarefa.

Set-Service -Name DovaWorkerAgent -StartupType Automatic
Start-Service -Name DovaWorkerAgent
Get-Service -Name DovaWorkerAgent

O serviço usa uma conta virtual dedicada. Limites de processos Windows não tornam seguro executar código arbitrário não confiável. Workers Windows permanecem privados no contrato de compartilhamento suportado; não os trate como capacidade pública isolada.

Capacidade pública isolada

A capacidade pública isolada é Linux e exige habilitação explícita e verificação do runtime aprovado. O processo isolado transforma arquivos CSV e Excel sem rede ou identidade cloud ambiental; a aquisição JSON pública limitada é descrita adiante. O ambiente compartilhado não expõe arquivos do host nem checkpoints persistentes. Uma tarefa incompatível falha explicitamente; não é desviada para um processo sem isolamento. Compartilhar capacidade não publica dados ou definições do tenant.

Cloud, concorrência e validação

Prepare Connections e Profiles e use Provision worker conforme Cloud workers. Acompanhe Provisioning history até distinguir criação de VM e inscrição completa do agente. Para GCP privado, confirme a saída de rede requerida; uma VM criada sem acesso aos destinos necessários pode não concluir o agente.

Concorrência representa unidades de slot, e um trabalho pode reservar mais de uma. No exemplo, quatro slots podem atender quatro trabalhos de peso um ou dois de peso dois. O limite configurado não garante admissão se faltarem recursos físicos, capacidades ou elegibilidade. Confira a capacidade disponível exibida em vez de contar somente os trabalhos.

Use uma Session sintética de transformação CSV pequena. Verifique versão instalada, serviço, heartbeat recente, recursos e tenant. Selecione o worker na Session ou política de execução, execute e confira filas, resultado e arquivo autorizado no Monitor. Inscrição não transfere arquivos nem configura credenciais de banco de dados. Se estiver Offline, examine serviço, conectividade e logs seguros; se Online, mas inelegível, revise escopo, política, capacidade e requisitos. Para atualização, siga o mecanismo documentado do pacote e preserve identidade sem copiar configurações sensíveis entre máquinas.

Consulte também: Cloud workers, Migração e retirada, Developer Tools.

Exemplo do instalador Windows

No diretório do pacote verificado, utilize o instalador incluído e substitua o caminho pelo Python real instalado para toda a máquina. A localização abaixo é ilustrativa:

.\execution-worker\install-windows.ps1 -Python 'C:\Program Files\Python312\python.exe'

A conta do serviço é NT SERVICE\DovaWorkerAgent. Configuração, logs e scratch ficam separados dos releases imutáveis. A atualização preserva a identidade e mantém o release anterior para rollback; não inscreva novamente uma instalação já registrada.

Entrada JSON pública e limites do isolamento

O pacote aprovado também permite uma aquisição HTTPS JSON GET pública, sem autenticação ou paginação, seguida de transformações suportadas e saída CSV. O agente confiável valida o destino público e obtém no máximo 8 MiB. O processo isolado recebe um descritor de entrada somente leitura e um de saída limitado; não recebe acesso de rede. A saída CSV tem limite de 15 MiB e não é transportada como Base64 inline. Conectores de rede diretos e checkpoints continuam rejeitados nessa capacidade compartilhada.

Um heartbeat ou teste local isolado não habilita o pool público. A plataforma precisa verificar a instalação e o runtime aprovados no host administrado. Um worker privado inscrito manualmente não é convertido ou certificado automaticamente para compartilhamento público. Essas verificações não representam atestação criptográfica do kernel.