すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:ECSインスタンスへのCloud Assistant Agentのインストール

最終更新日:Jan 23, 2025

Cloud Assistant Agentは、ECSインスタンスでCloud Assistantコマンドを実行するためのプログラムです。 このトピックでは、Cloud Assistant Agentをインストールする方法について説明します。

前提条件

Cloud Assistant Agentをインストールする前に、インスタンスタイプとオペレーティングシステムを照会して、Cloud Assistantがサポートされていることを確認します。 詳細については、「制限」をご参照ください。

背景情報

2017年12月1日以降にパブリックイメージから作成されたECSインスタンスには、Cloud Assistant Agentがプリインストールされています。

インスタンスが2017年12月1日より前に購入されたか、アップロードしたカスタムイメージから作成されたもので、Cloud Assistantの機能を使用する場合は、このトピックの手順に従ってCloud Assistant Agentを手動でインストールします。

説明

Alibaba Cloud以外のサーバーをAlibaba Cloudマネージドインスタンスとして登録することにより、サーバーは、Cloud Assistant、CloudOps Orchestration Service、Apsara Devopsなど、Alibaba Cloudが提供するさまざまなオンラインサービスを利用して、サーバーを管理または使用できます。 詳細については、「Alibaba Cloudマネージドインスタンス」をご参照ください。

Cloud Assistantでサポートされている機能に基づいて、適切なバージョンのCloud Assistantをインストールする必要があります。 次の表に、Cloud Assistantでサポートされている機能と、各機能でサポートされている最も古いバージョンのCloud Assistant Agentを示します。

Cloud Assistantでサポートされる機能

Linuxインスタンスの最小バージョン番号

Windowsインスタンスの最小バージョン番号

関連ドキュメント

Cloud Assistantハートビートのレポートのサポート

1.0.2.458

1.0.0.149

なし

ファイルの送信

1.0.2.569

1.0.0.149

Cloud Assistantを使用したECSインスタンスへのファイルのアップロード

コマンドを実行するためのユーザー名の指定のサポート

2.2.0.106

2.1.0.50

次回のインスタンス起動時に実行するコマンドの設定のサポート

2.2.0.46

2.1.0.50

すべてのインスタンス起動時に実行するコマンドの設定のサポート

セッション管理のサポート (session Manager)

2.2.3.196

2.1.3.196

セッション管理を使用したインスタンスへの接続

スケジュールされたタスクの実行プランでのレート式またはat式の使用のサポート

2.2.3.282

2.1.3.282

スケジュールされたタスクの実行計画に <Year> フィールドまたは <Time zone> フィールドを含むcron式を指定するサポート

2.2.3.282

2.1.3.282

組み込み環境パラメータの指定のサポート

2.2.3.309

2.1.3.309

組み込み環境パラメータとしてのインスタンス名の使用のサポート

2.2.3.344

2.1.3.344

特定の終了コードを使用してインスタンスを停止または再起動するためのサポート

2.2.3.317

2.1.3.317

Cloud Assistantコマンドを使用したインスタンスの停止または再起動

コマンドを実行するコンテナーの名前を指定するためのサポート

2.2.3.344

2.1.3.344

Cloud Assistantを使用したコンテナーでのコマンドの実行

コマンドを実行するコンテナーのIDを指定するためのサポート

2.2.3.344

2.1.3.344

次の表に、さまざまなオペレーティングシステムでのCloud Assistantクライアントのインストール方法を示します。

インスタンスオペレーティングシステム

インストール方法

Windows

Linux (Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux、Debian、Ubuntu)

Linux (その他)

WindowsインスタンスへのCloud Assistant Agentのインストール

  1. 管理者アカウントを使用してECSインスタンスへのリモート接続を確立します。

    詳細については、「ECSリモート接続方法の概要」をご参照ください。

  2. ダウンロードします。Cloud Assistantエージェント.

    Cloud Assistant AgentはURLをダウンロードします。

    • パブリックURL (最新バージョン): Cloud Assistant Agent latest version

    • パブリックURL (特定のバージョン):

      https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe
    • 内部URL (最新バージョン):

      https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
    • 内部URL (特定のバージョン):

      https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe
    説明
    • {version} は、Cloud Assistant Agentの特定のバージョン番号です。

    • {regionId} は、インスタンスが配置されているリージョンのリージョンIDです。

      ECSコンソールの [基本情報] セクションの [インスタンスの詳細] ページで、ECSインスタンスのリージョンを確認できます。 次に、[リージョンとゾーン] で対応するリージョンIDを表示できます。

    • 次のCloud Assistantのバージョン番号は、パブリックURLまたは内部URLからダウンロードするために指定できます。

      • パブリックURL: 1.0.0.128、2.1.2.181、2.1.3.187、2.1.3.221、2.1.3.247、2.1.3.256、2.1.3.269、2.1.3.282、2.1.3.289、2.1.3.326、2.1.3.349、2.1.3.372、2.1.3.398

      • 内部URL: 1.0.128、2.1.3.221、2.1.3.247、2.1.3.256、2.1.3.265、2.1.3.269、2.1.3.282、2.1.3.289、2.1.3.326、2.1.3.349、2.1.3.372、2.1.3.398

    たとえば、中国 (杭州) リージョンの内部URLからバージョン1.0.0.128をダウンロードするには、次のURLを使用します。

    https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_1.0.0.128_setup.exe
  3. Cloud Assistant Agentファイルをダブルクリックし、インストールウィザードのプロンプトに従ってセットアップを完了します。

    デフォルトのインストールパスを選択した場合、WindowsインスタンスのCloud Assistant AgentのインストールディレクトリはC:\ProgramData\aliyun\assist\ です。

    上記のダウンロードとインストールの手順をPowerShellスクリプトに統合することもできます。 次のスクリプトでは、例として最新バージョンの内部URLを使用しています。 使用する場合は、{regionId} をインスタンスが配置されているリージョンのリージョンIDに置き換えます。

    curl -UseBasicParsing -Uri https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe'
    &"C:\\aliyun_agent_latest_setup.exe" '/S' 
  4. (オプション) インスタンスがクラシックネットワークにある場合は、次の操作を実行します。

    1. Cloud Assistantのインストールディレクトリにregion-idという名前のファイルを作成します (.txt.confなどの拡張子は追加しないでください) 。

      重要

      Windowsは、既知のファイルタイプの拡張子を非表示にします。 region-idに拡張子があるかどうかを判断するには、既知のファイルタイプの拡張子を表示するようにWindowsを設定する必要があります。

    2. region-IDファイルに、cn-hangzhouなどのECSインスタンスのリージョンidを入力します。

      説明

      ECSコンソールの [基本情報] エリアの [インスタンスの詳細] ページでECSインスタンスのリージョンを確認し、[リージョンとゾーン] で対応するリージョンIDを確認できます。

    たとえば、Windows Server 2012 R2では、新しく作成されたregion-idファイルと、デフォルトのインストールパスC:\ProgramData\aliyun\assist\ に入力されたregion ID cn-hangzhouは次のようになります在Windows上添加文件

LinuxインスタンスにCloud Assistant Agentをインストールする

RPMおよびDEBパッケージ管理方法

Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux、Debian、およびUbuntuオペレーティングシステムに適用できます。

  1. sudo権限を持つユーザーとしてECSインスタンスに接続します。

  2. 次のスクリプトを実行して、Cloud Assistantインストールパッケージをダウンロードしてインストールします。

    重要

    次のスクリプトは、デフォルトで最新バージョンのAgentをインストールします。 特定のバージョンをインストールする場合は、スクリプトのversion=latestVERSION=2.2.3.398などの指定されたバージョン番号に変更します。 利用可能なバージョンは次のとおりです。

    • x86バージョン: 2.2.0.102、2.2.0.106、2.2.2.181、2.2.3.187、2.2.3.221、2.2.3.247、2.2.3.256、2.2.3.269、2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.2.3.372、2.2.3.398

    • ARMバージョン: 2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398

    内部ネットワークのダウンロードとインストールスクリプト

    ECSインスタンスに推奨されます。 デフォルトでは、内部ネットワーク経由でダウンロードできます。

    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
    DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            if command -v rpm; then
                PACKAGE="aliyun_assist_${VERSION}.rpm"
            else
                PACKAGE="aliyun_assist_${VERSION}.deb"
            fi
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            if command -v rpm; then
                PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
            else
                PACKAGE="aliyun-assist-${VERSION}-1_arm64.deb"
            fi
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
    esac
    
    if command -v wget; then
        sudo wget $PKG_URI
    elif command -v curl; then
        curl -o $PACKAGE $PKG_URI
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1;
    fi;
    
    if command -v rpm; then
        sudo rpm -ivh --force $PACKAGE
    elif command -v dpkg; then
        sudo dpkg -i $PACKAGE
    else
        echo "[WARN] command rpm/dpkg not found, exit"
        exit 2;
    fi
    
    if [[ -e /etc/redhat-release ]]; then
        if sudo systemctl status qemu-guest-agent; then
            sudo systemctl stop qemu-guest-agent
            sudo systemctl disable qemu-guest-agent
            sudo systemctl restart aliyun.service
        fi
    fi
    

    パブリックネットワークのダウンロードとインストールスクリプト

    Alibaba Cloud以外のホストおよびパブリックネットワークにアクセスできるECSインスタンスに適用できます。

    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            if command -v rpm; then
                PACKAGE="aliyun_assist_${VERSION}.rpm"
            else
                PACKAGE="aliyun_assist_${VERSION}.deb"
            fi
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            if command -v rpm; then
                PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
            else
                PACKAGE="aliyun-assist-${VERSION}-1_arm64.deb"
            fi
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
    esac
    
    if command -v wget; then
        sudo wget $PKG_URI
    elif command -v curl; then
        curl -o $PACKAGE $PKG_URI
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1;
    fi;
    
    if command -v rpm; then
        sudo rpm -ivh --force $PACKAGE
    elif command -v dpkg; then
        sudo dpkg -i $PACKAGE
    else
        echo "[WARN] command rpm/dpkg not found, exit"
        exit 2;
    fi
    
    if [[ -e /etc/redhat-release ]]; then
        if sudo systemctl status qemu-guest-agent; then
            sudo systemctl stop qemu-guest-agent
            sudo systemctl disable qemu-guest-agent
            sudo systemctl restart aliyun.service
        fi
    fi

バイナリインストール方法

主流のLinuxオペレーティングシステムに適用できます。

  1. sudo権限を持つユーザーとしてECSインスタンスに接続します。

  2. 次のスクリプトを実行して、Cloud Assistantインストールパッケージをダウンロードしてインストールします。

    重要

    次のスクリプトは、デフォルトで最新バージョンのAgentをインストールします。 特定のバージョンをインストールする場合は、スクリプトのversion=latestVERSION=2.2.3.398などの指定されたバージョン番号に変更します。 利用可能なバージョンは次のとおりです。

    • x86バージョン: 2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.3.372、2.2.3.398

    • ARMバージョン: 2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398

    内部ネットワークのダウンロードとインストールスクリプト

    ECSインスタンスに推奨されます。 デフォルトでは、内部ネットワーク経由でダウンロードできます。

    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
    DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            PACKAGE="aliyun_assist_${VERSION}.deb"
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun-assist-${VERSION}-1_arm64.deb"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
    esac
    
    if command -v wget; then
        sudo wget $PKG_URI
    elif command -v curl; then
        curl -o $PACKAGE $PKG_URI
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1
    fi;
    
    TARGET_DIR=/usr/local/share/aliyun-assist
    sudo unzip -o $PACKAGE -d $TARGET_DIR/
    sudo chmod a+x $TARGET_DIR/$VERSION/update_install
    sudo bash $TARGET_DIR/$VERSION/update_install
    

    パブリックネットワークのダウンロードとインストールスクリプト

    Alibaba Cloud以外のホストおよびパブリックネットワークにアクセスできるECSインスタンスに適用できます。

    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            PACKAGE="aliyun_assist_${VERSION}_update.zip"
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun-assist-${VERSION}-update_arm.zip"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
    esac
    
    if command -v wget; then
        sudo wget $PKG_URI
    elif command -v curl; then
        curl -o $PACKAGE $PKG_URI
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1
    fi;
    
    TARGET_DIR=/usr/local/share/aliyun-assist
    sudo unzip -o $PACKAGE -d $TARGET_DIR/
    sudo chmod a+x $TARGET_DIR/$VERSION/update_install
    sudo bash $TARGET_DIR/$VERSION/update_install
    

ソースコードのインストール方法

  1. sudo権限を持つユーザーとしてECSインスタンスに接続します。

  2. GitやGoなどの必要なソフトウェアをインストールします。

    この例では、YUMを使用します。他のLinuxオペレーティングシステムの場合は、適切なパッケージマネージャを使用します。

    • Gitをインストールするには:

      sudo yum install git -y
    • Goをインストールするには:

      sudo yum install go -y
  3. Cloud Assistant Agentソースコードをダウンロードします。

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  4. ソースコードがあるディレクトリに移動します。

    cd ./aliyun_assist_client
  5. ソースコードをコンパイルします。

    sudo go build

    エラーメッセージが返されない場合、インストールは成功です。

  6. インスタンスがクラシックネットワーク上にある場合は、以下を実行します。

    Cloud Assistantインストールディレクトリにregion-idという名前のファイルを作成し、ECSインスタンスのリージョンIDを書き込みます。 次のコマンドを使用してregion-idファイルを作成し、リージョンID cn-hangzhouをデフォルトのCloud Assistantインストールパスに追加します。

    • CoreOSオペレーティングシステムの場合:

      sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
    • その他のオペレーティングシステム (Alibaba Cloud Linux、Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、openSUSE) の場合:

      sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

    これらのオペレーティングシステムの場合、echoコマンドの出力は次のとおりです。Create file

  7. Cloud Assistantエージェントを実行します。

    aliyun-service -d

Alibaba Cloud CLIを使用してWindowsまたはLinuxインスタンスにCloud Assistant Agentをインストールする

この方法を利用するには、インスタンスに接続する必要はありませんが、Alibaba Cloud CLIをインストールする必要があります。 さまざまなオペレーティングシステムへのAlibaba Cloud CLIのインストール手順については、以下のトピックを参照してください。

説明

RHELはAlibaba Cloud CLIを使用したインストールをサポートしていません。

  1. 呼び出しDescribeCloudAssistantStatusターゲットECSインスタンスにCloud Assistantエージェントインストール済みです。

    aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]

    レスポンスがCloudAssistantStatus=trueの場合、ECSインスタンスにはすでにCloud Assistant Agentがインストールされています。インストールされていない場合は、次の手順に進みます。

  2. 呼び出しInstallCloudAssistantをインストールするには、Cloud Assistantエージェント.

    aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p
  3. 呼び出しRebootInstanceECSインスタンスを再起動します。

    aliyun ecs RebootInstance --InstanceId i-bp1g6zv0ce8og******p
  4. インスタンスがクラシックネットワーク上にある場合は、インスタンス内にリージョン宣言を追加します。

    1. root /システム権限でECSインスタンスにリモートログインします。

      詳細は、「ECSリモート接続方法の概要」をご参照ください。

    2. Cloud Assistantのバージョンを確認します。

      Cloud Assistant Agentのバージョンが1.0.1.400より高い場合、Cloud Assistant Agentは正常にインストールされています。 それ以外の場合は、次のステップに進みます。

    3. を作成します。Create aリージョンidファイルを入力し、ECSインスタンスのリージョンIDを入力します。

      Linux

      ECSインスタンスのリージョンを指定するには、Cloud Assistantのインストールディレクトリにregion-idという名前のファイルを作成し、インスタンスのリージョンIDを入力します。 次のコマンドを使用して、Cloud Assistantのデフォルトのインストールパスにリージョンid「cn-hangzhou」のリージョンIDファイルを生成します。

      • CoreOSオペレーティングシステムの場合:

        sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
      • その他のオペレーティングシステム (Alibaba Cloud Linux、Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、openSUSEなど)

        sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

      Alibaba Cloud Linux、Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、openSUSEなどの他のオペレーティングシステムの場合、echoコマンドの出力を以下に示しますOutput example

      Windows

      1. Cloud Assistantのインストールディレクトリにregion-idという名前のファイルを作成します (.txt.confなどの拡張子は追加しないでください) 。

        重要

        Windowsは、既知のファイルタイプの拡張子を非表示にします。 region-idに拡張子があるかどうかを判断するには、既知のファイルタイプの拡張子を表示するようにWindowsを設定する必要があります。

      2. region-IDファイルに、cn-hangzhouなどのECSインスタンスのリージョンidを入力します。

        説明

        ECSコンソールの [基本情報] エリアの [インスタンスの詳細] ページでECSインスタンスのリージョンを確認し、[リージョンとゾーン] で対応するリージョンIDを確認できます。

      たとえば、Windows Server 2012 R2では、新しく作成されたregion-idファイルと、デフォルトのインストールパスC:\ProgramData\aliyun\assist\ に入力されたregion ID cn-hangzhouは次のようになります在Windows上添加文件

インスタンスのCloud Assistant Agentに関する情報の表示

Cloud Assistant Agentをインストールした後、次の手順を実行して、ECSインスタンス上のCloud Assistant Agentのバージョン番号、ステータス、およびその他の情報を表示できます。

  1. にログインします。ECSコンソール.

  2. 左側のナビゲーションウィンドウで、メンテナンス&モニタリング > クラウドアシスタント.

  3. 上部のナビゲーションバーで、リソースが属するリージョンとリソースグループを選択します。 地域

  4. [ECSインスタンス] タブをクリックして、選択したリージョンのECSインスタンスのクラウドアシスタントエージェント情報を表示します。

    Query results

特定のカーネルバージョンでサポートされている最新バージョンのCloud Assistant Agent

インスタンスのカーネルバージョン

特定のカーネルバージョンでサポートされている最新バージョンのCloud Assistant Agent

2.6.32より前のLinuxカーネルバージョン

  • x86/x64アーキテクチャ: 2.2.3.398

  • ARMアーキテクチャ: 2.4.3.398

FreeBSD 11以前 (12.xより前のカーネルバージョン)

2.3.3.529