Instalar workers en Linux, Windows y cloud
Elegir el recorrido correcto
Hay dos recorridos distintos: registrar capacidad en un servidor existente o provisionar una VM mediante Administrator → Cloud workers. El primero instala Dova Worker Agent en infraestructura ya disponible; el segundo utiliza conexión cloud y perfil. Ninguno asigna automáticamente todas las Sessions existentes. Antes de empezar documente tenant, sistema operativo, capacidad autorizada y responsable de la infraestructura.
Esta guía describe contratos revisados en fuente. Las versiones de paquetes citadas son las que documenta el README local; confirme el catálogo publicado antes de descargar. Los comandos de instalación actúan sobre el servidor donde se ejecutan: no son comandos para probar directamente en producción. Realice el POC en un servidor de laboratorio autorizado.
Linux: requisitos e instalación
Requisitos documentados: Python 3.10 o posterior, venv, systemd, util-linux con flock, acceso de administrador y HTTPS saliente al servicio Dova y al registro de paquetes o mirror autorizado. La capacidad debe cumplir los requisitos configurados. El instalador comprueba requisitos; no instala silenciosamente otro Python ni cambia el sistema operativo.
El paquete documentado es Linux 1.3.5. Después de obtenerlo y verificarlo:
# Laboratorio Linux; directorio del paquete extraído.
sudo sh execution-worker/install.sh --check
sudo sh execution-worker/install.sh
En Dova, Register worker genera el enrollment para el sistema elegido. Defina nombre y concurrencia permitida, copie el comando generado y entregue el token separado mediante el prompt oculto. No lo añada a argumentos, historial ni documentación. La configuración generada tiene permisos restringidos.
# Sólo después de enrollment correcto en el servidor de laboratorio.
sudo systemctl enable --now dovaetl-execution-worker
sudo systemctl status dovaetl-execution-worker
La concurrencia representa de 1 a 64 unidades de slot. Un trabajo normalmente utiliza una unidad; slotWeight puede reservar varias. Cuatro slots admiten cuatro trabajos de peso uno o dos de peso dos, no cuatro trabajos independientemente del peso.
Windows Server
Se requiere Windows Server de 64 bits soportado, PowerShell 5.1 o posterior y Python 3.10+ de 64 bits instalado para toda la máquina, accesible por la cuenta de servicio. Un alias de Windows Store o Python instalado sólo en el perfil del usuario no es adecuado.
El README documenta paquete Windows 1.3.3. Extraiga el paquete, abra PowerShell elevado en su directorio y seleccione el ejecutable real instalado:
# Ejemplo de ubicación; sustituir por el Python de la máquina de laboratorio.
.\execution-worker\install-windows.ps1 -Python 'C:\Program Files\Python312\python.exe'
No deshabilite globalmente la política de ejecución para instalar. Genere enrollment seleccionando Windows Server y use el prompt oculto. Tras inscripción correcta:
Set-Service -Name DovaWorkerAgent -StartupType Automatic
Start-Service -Name DovaWorkerAgent
Get-Service -Name DovaWorkerAgent
El servicio usa una cuenta virtual dedicada, no una sesión interactiva. Configuración, logs rotados y scratch se separan de releases inmutables. Los Job Objects controlan recursos y descendientes; esos límites no deben describirse como sandbox para ejecutar código arbitrario no confiable.
Cloud: connection, profile y provisioning
En Connections prepare identidad federada, scope y regiones autorizadas; verifique las instrucciones específicas del proveedor. En Profiles configure vCPU, memoria, disco y ubicación. Luego, en Workers, seleccione tenant, conexión, perfil, nombre, slots, región y zona cuando corresponda. Revise compartición y estimación opcional antes de crear.
Observe Provisioning history hasta distinguir VM creada de agente registrado. Un timeout del navegador no demuestra que el proveedor canceló la creación. Consulte la operación antes de repetirla; duplicar solicitudes puede generar infraestructura adicional.
Verificación y POC
Use worker-documentacion y una transformación CSV pequeña con datos ficticios. Verifique versión instalada, Online, heartbeat reciente y recursos. Seleccione el worker en la Session o política de ejecución, ejecute el ejemplo y consulte Monitor. Registre resultado esperado, filas obtenidas y ubicación autorizada del archivo.
Si no está online revise servicio, conectividad y logs sin copiar secretos. Si está online pero no es elegible, revise capacidad, capacidades requeridas, política y tenant. Enrollment no configura permisos de bases de datos ni transfiere archivos. Para actualizar use el instalador y sus mecanismos de preservación de identidad/rollback documentados; no copie una configuración sensible entre máquinas.