Atualização Automática do Agente
O agente se atualiza automaticamente quando o servidor publica uma nova versão. Nenhuma intervenção manual é necessária nas máquinas individuais.
Como funciona
Em cada check-in, o servidor inclui a versão mais recente disponível do agente em sua resposta. Se o agente detectar que está rodando uma versão mais antiga, ele:
- Faz o download do novo binário do agente a partir do servidor
- Para a si mesmo, substitui seu próprio executável e reinicia como serviço
- Reporta a nova versão em execução no próximo check-in
Todo o processo é transparente para os usuários finais.
Rollback
Se o agente atualizado não conseguir iniciar, a versão anterior é preservada como arquivo de backup no diretório de instalação. Entre em contato com o administrador do sistema para restaurar manualmente o binário anterior, se necessário.
Upgrade manual
Para forçar um upgrade sem aguardar o ciclo automático de check-in, utilize um dos métodos abaixo.
Via script de instalação (preserva a configuração existente):
& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/patchone-org/app/main/deploy/windows/install.ps1'))) -ServerUrl https://your-patchone-server
Para instalar uma versão específica:
& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/patchone-org/app/main/deploy/windows/install.ps1'))) -ServerUrl https://your-patchone-server -Version 1.2.0
Via winget (para instalações feitas pelo Windows Package Manager):
winget upgrade PatchOne.PatchPilotAgent
Em todos os casos, a configuração existente (SERVER_URL, API_KEY) é preservada.
Considerações sobre AV
Durante uma atualização automática, o agente grava um novo binário em um local temporário antes de movê-lo para o lugar definitivo. Se o seu software AV bloquear isso, a atualização falhará silenciosamente e o agente continuará rodando a versão atual.
Certifique-se de que o diretório de instalação e o processo do agente estejam excluídos da varredura em tempo real do AV. Consulte Coexistência com GravityZone.