Implantação de Software

A página Deploy permite enviar atualizações de software para um ou mais endpoints em três etapas.

Formulário de implantação

Etapa 1 — Selecionar pacote

Pesquise ou navegue no catálogo de software. O item selecionado é destacado em azul. A pesquisa filtra por nome e winget ID em tempo real.

Etapa 2 — Selecionar alvo

Três modos de seleção:

Modo	Comportamento
Single machine	Implanta em uma máquina específica selecionada na lista
All online	Implanta em todas as máquinas com status Online naquele momento
Tag group	Implanta em todas as máquinas que possuem a tag informada

O modo Tag group aceita qualquer tag atribuída às máquinas (ex.: accounting, servers, filial-sp). Tags são gerenciadas na página de detalhes de cada máquina.

Etapa 3 — Comportamento de reboot

Opção	Comportamento
Immediate	Agente inicia reinicialização com aviso de 60 segundos após a instalação
Scheduled	Agente agenda reinicialização para a próxima janela de manutenção da política
Deferred	Nenhuma reinicialização automática — o usuário reinicia quando conveniente

Como funciona a implantação

1. O dashboard chama POST /api/deploy com o alvo e o item do catálogo.
2. O servidor cria um deploy_job no estado queued para cada máquina alvo.
3. No próximo heartbeat, cada agente busca seus jobs pendentes e verifica a janela de manutenção ativa.
4. O agente executa winget upgrade --silent --scope machine <winget-id> (ou winget uninstall para jobs de remoção).
5. O agente reporta o resultado via POST /api/agent/jobs/{id}/done.
6. O job transita para completed ou failed.

Implantação em lote

Quando você implanta para múltiplas máquinas (All online ou Tag group), todos os jobs compartilham um batch_id. A página Jobs agrupa esses jobs por lote com um cabeçalho expansível.

Proteção contra duplicatas

Se você tentar enfileirar o mesmo pacote para uma máquina que já tem um job queued ou in_progress para aquele título, o servidor retorna HTTP 409. O dashboard exibe um aviso com link para o job existente.

Implantar a partir dos detalhes da máquina

Na aba Software da página de detalhes da máquina, o botão Deploy update em cada linha abre a página Deploy com a máquina e o pacote pré-selecionados. Útil para implantar uma atualização específica sem navegar pelo formulário completo.

Catálogo

O catálogo contém mais de 50 títulos pré-carregados em diversas categorias (navegadores, segurança, produtividade, desenvolvimento, etc.). Você também pode adicionar entradas personalizadas. Consulte Catálogo de Software.

Implantação automática (Políticas)

Para automatizar implantações com agendamento recorrente, use Políticas de Patch em vez da página Deploy manual.