Antes de começar
Confirme conta, tenant e papel ativo no menu da conta. A consulta exige permissão de visualização; alterações exigem a permissão específica de gestão. Uma ação oculta ou desabilitada pode refletir o escopo autorizado; não troque de tenant para contornar uma recusa. Trabalhe somente com registros do espaço que você tem autorização para administrar.
Procedimento
- Em Cloud workers use Connections para configurar e verificar a conta cloud e suas regiões autorizadas.
- Em Profiles defina vCPU, Memory e Disk.
- Em Workers escolha Provision worker, revise tenant, conexão, região e perfil e confirme uma vez.
- Consulte Provisioning history para o resultado. Em Workers use Refresh para atualizar a observação do provedor.
- Abra More actions na linha ou o menu de contexto de DOVA_DATA_GRID para as ações autorizadas. O atalho da linha abre View details; Columns permite exibir a coluna opcional Runtime.
Comportamento e limites
Existem quatro abas: Workers, Provisioning history, Connections e Profiles. Google Cloud, AWS e Azure são tipos de conexão; cada operação depende das capacidades efetivas do provedor e das suas permissões.
Status mostra o estado da VM observado na nuvem: Running, Stopped ou Paused. No GCP, Paused corresponde a SUSPENDED. Também pode mostrar transições como Starting ou Stopping. Unknown ou Unavailable indica que não há uma observação verificável; Last known identifica um estado anterior que não pôde ser atualizado. Esses estados não comprovam um heartbeat recente nem capacidade disponível.
A coluna opcional Runtime mostra o processo do worker e a admissão de trabalhos: Online, Offline, Draining ou Disabled. Ative-a em Columns. Ela é independente do estado da VM: Running não garante que o worker esteja Online. Pause scheduling interrompe novas atribuições e permite concluir as ativas; Resume scheduling volta a admitir atribuições. Essas ações não suspendem nem retomam a VM no provedor.
O menu da linha e os controles ao lado de Worker name oferecem ações conforme o estado observado e a autorização. Start VM inicia uma VM Stopped e Resume VM retoma uma VM Paused quando o provedor oferece suporte. Um worker padrão, ocupado ou público pode bloquear Stop VM. Um worker público compartilha capacidade; não torna pública a Session consumidora nem seus dados.
Reset VM reinicia de forma forçada uma VM GCP em estado Running e exige confirmação. Antes de enviar a solicitação ao provedor, o servidor verifica novamente se existem trabalhos, execuções ou reservas ativas em qualquer tenant autorizado a usar esse worker. Um worker padrão ou público pode ser reiniciado se essa verificação completa confirmar que está inativo; suas referências e sua política de compartilhamento são preservadas. A ação aparece somente para provedores e estados compatíveis.
Enquanto um Reset não tiver resultado confirmado, o Dova bloqueia novas atribuições e outro Reset. O status principal continua mostrando a VM; Reset pending ou Check reset informa separadamente sobre a operação. Use Refresh para consultar o resultado sem reenviá-la. Somente uma operação nativa concluída e uma observação válida permitem resolver o bloqueio; uma VM Running, por si só, não comprova a conclusão do Reset. Um Reset confirmado não garante que o processo esteja pronto: Runtime aguarda o próximo heartbeat.
Confira Tenant, Public, Status, Slots e Last seen. Slots configurados e disponíveis podem diferir por admissão física. Uma estimativa de preço não garante a fatura nem confirma capacidade disponível.
Rede de workers GCP
Novos workers GCP são provisionados somente com IP privado; não há seletor de IP público. Configure Cloud NAT na região da sub-rede para que o worker acesse o Dova por HTTPS e baixe pacotes e dependências do Debian, PyPI e GitHub. Private Google Access permite acesso às APIs do Google, mas não substitui o Cloud NAT para esses destinos externos. Confira também o DNS e as regras de saída necessárias aos conectores autorizados.
Para manutenção, use IAP SSH com OS Login quando os papéis IAM e as regras de firewall necessários estiverem configurados. O worker busca trabalhos e envia heartbeat por conexões de saída; não precisa de uma porta de aplicação aberta para recebê-los.
A política public_shared compartilha capacidade entre tenants autorizados; independe de a VM ter IP público. Preserve o isolamento de cada trabalho e o escopo de suas credenciais e dados.
Verificar o resultado
Depois de salvar ou confirmar, reabra o detalhe e confira o estado informado pelo servidor. Diferencie uma solicitação aceita de uma operação concluída e preserve somente evidência mínima sem informação sensível. Quando houver uma operação pendente, espere seu estado final na tela correspondente antes de iniciar outra ação sobre o mesmo objeto.
Exemplo de laboratório
Use o tenant sintético documentation-lab e, quando aplicável, o worker worker-demo-a. Anote o estado anterior, realize uma única ação autorizada e compare o estado posterior. Esses nomes ilustram o procedimento; não identificam registros de produção nem autorizam criar recursos cloud. Para uma revisão sem alterações, consulte o detalhe e cancele qualquer formulário aberto.
Se algo falhar
Se aparecer um conflito, use Refresh e revise os valores vigentes antes de iniciar outra ação. Se aparecer Reset pending ou Check reset, use Refresh para consultar a operação; não repita Reset para tentar resolvê-la. Se o provedor confirmar uma falha, confira a mensagem segura e o estado atualizado antes de decidir sobre outra ação. Se a sessão expirou, entre novamente e conclua MFA quando exigido. Para erro de permissão, confira papel e participação. Não altere armazenamento, revisões nem controles para forçar um resultado.
Leituras relacionadas
Controles da VM sincronizados com o provedor
No menu da linha, Pause VM suspende uma VM GCP Running e produz Paused (SUSPENDED). Resume VM retoma uma VM Paused; Start VM inicia uma VM Stopped e Stop VM a desliga. Reset VM reinicia uma VM Running e mantém seu registro. O Dova verifica estado e propriedade atuais antes de enviar a ação e consulta o resultado nativo; uma solicitação aceita não equivale a uma operação concluída.
Pause VM é diferente de Pause scheduling: o primeiro suspende a VM; o segundo interrompe novas atribuições e permite concluir os trabalhos ativos. Após Start, Resume ou Reset, Runtime precisa de um heartbeat autenticado para confirmar que o processo está Online. Ações incompatíveis ficam desabilitadas durante uma operação ou enquanto trabalhos e dependências impedirem sua realização.
O GCP oferece esses controles nativos conforme o estado. O Azure oferece Start, Stop e Deprovision; Pause e Reset não são apresentados como operações equivalentes. AWS pode aparecer como tipo de conexão, mas seu ciclo de vida de VM não está disponível nesta edição.
Retirar uma VM e recuperar atribuições
Abra Remove VM and unlink, revise a identidade do recurso e o impacto nas Sessions, execuções e pools e confirme a exclusão pretendida. Para uma VM própria compatível, desmontar cada referência manualmente ou desligá-la antes não é requisito dessa operação. Retirar capacidade pode interromper execuções ativas; planeje a operação conforme a necessidade.
Após confirmar a ausência no provedor, o Dova retira o worker ativo, limpa referências de Runtime e mostra Unassigned nos bindings de Sessions que o utilizavam. Definições, versões publicadas, configuração e histórico de auditoria são preservados. Se a VM for excluída diretamente no provedor, a conciliação aplica o mesmo tratamento após verificar a ausência. Uma falha na consulta ao provedor não comprova que a VM foi excluída.
Antes de executar novamente, escolha capacidade compatível e autorizada e revise o pool do ambiente. Unassigned não seleciona outro worker silenciosamente. Você pode provisionar uma nova VM e atribuí-la explicitamente. Permissões, propriedade do recurso, servidor base protegido e operações pendentes continuam sendo verificadas; a retirada não ignora essas proteções.
Contexto de ambiente
Antes de usar este módulo, confirme Tenant, Domain e Environment no menu do usuário. O ambiente inicial é Development. As capacidades do módulo, Domain e ambiente se aplicam juntas; Production fica somente leitura sem autorização explícita. Mudar o seletor não transfere artefatos nem publica ou executa seus dados. Consulte ambientes e recuperação e promoção entre ambientes.
Pool de workers por ambiente
Em Configuration → Dova Integration Runtime, Environment worker pool identifica o ambiente atual. Allowed workers associa workers existentes; Default worker deve fazer parte dessa seleção. Pool policy começa como Dedicated. Escolha Shared somente para compartilhar capacidade explicitamente e quando todos os pools participantes também declararem Shared. Nomes iguais não compartilham um worker físico.
Save environment pool altera apenas a política do ambiente selecionado, sem iniciar execução nem modificar o default global do tenant. A revisão usa uma impressão da configuração; se outro usuário alterá-la, Refresh pool permite carregar e revisar novamente antes de salvar. Os controles exigem administração da configuração e Runtime por ambiente. Built-in não é oferecido como worker de execução.
Sem pool explícito, Production não utiliza automaticamente a capacidade de Development nem executa novos trabalhos por um default implícito. A execução legacy só mantém o worker anterior quando o servidor verifica cadeia publicada exata, configuração e associação permitida. Test e Stage consomem o bucket Development do plano; Production utiliza o bucket Production. Participar do pool não substitui capacidade, estado online, perfil compatível, cotas ou concorrência.
Antes de parar ou retirar capacidade
Pause VM e Stop VM mantêm verificações de trabalhos ativos, worker padrão e capacidade compartilhada; revise referências e impacto antes de utilizá-los. Pause scheduling interrompe novas atribuições e permite concluir o trabalho atual. Para retirar a VM definitivamente, use Remove VM and unlink e revise a confirmação: após verificar ausência cloud, o Dova limpa atribuições e mostra Unassigned sem excluir definições nem versões publicadas. Atribua capacidade compatível explicitamente antes de executar novamente.
As ações exigem a permissão do módulo e Runtime do ambiente correspondente, ou uma permissão global concedida explicitamente. Uma VM compartilhada exige autorização em todos os seus ambientes.
Recursos e permissões por ambiente
Tenant e Environment selecionados no menu do usuário delimitam Cloud workers, suas conexões cloud, perfis de provisionamento, operações e backups de dependências. Um Domain declarado no recurso também precisa coincidir. Overview, histórico de recursos e eventos operacionais de Audit respeitam esse escopo. Usuários, funções, tenants e faturamento mantêm sua própria autoridade: não são cópias independentes por ambiente.
Gerenciar uma VM exige a permissão do módulo e etl.environments.<ambiente>.runtime.manage, ou a permissão global de Runtime quando concedida explicitamente. Se vários ambientes compartilham a VM, é necessária autorização em todos os ambientes afetados. Mudar o seletor não move a VM nem amplia permissões.
Controles compactos conforme o estado cloud
Ao lado de Worker name, os ícones Pause, Start/Resume, Stop e Reset mostram as ações da VM. Leia a dica de cada ícone. Start fica disponível para uma VM Stopped e Resume para uma VM Paused quando o provedor e suas permissões permitem. O processo do worker estar Offline não impede, por si só, iniciar uma VM desligada.
O Dova verifica o estado cloud atual e as ações autorizadas. Uma observação antiga, operação pendente, trabalho ativo ou restrição de permissão pode desabilitar um controle. Após Start, Resume ou Reset, aguarde o resultado do provedor e o heartbeat do worker; VM Running e Runtime Online são verificações diferentes. Se o resultado for incerto, use Refresh antes de repetir a ação.
Observar mudanças do provedor
O GCP oferece Start, Stop, Pause/Suspend, Resume, Reset e retirada da VM conforme o estado. O Azure oferece Start, Stop/Deallocate e retirada; Pause/Resume/Reset não são apresentados como operações equivalentes. O ciclo de vida de VMs AWS não está habilitado nesta edição. Capacidades visíveis dependem do provedor e da autorização efetiva.
A sincronização com o provedor é periódica. Alterações feitas diretamente na nuvem aparecem após uma nova observação válida; não é uma notificação instantânea para toda a frota. Confira o horário da observação e use Refresh para consultar o estado. Uma operação aceita não comprova sua conclusão, e uma VM Running ainda precisa de heartbeat para mostrar Runtime Online.