Todos os produtos
Search

Este produto

    Elastic Compute Service:Atualizar ou desativar a atualização automática do Agente Cloud Assistant

    Central de documentação

    Elastic Compute Service:Atualizar ou desativar a atualização automática do Agente Cloud Assistant

    Última atualização: Nov 03, 2026

    Atualize o Cloud Assistant Agent para acessar recursos mais recentes, ou desative a atualização automática para fixar uma versão específica.

    Limitações

    Atualizações automáticas

    Importante

    Nas regiões México e China (Zhongwei), o Cloud Assistant não realiza atualizações automáticas em instâncias que executam versões anteriores às listadas abaixo. Para usar recursos mais recentes, chame InstallCloudAssistant para instalar a versão mais recente, ou realize uma atualização manual. Consulte Install the 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. O 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 Install the Cloud Assistant Agent.

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

    1. Acesse ECS console - Cloud Assistant.

    2. No canto superior direito, clique em Settings.

      image

    3. Na caixa de diálogo Cloud Assistant Settings, clique na guia 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

      Você pode especificar até cinco períodos. O intervalo mínimo entre quaisquer 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 as 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 as 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 obter mais informações sobre como visualizar o número da versão, consulte Install the 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 as atualizações automáticas

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

    Passo 1: Desativar o Cloud Assistant Agent de verificar atualizações na inicialização

    Crie um arquivo vazio disable_bootstrap_update no diretório config do diretório de 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 para todas as versões, crie o arquivo no diretório config compartilhado.

    • Windows Server:# Por exemplo, o seguinte comando desativa a verificação de atualização na inicialização para uma versão específica do Cloud Assistant Agent.

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

      Por exemplo, o seguinte comando desativa a verificação de atualização na inicialização para todas as versões do Cloud Assistant Agent.

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

    • Linux:# Por exemplo, o seguinte comando desativa a verificação de atualização na inicialização para uma versão específica do Cloud Assistant Agent.

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

      Por exemplo, o seguinte comando desativa a verificação de atualização na inicialização para todas as versões do 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 obter mais informações sobre como visualizar o número da versão, consulte Install the Cloud Assistant Agent.

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

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

    • Windows Server:# Por exemplo, o seguinte comando desativa as atualizações automáticas para uma versão específica do Cloud Assistant Agent.

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

      Por exemplo, o seguinte comando desativa as atualizações automáticas para todas as versões do Cloud Assistant Agent.

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

    • Linux:# Por exemplo, o seguinte comando desativa as atualizações automáticas para uma versão específica do Cloud Assistant Agent.

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

      Por exemplo, o seguinte comando desativa as atualizações automáticas para todas as versões do 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 obter mais informações sobre como visualizar o número da versão, consulte Install the 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 os recursos suportados e as versões mínimas do agente, consulte Supported features and versions.

    Atualizar usando comandos públicos

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

    Importante

    Os passos a seguir usam o console. Para executar comandos públicos com OpenAPI ou CLI, consulte View and run common commands.

    1. Acesse ECS console - Cloud Assistant.

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

    3. Encontre 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.

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

      • Execution Schedule: Selecione um horário para executar o comando. Para obter mais informações, consulte Execution plan details.

      • Select Instance: Selecione as instâncias para atualizar. As instâncias devem estar no estado Running e ter o agente instalado.

        Para detalhes dos parâmetros, consulte View and run common commands.

      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 Common errors and troubleshooting for failed executions.

    Atualizar baixando o pacote de instalação manualmente

    Baixe o pacote de instalação mais recente para atualizar o agente. Para métodos de instalação, consulte Install the 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