Todos os produtos
Search
Central de documentação

Elastic Compute Service:Alibaba Cloud managed instances

Última atualização: Sep 07, 2026

Registre um servidor de terceiros como uma instância gerenciada do Alibaba Cloud para administrá-lo com diversos services da plataforma, como Cloud Assistant, CloudOps Orchestration Service (OOS) e Alibaba Cloud DevOps. Com o Cloud Assistant, por exemplo, você gerencia o servidor sem precisar fazer login nele.

Limitações

  • Requisitos do servidor de terceiros

    • Sistemas operacionais compatíveis:

      • Alibaba Cloud Linux 2 e 3

      • CentOS 6 ou superior

      • CoreOS e OpenSUSE

      • Debian 8, 9, 10 ou superior

      • Red Hat Enterprise Linux (RHEL) 5, 6, 7 ou superior

      • SUSE Linux Enterprise Server (SLES) 11, 12, 15 ou superior

      • Ubuntu 12, 14, 16, 18 ou superior

      • Windows Server 2012, 2016, 2019 ou superior

    • O servidor precisa ter acesso à rede pública.

  • Disponibilidade por região

    Este recurso está disponível apenas nas seguintes regiões:

    China (Qingdao), China (Beijing), China (Zhangjiakou), China (Hohhot), China (Ulanqab), China (Hangzhou), China (Shanghai), China (Shenzhen), China (Heyuan), China (Guangzhou), China (Chengdu), China (Hong Kong), Japan (Tokyo), South Korea (Seoul), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Philippines (Manila), Thailand (Bangkok), Germany (Frankfurt), UK (London), US (Silicon Valley), US (Virginia), UAE (Dubai) e Saudi Arabia (Riyadh).

Faturamento

  • O recurso de instância gerenciada é gratuito.

  • Após registrar um servidor de terceiros como instância gerenciada, poderão ser geradas cobranças referentes a outros services do Alibaba Cloud que você utilizar. Para detalhes sobre faturamento, consulte a documentação desses services.

Etapa 1: Criar um código de registro

Para registrar um servidor de terceiros como instância gerenciada do Alibaba Cloud, crie um código de registro (também chamado de código de ativação) e aplique-o no servidor. Esse código funciona como credencial para verificar a identidade do servidor e garantir que apenas máquinas autorizadas sejam registradas como instâncias gerenciadas.

Importante
  • Um único código de registro permite registrar até 1.000 instâncias gerenciadas.

  • O limite máximo é de 5.000 códigos de registro por região.

  • Caso possua mais de 1.000 códigos, a criação de novos só será permitida se mais de 50% dos códigos existentes estiverem em uso.

    Na página ECS Cloud Assistant, na aba Manage Instances, clique em Register Instance. A coluna Registered Instances/Registration Quota exibe os dados de utilização dos seus códigos de registro.

  1. Acesse o Console do ECS - Cloud Assistant.

  2. No canto superior esquerdo da página, selecione uma região e um grupo de recursos.

    Importante

    O código de registro e as instâncias gerenciadas vinculadas a ele pertencem à região selecionada.

    Recomendamos escolher a região com a conexão de rede mais rápida. Execute o comando ping no servidor de terceiros para testar a velocidade de conexão e identificar a melhor região. Obtenha o ID da região para substituir <RegionID> em Regions and zones.

    ping -c 4 <RegionID>.axt.aliyuncs.com
  3. Na aba Manage Instances, crie um código de registro.

    • Cenário 1: Se não houver instâncias gerenciadas registradas na região atual, um guia aparecerá na parte inferior da página. Clique em Create Registration Code e prossiga para a Etapa 4.

    • Cenário 2: Caso já existam instâncias registradas na região, clique em Register Instance. No painel Register Instance, clique em Create Registration Code.

      Alternativamente, na página Cloud Assistant, clique na aba Managed Instances, selecione View Registration Codes e, em seguida, clique em Create Registration Code.

  4. No painel Create Registration Code, configure os parâmetros da instância gerenciada.

    Parâmetro

    Descrição

    Instance Name Prefix

    Prefixo para os nomes das instâncias gerenciadas. Recomendamos definir um prefixo para facilitar o gerenciamento.

    Source IP Address

    Endereço IP ou bloco CIDR da instância gerenciada.

    • Especifique o endereço IP público ou o bloco CIDR do servidor. Apenas servidores com IP dentro do intervalo definido poderão ser registrados.

    • Se este campo ficar vazio, nenhuma restrição de endereço IP será aplicada.

    Instance Quota

    Número máximo de instâncias que podem ser registradas com este código.

    Valores válidos: 1 a 1.000. Valor padrão: 10.

    Validity Period

    Período de validade do código de registro. Códigos expirados não permitem registrar novos servidores; nesse caso, crie um novo código.

    Valor padrão: 4 horas.

    Description

    Descrição do código de registro, como sua finalidade, para facilitar a gestão.

    Tag

    Defina uma Tag Key e um Value para o código de registro, facilitando a categorização e a manutenção.

    Importante

    As instâncias gerenciadas registradas com este código recebem automaticamente a Tag Key e o Value definidos no código.

    Resource Group

    Selecione um grupo de recursos para organizar suas instâncias gerenciadas conforme critérios como finalidade e permissões.

    Importante
  5. Clique em Generate Registration Code.

    Um script de instalação para execução no servidor de terceiros será gerado.

    O script contém etapas para baixar e instalar automaticamente o componente aliyun_assist e executar comandos de registro adequados à arquitetura do sistema. Por padrão, a opção Install Cloud Monitor Agent vem selecionada abaixo do script.

  6. Obtenha o script de instalação.

    Selecione o sistema operacional do seu servidor e clique em Download ou Copy para salvar o script localmente.

    • rpm: destinado a sistemas como Alibaba Cloud Linux, CentOS, RHEL e SUSE Linux.

    • deb: indicado para distribuições Debian e Ubuntu.

    • exe: utilizado em sistemas operacionais Windows Server.

    Importante
    • Após a geração do código de registro, o script de instalação aparece apenas uma vez. Salve-o em sua máquina local, por exemplo, como installAssistant.sh, para usar nas etapas seguintes.

    • Se houver servidores com sistemas operacionais diferentes, baixe o script de instalação correspondente a cada um deles.

Etapa 2: Instalar o Cloud Assistant Agent e registrar a instância

Execute o script de instalação obtido na Etapa 1 para registrar o servidor como instância gerenciada.

Servidores Linux

Rede pública

  1. Faça login no servidor de terceiros.

  2. Crie um script de instalação no servidor.

    1. Execute o comando abaixo para criar um arquivo de script e copie o conteúdo do script de instalação da Etapa 6 para dentro dele.

      vim installAssistant.sh
    2. Pressione a tecla Esc, digite :wq e pressione Enter para salvar o arquivo.

  3. Torne o script de instalação executável com o comando a seguir.

    sudo chmod 755 installAssistant.sh
  4. Instale o Cloud Assistant Agent no servidor executando o comando abaixo.

    sudo ./installAssistant.sh

    A instalação foi bem-sucedida se a seguinte mensagem for retornada.

    register ok
    instance id: mi-hz018g48xxx
    Process completed.
    Process completed.
    restart service

Servidor proxy

Esta seção utiliza o CentOS 7.8 como exemplo para demonstrar a instalação do Cloud Assistant Agent e o registro de uma instância gerenciada por meio de um servidor proxy.

  1. Conecte-se ao servidor usando um método como SSH.

    Para mais detalhes, consulte Connection methods.

  2. Baixe o Cloud Assistant Agent através do servidor proxy com o comando apropriado.

    Arquitetura baseada em x86:

    sudo https_proxy=<http://your_proxy_address> && wget https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm

    Arquitetura baseada em ARM:

    sudo https_proxy=<http://your_proxy_address> && wget https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm
    Importante

    Substitua <http://your_proxy_address> pelo endereço do seu servidor proxy.

  3. Instale o Cloud Assistant Agent com o comando correspondente à arquitetura.

    Arquitetura baseada em x86:

    sudo rpm -ivh aliyun_assist_latest.rpm --force

    Arquitetura baseada em ARM:

    sudo rpm -ivh aliyun-assist-latest-1.aarch64.rpm --force
  4. Configure o proxy para o service Cloud Assistant.

    1. Modifique o arquivo de configuração do service Cloud Assistant.

      Edite o arquivo de configuração do service Cloud Assistant para definir a variável de ambiente ALIYUN_ASSIST_PROXY.

      1. Utilize um editor de texto como Vim para criar o arquivo /etc/sysconfig/aliyun.

        sudo vim /etc/sysconfig/aliyun
      2. Insira o conteúdo abaixo, salve e saia do arquivo.

        ALIYUN_ASSIST_PROXY=<http://your_proxy_address>
        Importante

        Substitua <http://your_proxy_address> pelo endereço do seu servidor proxy.

    2. Recarregue a configuração do systemd com o comando a seguir.

      sudo systemctl daemon-reload
    3. Reinicie o service Cloud Assistant executando o comando abaixo.

       sudo systemctl restart aliyun.service

      Após o início do service Cloud Assistant, verifique o arquivo de log. Por padrão, ele fica em /usr/local/share/aliyun-assist/{version}/log/aliyun_assist_main.log. Se o log contiver a mensagem Detected environment variable ALIYUN_ASSIST_PROXY for proxy setting, o proxy foi configurado corretamente para o service Cloud Assistant.

  5. Registre a instância gerenciada através do servidor proxy usando os comandos a seguir.

    1. Configure o servidor proxy.

      export ALIYUN_ASSIST_PROXY=<http://your_proxy_address>
      Importante

      Substitua <http://your_proxy_address> pelo endereço do seu servidor proxy.

    2. Registre o servidor como instância gerenciada.

      Importante

      O exemplo abaixo serve apenas como referência. Copie diretamente o código gerado no console na Etapa 6.

      sudo aliyun-service --register --RegionId "cn-hangzhou" \
         --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
         --ActivationId "045CE381-0404-4F42-A44B-CC232B3E****"

Express Connect para VPC

Este tópico usa o CentOS como exemplo para mostrar como instalar o Cloud Assistant Agent via Express Connect e registrar uma instância gerenciada dentro de uma VPC.

  1. Conecte-se ao servidor usando um método como SSH.

    Para mais detalhes, consulte Connection methods.

  2. Execute o script abaixo para registrar a instância gerenciada pela rede interna da VPC.

    Veja o código de exemplo a seguir. Substitua os valores de RegionId, ActivationCode e ActivationId pelos valores presentes no script gerado automaticamente na Etapa 6.

    CentOS

    #/bin/bash
    ## Note: Set the region ID.
    regionId="cn-hangzhou"
    if [[ -n $regionId ]]; then
        bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
        ## Download the Cloud Assistant Agent.
        wget -q https://${bucket}/linux/aliyun_assist_latest.rpm
        ## Install the Cloud Assistant Agent.
        sudo rpm -ivh aliyun_assist_latest.rpm --force
    fi
    ## Register the managed instance over a VPC internal network. **Note: You must set the NetworkMode parameter to "vpc".**
    ## Copy the values of the RegionId, ActivationCode, and ActivationId parameters from the registration code creation page in the console.
    sudo aliyun-service --register \
      --NetworkMode "vpc" \
      --RegionId "${regionId}" \
      --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
      --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"

    Debian e outros Linux

    #!/bin/bash
    ## Note: Set the region ID.
    regionId="cn-hangzhou"
    if [[ -n $regionId ]]; then
        bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
        ## Download the Cloud Assistant Agent.
        wget -q https://${bucket}/linux/aliyun_assist_latest.deb
        ## Install the Cloud Assistant Agent.
        sudo dpkg -i aliyun_assist_latest.deb
    fi
    ## Register the managed instance over a VPC internal network. **Note: You must set the NetworkMode parameter to "vpc".**
    ## Copy the values of the RegionId, ActivationCode, and ActivationId parameters from the registration code creation page in the console.
    sudo aliyun-service --register \
      --NetworkMode "vpc" \
      --RegionId "${regionId}" \
      --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
      --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"

Servidores Windows

Rede pública

  1. Conecte-se remotamente ao servidor usando ferramentas como Remote Desktop Connection.

    Para mais detalhes, consulte Connection methods.

  2. Carregue o script de instalação no servidor.

    Trata-se do script gerado na Etapa 6 durante a criação do código de registro.

    Nota

    O Remote Desktop Connection permite copiar arquivos de script diretamente para o servidor. Se o ambiente de rede impedir essa cópia direta, utilize outras ferramentas, como FTP, para fazer o upload do script.

  3. Clique com o botão direito no script de instalação e selecione Run with PowerShell para instalar o Cloud Assistant Agent.

Servidor proxy

Esta seção toma o Windows Server 2016 Datacenter Edition como exemplo para explicar a instalação do Cloud Assistant Agent e o registro de uma instância gerenciada via servidor proxy.

  1. Conecte-se remotamente ao servidor usando ferramentas como Remote Desktop Connection.

    Para mais detalhes, consulte Connection methods.

  2. Configure o servidor proxy no navegador.

    1. No menu Start > Control Panel.

    2. Clique em Network and Internet.

    3. Clique em Network and Sharing Center.

    4. No canto inferior esquerdo, clique em Internet Options.

    5. Na aba Connect, clique em LAN settings.

    6. Na seção Proxy server, defina o endereço e a porta do seu servidor proxy e clique em OK.

  3. Baixe o pacote de instalação do Cloud Assistant Agent.

    1. No menu Iniciar, selecione Windows PowerShell > Windows PowerShell.

    2. Clique com o botão direito em Windows PowerShell e selecione Run as administrator.

    3. Na janela do Windows PowerShell, execute o comando abaixo para baixar o pacote de instalação do Cloud Assistant Agent.

      Invoke-WebRequest -Uri 'https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe' -OutFile 'C:\\aliyun_agent_latest_setup.exe'
  4. Após concluir o download, instale o Cloud Assistant Agent.

    1. Navegue até a unidade C:\.

    2. Dê um clique duplo em aliyun_agent_latest_setup.exe e siga o assistente para instalar o Cloud Assistant Agent.

  5. Configure o servidor proxy para o Cloud Assistant.

    1. No menu Start > Control Panel.

    2. Clique em System and Security.

    3. Clique em System.

    4. No painel de navegação à esquerda, clique em Advanced system settings.

    5. Na aba Premium, clique em Environment Variable.

    6. Na seção System Variable, clique em New Resources.

    7. Defina o Variable Name e o Variable value e clique em OK.

      • Variable Name: Defina como ALIYUN_ASSIST_PROXY.

      • Variable value: Insira o endereço do seu servidor proxy.

    8. No Windows PowerShell, execute os comandos abaixo para reiniciar o service Cloud Assistant.

      1. Pare o service Cloud Assistant com o seguinte comando.

        net stop AliyunService
      2. Inicie novamente o service Cloud Assistant com o comando a seguir.

        net start AliyunService
  6. No Windows PowerShell, registre a instância gerenciada através do servidor proxy.

    1. Navegue até o diretório de instalação do Cloud Assistant com o comando abaixo.

      cd C:\ProgramData\aliyun\assist\{version}
      Importante

      Substitua {version} pelo número da versão instalada do Cloud Assistant Agent.

    2. Registre o servidor como instância gerenciada.

      Veja um exemplo de comando abaixo. Substitua os valores de RegionId, ActivationCode e ActivationId pelos valores presentes no script gerado automaticamente na Etapa 6.

       .\aliyun_assist_service.exe  --register  --RegionId="cn-hangzhou" --ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****" --ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"

Express Connect para VPC

Este tópico utiliza o Windows Server 2016 Datacenter Edition como exemplo para demonstrar o uso de Express Connect na instalação do Cloud Assistant Agent e no subsequente registro de uma instância gerenciada.

  1. Conecte-se remotamente ao servidor usando ferramentas como Remote Desktop Connection.

    Para mais detalhes, consulte Connection methods.

  2. No menu Iniciar, selecione Windows PowerShell > Windows PowerShell.

  3. Clique com o botão direito em Windows PowerShell e selecione Run as administrator.

  4. Na janela do Windows PowerShell, execute o comando a seguir.

    Confira o exemplo de comando abaixo. Substitua os valores de RegionId, ActivationCode e ActivationId pelos valores presentes no script gerado automaticamente na Etapa 6.

    $RegionId = "cn-hangzhou"
    $Bucket = "aliyun-client-assist-${RegionId}.oss-${RegionId}-internal.aliyuncs.com"
    Invoke-WebRequest -Uri "https://${Bucket}/windows/aliyun_agent_latest_setup.exe" `
    -OutFile 'C:\\aliyun_agent_latest_setup.exe'
    &"C:\\aliyun_agent_latest_setup.exe" '/S' '--register' `
    '--NetworkMode="vpc"' '--RegionId="cn-hangzhou"' `
    '--ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****"' `
    '--ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"'
    type C:\ProgramData\aliyun\assist\hybrid\instance-id
    Start-Sleep -s 30
    net stop AliyunService
    net start AliyunService

Etapa 3: Verificar o registro

Depois de instalar o Cloud Assistant Agent e registrar a instância no servidor, retorne ao console do ECS para checar o status de conexão da instância gerenciada. Se o status for Running, o servidor de terceiros foi registrado com sucesso como instância gerenciada.

  1. Acesse o Console do ECS - Cloud Assistant.

  2. No canto superior esquerdo da página, selecione uma região e um grupo de recursos.

  3. Na aba Manage Instances, visualize a lista de instâncias gerenciadas.

    Por padrão, todos os recursos da sua conta Alibaba Cloud aparecem listados. No canto superior esquerdo do console Cloud Assistant, use a lista suspensa All Account Resources para filtrar por grupo de recursos e visualizar as instâncias gerenciadas e códigos de registro do grupo desejado.

    Se o Connection Status da instância gerenciada for Normal, o registro foi concluído com êxito.

Com o servidor de terceiros registrado como instância gerenciada, o Cloud Assistant permite administrá-lo sem necessidade de login direto. Para saber mais sobre como utilizar o Cloud Assistant, consulte Create and run a command e Send a local file to an ECS instance.

(Opcional) Cancelar o registro de um servidor de terceiros

Caso não precise mais gerenciar o servidor de terceiros pelo Alibaba Cloud, cancele o registro da instância gerenciada e, em seguida, pare e desinstale os componentes do Cloud Assistant.

Servidores Linux

  1. Conecte-se ao servidor usando um método como SSH.

    Para mais detalhes, consulte Connection methods.

  2. Cancele o registro da instância gerenciada com o comando abaixo.

    sudo aliyun-service --deregister
  3. Pare e desinstale o daemon do Cloud Assistant.

    1. Interrompa o daemon do Cloud Assistant executando o seguinte comando.

      sudo /usr/local/share/assist-daemon/assist_daemon --stop
      Nota

      O caminho padrão do daemon do Cloud Assistant é /usr/local/share/assist-daemon/assist_daemon.

    2. Desinstale o daemon do Cloud Assistant com o comando a seguir.

      sudo /usr/local/share/assist-daemon/assist_daemon --delete
  4. Pare o Cloud Assistant Agent usando o comando adequado.

    Nota

    Versões diferentes do kernel Linux utilizam services init distintos. Distribuições com kernels mais recentes, como Ubuntu 18.04, geralmente empregam o systemd. Esta seção toma o systemd como exemplo. Para instruções sobre outros services init, consulte Stop and uninstall the Cloud Assistant Agent.

    sudo systemctl stop aliyun.service
  5. Desinstale o Cloud Assistant Agent.

    • Em sistemas baseados em RPM:

      sudo rpm -qa | grep aliyun_assist | xargs sudo rpm -e
    • Em sistemas baseados em DEB:

      sudo dpkg -r aliyun-assist
  6. Exclua os diretórios do daemon do Cloud Assistant e do Cloud Assistant Agent.

    1. Remova o diretório do daemon do Cloud Assistant com o comando abaixo.

      sudo rm -rf /usr/local/share/assist-daemon
    2. Elimine o diretório do Cloud Assistant Agent executando o seguinte comando.

      sudo rm -rf /usr/local/share/aliyun-assist

Servidores Windows

Nota

Esta seção utiliza o Windows Server 2019 como exemplo. Os caminhos do Windows PowerShell e dos services podem variar em outras versões do Windows. Adapte as etapas conforme o seu ambiente.

  1. Conecte-se remotamente ao servidor usando Remote Desktop Connection.

    Para mais detalhes, consulte Connection methods.

  2. Abra o Windows PowerShell.

    1. Clique no menu Iniciar.

    2. Selecione Windows PowerShell > Windows PowerShell.

    3. Clique com o botão direito no Windows PowerShell e escolha Run as administrator.

  3. Na janela do Windows PowerShell, cancele o registro da instância gerenciada com o comando a seguir.

    aliyun-service --deregister
  4. Abra a janela de gerenciamento de Services.

    1. Clique no menu Iniciar.

    2. Selecione Windows Administrative Tools > Service

  5. Localize Aliyun Assist Service e clique em Stop this service.

Perguntas frequentes

Por que minha instância gerenciada está desconectada?

Quando o status do Cloud Assistant apresenta anomalias ou desconexão, o problema pode estar relacionado ao estado de execução do Cloud Assistant Agent. Faça login no servidor gerenciado e execute o comando systemctl status aliyun.service para verificar o status do Cloud Assistant.

  • O status running indica que o Cloud Assistant Agent opera normalmente.

  • Caso o status difira de running, execute systemctl restart aliyun.service para reiniciar o Cloud Assistant Agent. Para mais informações sobre problemas relacionados, consulte Check the status of Cloud Assistant Agent and troubleshoot exceptions.

  • Para outras questões, colete os logs em /usr/local/share/aliyun-assist/<version>/log e entre em contato com o suporte técnico do Alibaba Cloud.

Como visualizar códigos de registro existentes?

Clique em Register Instance. No painel Register Instance, é possível ver a lista de códigos de registro atuais e criar novos. Na página Register New Instance, ficam visíveis os códigos criados e as informações das instâncias associadas. As colunas da tabela incluem Registration Code, Tags, Default Instance Name, Description, Registered Count/Registration Limit e Actions. Por exemplo, se o Default Instance Name for doctest, a Description for doctest description e o Registered Count/Registration Limit for 1/10, a coluna Actions permitirá executar Disable ou Delete.

Resolução de problemas com códigos de ativação expirados

  • Ao criar um código de registro, se surgir a mensagem Activation TTL exceeds limit. acompanhada do código de erro ActivationTTL.ExceedLimit, significa que o Validity Period especificado é inválido. Reduza o valor do parâmetro Validity Period e tente novamente. O Validity Period padrão de um código de registro é de 4 horas.

  • Se o registro falhar devido a código expirado e retornar o erro activation_has_expired, o código perdeu a validade. Gere um novo código de registro e refaça o registro do servidor.

Tópicos relacionados

  • Após registrar uma instância gerenciada com sucesso, diversos services online do Alibaba Cloud ficam disponíveis, incluindo Cloud Assistant, CloudOps Orchestration Service (OOS) e Alibaba Cloud DevOps:

    • Cloud Assistant: Automatiza tarefas de O&M, como execução de scripts, monitoramento de processos, instalação ou remoção de software, inicialização ou parada de services e aplicação de patches ou atualizações de segurança. Para mais informações, consulte Cloud Assistant.

    • CloudOps Orchestration Service: Automatiza o gerenciamento e a execução de tarefas de O&M. Para mais informações, consulte What is OOS?.

  • Também é possível chamar as seguintes operações da API do Cloud Assistant para gerenciar códigos de ativação e instâncias gerenciadas.