Todos os produtos
Search

Este produto

    Elastic Compute Service:Upgrade or disable auto-upgrade for Cloud Assistant Agent

    Central de documentação

    Elastic Compute Service:Upgrade or disable auto-upgrade for Cloud Assistant Agent

    Última atualização: Jul 03, 2026

    Atualize o Cloud Assistant Agent para acessar novos recursos ou desative a atualização automática para manter uma versão específica.

    Limitações

    Atualizações automáticas

    Importante

    Nas regiões do México e China (Zhongwei), o Cloud Assistant não atualiza automaticamente instâncias com versões anteriores às listadas abaixo. Para usar novos recursos, chame InstallCloudAssistant para instalar a versão mais recente ou faça uma atualização manual. Consulte Instalar o Cloud Assistant Agent.

    • Linux: 2.2.3.515

    • Windows: 2.1.3.515

    Por padrão, o Cloud Assistant Agent executa o programa aliyun_assist_update a cada 30 minutos. Caminho do programa:

    • Instâncias Windows: C:\ProgramData\aliyun\assist\{VERSION}\aliyun_assist_update.exe

    • Instâncias Linux: /usr/local/share/aliyun-assist/{VERSION}/aliyun_assist_update

    Nota

    {VERSION} representa o número da versão do Cloud Assistant Agent. Para visualizar o número da versão, consulte Instalar o Cloud Assistant Agent.

    Configure uma política de atualização para controlar as janelas de tempo e evitar interrupções em horários de pico.

    1. Acesse o ECS console - Cloud Assistant.

    2. No canto superior direito, clique em Settings.

      image

    3. Na caixa de diálogo Cloud Assistant Settings, clique na aba Cloud Assistant Agent Upgrade Settings.

    4. Selecione Cloud Assistant Agent Upgrade Settings, defina Period Allowed for Upgrade e Time Zone e clique em OK.

      Nota

      É possível especificar até cinco períodos. O intervalo mínimo entre dois períodos é de 1 hora.

      image

    Desativar atualizações automáticas

    • Para desativar a atualização automática de uma versão específica, crie arquivos de configuração para desativar atualizações automáticas ou renomeie o programa de atualização automática.

    • Para desativar a atualização automática de todas as versões, crie arquivos de configuração para desativar atualizações automáticas.

    Renomear o programa de atualização automática

    Renomeie o arquivo aliyun_assist_update para desativar a atualização automática do Cloud Assistant Agent.

    Nota

    VERSION representa o número da versão do Cloud Assistant Agent. Para saber como visualizar o número da versão, consulte Instalar o Cloud Assistant Agent.

    • Windows Server: Renomeie aliyun_assist_update para aliyun_assist_update.bk.Rename-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe.bk'

    • Linux: Renomeie aliyun_assist_update para aliyun_assist_update.bk.mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk

    Para retomar a atualização automática, renomeie o arquivo de volta para aliyun_assist_update.

    • Windows Server:Rename-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe.bk' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe'

    • Linux:mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update

    Criar arquivos de configuração para desativar atualizações automáticas

    Para o Cloud Assistant Agent 2.2.1.140 ou posterior no Linux e Cloud Assistant Agent 2.1.1.140 ou posterior no Windows, crie arquivos de configuração para desativar a atualização automática:

    Etapa 1: Impedir que o Cloud Assistant Agent verifique atualizações na inicialização

    Crie um arquivo vazio chamado disable_bootstrap_update no diretório config da instalação do Cloud Assistant Agent. Isso desativa a verificação de atualização na inicialização para a versão atual. Para desativá-la em todas as versões, crie o arquivo no diretório config compartilhado.

    • Windows Server:# For example, the following command disables the upgrade check on startup for a specific version of the Cloud Assistant Agent.

      New-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update'

      For example, the following command disables the upgrade check on startup for all versions of the Cloud Assistant Agent.

      New-Item -Path 'C:\ProgramData\aliyun\assist\config\disable_bootstrap_update'

    • Linux:# For example, the following command disables the upgrade check on startup for a specific version of the Cloud Assistant Agent.

      touch /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update

      For example, the following command disables the upgrade check on startup for all versions of the Cloud Assistant Agent.

      touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update

    Nota

    VERSION representa o número da versão do Cloud Assistant Agent. Para saber como visualizar o número da versão, consulte Instalar o Cloud Assistant Agent.

    Etapa 2: Desativar a verificação automática de atualizações do Cloud Assistant Agent

    Crie um arquivo vazio chamado disable_update no diretório config da instalação do Cloud Assistant Agent. Isso desativa a atualização automática periódica para essa versão. Para desativá-la em todas as versões, crie o arquivo no diretório config compartilhado.

    • Windows Server:# For example, the following command disables automatic upgrades for a specific version of the Cloud Assistant Agent.

      New-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update

      For example, the following command disables automatic upgrades for all versions of the Cloud Assistant Agent.

      New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update

    • Linux:# For example, the following command disables automatic upgrades for a specific version of the Cloud Assistant Agent.

      touch /usr/local/share/aliyun-assist/VERSION/config/disable_update

      For example, the following command disables automatic upgrades for all versions of the Cloud Assistant Agent.

      touch /usr/local/share/aliyun-assist/config/disable_update

    Nota

    VERSION representa o número da versão do Cloud Assistant Agent. Para saber como visualizar o número da versão, consulte Instalar o Cloud Assistant Agent.

    Para retomar a atualização automática, exclua os arquivos disable_update e disable_bootstrap_update.

    • Windows Server:Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update

      Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_update

      Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update

      Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update

    • Linux:rm /usr/local/share/aliyun-assist/VERSION/config/disable_update

      rm /usr/local/share/aliyun-assist/config/disable_update

      rm /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update

      rm /usr/local/share/aliyun-assist/config/disable_bootstrap_update

    Atualização manual

    Nota

    Para consultar os recursos suportados e as versões mínimas do agente, visualize Recursos e versões suportados.

    Atualizar usando comandos públicos

    Se a atualização automática falhar, execute comandos públicos para atualizar o agente.

    Importante

    As etapas a seguir usam o console. Para executar comandos públicos com OpenAPI ou CLI, consulte Visualizar e executar comandos públicos.

    1. Acesse o ECS console - Cloud Assistant.

    2. Na página Cloud Assistant, clique na aba Common Commands.

    3. Localize a versão mais recente do comando público aplicável e clique em Run.

      • Instâncias Linux: ACS-ECS-UpdateAliyunAssist-linux.sh.

      • Instâncias Windows: ACS-ECS-UpdateAliyunAssist-windows.ps1.

        image.png

    4. No painel Run Command, configure os parâmetros e clique em Run.

      Se a saída for semelhante à figura a seguir, o Cloud Assistant Agent foi atualizado.image.png

    Nota

    Se o comando público falhar, verifique a mensagem de erro. Consulte Erros comuns e solução de problemas para execuções com falha.

    Atualizar baixando manualmente o pacote de instalação

    Baixe o pacote de instalação mais recente para atualizar o agente. Para métodos de instalação, consulte Instalar o Cloud Assistant Agent.

    Por exemplo, em uma instância Linux x86, baixe e instale o pacote RPM mais recente do agente:

    wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && sudo rpm -ivh --force aliyun_assist_latest.rpm

    Versões máximas do agente por versão do kernel

    Versão do kernel

    Versão máxima do agente

    Kernel Linux anterior a 2.6.32

    • Arquitetura x86/x64: 2.2.3.398

    • Arquitetura ARM: 2.4.3.398

    FreeBSD 11 ou anterior (versão do kernel anterior a 12.x)

    2.3.3.529