Antes de comenzar
Confirma la cuenta, el tenant y el rol activo en el menú de cuenta. Necesitas permiso de consulta para inspeccionar y el permiso de gestión específico para cambiar registros. Una opción oculta o deshabilitada puede reflejar el alcance autorizado; no cambies de tenant para eludir una denegación. Usa únicamente registros del espacio que tienes permitido administrar.
Procedimiento
- En Cloud workers usa Connections para configurar y verificar la cuenta cloud y sus regiones autorizadas.
- En Profiles define vCPU, Memory y Disk.
- En Workers elige Provision worker, revisa tenant, conexión, región y perfil y confirma una vez.
- Consulta Provisioning history para el resultado. En Workers usa Refresh para actualizar la observación del proveedor.
- Abre More actions en la fila o el menú contextual de DOVA_DATA_GRID para las acciones autorizadas. El acceso directo de la fila abre View details; Columns permite mostrar la columna opcional Runtime.
Comportamiento y límites
Hay cuatro pestañas: Workers, Provisioning history, Connections y Profiles. Google Cloud, AWS y Azure son tipos de conexión; cada operación depende de las capacidades efectivas del proveedor y de tus permisos.
Status muestra el estado de la VM observado en la nube: Running, Stopped o Paused. En GCP, Paused corresponde a SUSPENDED. También puede mostrar transiciones como Starting o Stopping. Unknown o Unavailable indican que no hay una observación verificable; Last known identifica un estado anterior que no pudo actualizarse. No interpretes esos estados como un heartbeat reciente ni como capacidad disponible.
La columna opcional Runtime muestra el proceso del worker y su admisión de trabajos: Online, Offline, Draining o Disabled. Actívala desde Columns. Es independiente del estado de la VM: Running no garantiza que el worker esté Online. Pause scheduling detiene nuevas asignaciones y permite terminar las activas; Resume scheduling vuelve a admitirlas. Estas acciones no suspenden ni reanudan la VM en el proveedor.
El menú de la fila y los controles junto a Worker name ofrecen acciones según el estado observado y los permisos. Start VM inicia una VM Stopped y Resume VM retoma una VM Paused cuando el proveedor lo admite. Un worker predeterminado, ocupado o público puede bloquear Stop VM. Un worker público comparte capacidad; no vuelve públicos la Session consumidora ni sus datos.
Reset VM reinicia de forma forzada una VM GCP en estado Running y requiere confirmación. Antes de enviarlo al proveedor, el servidor comprueba nuevamente que no existan trabajos, ejecuciones ni reservas activas en ningún tenant autorizado a usar ese worker. Un worker predeterminado o público puede reiniciarse si esta comprobación completa confirma que está inactivo; conserva sus referencias y su política de compartición. La acción se muestra solo para proveedores y estados compatibles.
Mientras un Reset no tenga resultado confirmado, Dova bloquea nuevas asignaciones y otro Reset. El estado principal sigue mostrando la VM; Reset pending o Check reset informa por separado de la operación. Usa Refresh para consultar su resultado sin volver a enviarla. Solo una operación nativa terminada y una observación válida permiten resolver el bloqueo; una VM Running por sí sola no demuestra que el Reset haya terminado. Un Reset confirmado no garantiza que el proceso esté listo: Runtime espera el siguiente heartbeat.
Revisa Tenant, Public, Status, Slots y Last seen. Los slots configurados y los disponibles pueden diferir por admisión física. Una estimación de precio no es garantía de factura ni una confirmación de capacidad disponible.
Red de workers GCP
Los nuevos workers GCP se provisionan solo con IP privada; no se ofrece un selector de IP pública. Configura Cloud NAT en la región de la subred para que el worker acceda por HTTPS a Dova y descargue paquetes y dependencias de Debian, PyPI y GitHub. Private Google Access facilita el acceso a APIs de Google, pero no sustituye a Cloud NAT para esos destinos externos. Revisa también DNS y las reglas de salida necesarias para los conectores autorizados.
Para mantenimiento, usa IAP SSH con OS Login cuando estén configurados los roles IAM y las reglas de firewall correspondientes. El worker obtiene trabajos y envía heartbeat mediante conexiones salientes; no necesita un puerto de aplicación abierto para recibirlos.
La política public_shared comparte capacidad entre tenants autorizados; es independiente de que la VM tenga IP pública. Conserva el aislamiento de cada trabajo y el alcance de sus credenciales y datos.
Verificar el resultado
Después de guardar o confirmar, vuelve a abrir el detalle y comprueba el estado informado por el servidor. Distingue una solicitud aceptada de una operación terminada y conserva solo evidencia mínima sin información sensible. Cuando exista una operación en curso, espera su estado final en la vista correspondiente antes de iniciar otra acción sobre el mismo objeto.
Ejemplo de laboratorio
Usa el tenant sintético documentation-lab y, cuando corresponda, el worker worker-demo-a. Anota el estado anterior, realiza una única acción autorizada y compara el estado posterior. Estos nombres ilustran el procedimiento; no identifican registros de producción ni autorizan crear recursos cloud. Para una revisión sin cambios, consulta el detalle y cancela cualquier formulario abierto.
Si algo falla
Si aparece un conflicto, usa Refresh y revisa los valores vigentes antes de iniciar otra acción. Si aparece Reset pending o Check reset, usa Refresh para consultar la operación; no repitas Reset para intentar resolverla. Si el proveedor confirma un fallo, revisa su mensaje seguro y el estado actualizado antes de decidir otra acción. Si caducó la sesión, inicia sesión y completa MFA cuando sea requerido. Ante un error de permisos, revisa el rol y la membresía. No alteres almacenamiento, revisiones ni controles para forzar un resultado.
Lecturas relacionadas
Controles de la VM sincronizados con el proveedor
En el menú de la fila, Pause VM suspende una VM GCP Running y produce el estado Paused (SUSPENDED). Resume VM reanuda una VM Paused; Start VM inicia una VM Stopped y Stop VM la detiene. Reset VM reinicia una VM Running y conserva su registro. Dova comprueba el estado y la titularidad vigentes antes de enviar la acción y consulta el resultado nativo; una solicitud aceptada no equivale a una operación terminada.
Pause VM es diferente de Pause scheduling: el primero suspende la VM; el segundo deja de admitir trabajos y permite finalizar los activos. Tras Start, Resume o Reset, Runtime necesita un heartbeat autenticado para confirmar que el proceso está Online. Las acciones incompatibles se deshabilitan durante una operación o mientras existan trabajos y dependencias que impidan realizarla.
GCP dispone de estos controles nativos según el estado. Azure ofrece Start, Stop y Deprovision; Pause y Reset no se presentan como operaciones equivalentes. AWS puede figurar como tipo de conexión, pero su ciclo de vida de VM no está disponible en esta edición.
Retirar una VM y recuperar las asignaciones
Abre Remove VM and unlink, revisa la identidad del recurso y el impacto en las Sessions, ejecuciones y pools, y confirma la eliminación prevista. Para una VM propia compatible, no necesitas desarmar manualmente cada referencia ni apagarla como requisito previo de esta operación. Retirar capacidad puede interrumpir ejecuciones activas; programa la operación según tu necesidad.
Después de confirmar la ausencia en el proveedor, Dova retira el worker activo, limpia referencias de Runtime y muestra Unassigned en los bindings de Sessions que usaban ese worker. Conserva las definiciones, versiones publicadas, configuración e historial de auditoría. Si la VM se elimina directamente en el proveedor, la conciliación aplica el mismo tratamiento cuando comprueba su ausencia. Un error al consultar al proveedor no demuestra que la VM se haya borrado.
Antes de volver a ejecutar, selecciona un worker compatible y permitido y revisa el pool del entorno. Unassigned no toma otro worker automáticamente. Puedes aprovisionar una VM nueva y asignarla explícitamente. Los permisos, la propiedad del recurso, el servidor base protegido y las operaciones pendientes siguen verificándose; la retirada no es una forma de eludir esas protecciones.
Contexto de entorno
Antes de utilizar este módulo confirma Tenant, Domain y Environment en el menú de usuario. El entorno inicial es Development. Las capacidades del módulo, el Domain y el entorno se aplican juntas; Production queda de solo lectura sin autorización explícita. Cambiar el selector no mueve artefactos ni publica o ejecuta sus datos. Consulta entornos y recuperación y promoción entre entornos.
Pool de workers por entorno
En Configuration → Dova Integration Runtime, Environment worker pool muestra el entorno actual. Allowed workers permite asignar workers existentes; Default worker debe pertenecer a esa selección. Pool policy empieza en Dedicated. Selecciona Shared únicamente cuando decidas compartir capacidad y todos los pools participantes también declaren Shared. Un worker físico no se comparte por una coincidencia de nombre.
Save environment pool guarda solamente la política del entorno seleccionado y no inicia una ejecución ni cambia el default global del tenant. La revisión usa una huella de la configuración; si otro usuario la cambia, Refresh pool permite consultar y revisar nuevamente antes de guardar. Los controles requieren administración de configuración y Runtime por entorno. Built-in no se ofrece como worker de ejecución.
Sin un pool explícito no se presta automáticamente el pool de Development a Production ni se ejecutan nuevos trabajos con un default implícito. Las ejecuciones legacy solo pueden conservar su worker anterior cuando el servidor verifica la cadena publicada exacta, su configuración y la pertenencia permitida. Test y Stage consumen el bucket Development del plan; Production usa el bucket Production. La pertenencia al pool no sustituye capacidad, estado online, perfil compatible, cuotas ni concurrencia.
Antes de detener o retirar capacidad
Pause VM y Stop VM conservan sus comprobaciones de trabajos activos, worker predeterminado y capacidad compartida; revisa las referencias y el impacto antes de utilizarlos. Pause scheduling detiene nuevas asignaciones y permite terminar el trabajo actual. Para retirar definitivamente la VM, utiliza Remove VM and unlink y revisa su confirmación: después de verificar ausencia cloud, Dova limpia las asignaciones y muestra Unassigned sin borrar definiciones ni versiones publicadas. Antes de ejecutar de nuevo, asigna capacidad compatible explícitamente.
Las acciones requieren el permiso del módulo y Runtime del entorno correspondiente, o un permiso global concedido explícitamente. Una VM compartida requiere autorización sobre todos sus entornos.
Recursos y permisos por entorno
El Tenant y Environment seleccionados en el menú de usuario delimitan Cloud workers, sus conexiones cloud, perfiles de aprovisionamiento, operaciones y backups de dependencias. Un Domain declarado en el recurso también debe coincidir. Overview, la historia de recursos y los eventos operativos de Audit respetan ese alcance. Usuarios, roles, tenants y facturación conservan su autoridad propia: no se crean copias independientes por entorno.
Para gestionar una VM, además del permiso del módulo se requiere etl.environments.<entorno>.runtime.manage, o el permiso global de Runtime cuando fue concedido explícitamente. Si varios entornos comparten la VM, necesitas autorización en todos los entornos afectados. Cambiar el selector no mueve la VM ni amplía tus permisos.
Controles compactos según el estado cloud
Junto a Worker name, los iconos Pause, Start/Resume, Stop y Reset muestran las acciones de la VM. Revisa el texto de ayuda de cada icono. Start está disponible para una VM Stopped y Resume para una VM Paused cuando el proveedor y tus permisos lo permiten. El estado Offline del proceso del worker, por sí solo, no impide iniciar una VM apagada.
Dova comprueba el estado cloud actual y las acciones autorizadas. Un estado sin actualizar, una operación pendiente, trabajos activos o una restricción de permisos puede deshabilitar un control. Después de Start, Resume o Reset, espera el resultado del proveedor y el heartbeat del worker; VM Running y Runtime Online son verificaciones diferentes. Si el resultado es incierto, consulta Refresh antes de repetir la acción.
Observar los cambios del proveedor
GCP ofrece Start, Stop, Pause/Suspend, Resume, Reset y retirada de la VM según su estado. Azure ofrece Start, Stop/Deallocate y retirada; no presenta Pause/Resume/Reset como operaciones equivalentes. AWS no tiene un ciclo de vida de VM habilitado en esta edición. Las capacidades visibles dependen del proveedor y de la autorización efectiva.
La sincronización con el proveedor es periódica. Los cambios realizados directamente en la nube se reflejan al obtener una nueva observación válida; no es una notificación instantánea para toda la flota. Comprueba la hora de observación y utiliza Refresh para consultar. Una operación aceptada no prueba que el cambio haya terminado, y una VM Running todavía necesita heartbeat para mostrar Runtime Online.