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

Elastic Compute Service:Cloud Assistant エージェントのインストール

最終更新日:May 16, 2026

Elastic Compute Service (ECS) インスタンスに Cloud Assistant エージェントをインストールして起動し、コマンドのリモート実行やファイル送信を行います。

適用範囲

Cloud Assistant エージェントは、以下のオペレーティングシステムをサポートしています。

  • Linux:Alibaba Cloud Linux、AlmaLinux 8+、Anolis OS 7+、CentOS 5+、Debian 8+、Ubuntu 12+、RHEL 5+、SUSE 11+、Fedora 33+、CoreOS、および OpenSUSE。

  • FreeBSD:11+。

  • Windows:Server 2012+。

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

手順

コンソール

  1. ECS コンソール - Cloud Assistant ページに移動します。

  2. 左上隅で、対象インスタンスのリージョンとリソースグループを選択します。

  3. [ECS Instances] タブをクリックし、現在のリージョン内のインスタンスの Cloud Assistant エージェントのステータスを確認します。

    • [正常]:エージェントはインストールされています。

    • [未インストール][インストール] をクリックし、インストールが完了するまで待ちます。 インスタンスを再起動し、ステータスが [正常] に変わるかどうかを確認します。

      image.png

    • [異常]:「Cloud Assistant の例外処理」を参照してください。

Linux インスタンス

エージェントインストールの確認

  1. Workbench を使用して Linux インスタンスにログインします

  2. init システムのタイプを特定します。

    init システムは、起動時にサービスプロセスを管理します。 Cloud Assistant エージェントのコマンドは init システムによって異なります。
    • systemd:Alibaba Cloud Linux、CentOS 7+、RHEL 7+、Fedora 15+、Ubuntu 15.04+、Debian 8+ など。

    • Upstart:Ubuntu 6.10–14.10、RHEL 6、CentOS 6 など。

    • SysVinit:RHEL 5、CentOS 5、Debian 6 など。

  3. Cloud Assistant エージェントがインストールされていることを確認します。

    Systemd

    systemctl status aliyun.service

    出力に Unit aliyun.service could not be found が含まれている場合、エージェントはインストールされていません。

    Upstart

    /sbin/initctl status aliyun-service

    出力に initctl: Unknown job: aliyun-service が含まれている場合、エージェントはインストールされていません。

    Sysvinit

    /etc/init.d/aliyun-service status

    出力が空の場合、エージェントはインストールされていません。

エージェントのダウンロードとインストール

このスクリプトは Alibaba Cloud ECS インスタンスを対象としています。デフォルトで最新バージョンのエージェントをインストールします。特定のバージョンをインストールするには、VERSION=latest の行を変更してください。

#!/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

Windows インスタンス

エージェントインストールの確認

  1. リモート デスクトップ クライアントまたは Windows アプリを使用して Windows インスタンスに接続します

  2. Cloud Assistant サービスのステータスを確認します。

    1. スタートメニューを開き、[コンピューターの管理] を検索します。

    2. [サービスとアプリケーション] > [サービス] に移動します。

    3. [Aliyun Assist Service] を探します。 リストにない場合、エージェントはインストールされていません。

      image

エージェントのダウンロードとインストール

方法1:ブラウザーでダウンロードしてインストール
  1. Cloud Assistant エージェントをダウンロードします。

    インスタンスの リージョン ID{regionId} を置き換え、ブラウザーで URL を開いてください。

    https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
    
    # 例:中国 (杭州) リージョン (cn-hangzhou) のダウンロード URL
    https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. Cloud Assistant エージェントをインストールします。

    エージェントファイルをダブルクリックし、インストールウィザードに従ってください。 デフォルトのパスは C:\ProgramData\aliyun\assist\ です。

方法2:PowerShell を使用してインストール

インスタンスの リージョン ID{regionId} を置き換えてから、PowerShell でスクリプトを実行してください。

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

API

サポートされているすべてのオペレーティングシステムに適用されます。

  1. DescribeCloudAssistantStatus API を呼び出して、対象インスタンスに Cloud Assistant エージェントがインストールされているかどうかを確認します。

    CloudAssistantStatusfalse の場合、エージェントはインストールされていません。

  2. エージェントがインストールされていない場合は、InstallCloudAssistant API を呼び出してインストールします。

  3. インストール後、RebootInstance API を呼び出してインスタンスを再起動します。

CLI

Alibaba Cloud CLI を使用します。 サポートされているすべてのオペレーティングシステムに適用されます。 <YOUR-REGION-ID> を ECS インスタンスの リージョン ID に、<YOUR-INSTANCE-ID> をインスタンス ID に置き換えてください。

Alibaba Cloud CLI のインストールは、Red Hat Enterprise Linux (RHEL) ではサポートされていません。
  1. DescribeCloudAssistantStatus API を呼び出して、対象インスタンスに Cloud Assistant エージェントがインストールされているかどうかを確認します。

    aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]

    コマンドが CloudAssistantStatus=true を返す場合、エージェントはすでにインストールされています。

  2. InstallCloudAssistant API を呼び出してエージェントをインストールします。

    aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
  3. RebootInstance API を呼び出してインスタンスを再起動します。

    aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>

よくある質問

サポートされていないオペレーティングシステム

  • OS の移行 サポートされているバージョンにアップグレードまたは移行してください。

  • OS (システムディスク) の交換 システムディスクをサポートされているオペレーティングシステムに交換してください。

最新バージョンをインストールできない場合

一部のカーネルでは、インストールできるエージェントのバージョンが制限されます。

uname -r を実行して、カーネルのバージョンを確認してください。

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

サポートされている最新バージョン

Linux カーネルバージョン < 2.6.32

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

  • Arm アーキテクチャ:2.4.3.398

FreeBSD カーネルバージョン < 12.x

2.3.3.529

FreeBSD へのインストール

  • Alibaba Cloud ECS インスタンスの場合

    #!/bin/sh
    
    VERSION=latest
    use_curl=0
    which curl >/dev/null 2>&1 && use_curl=1
    if [ $use_curl -eq 1 ];then
        REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
    else
        REGION=$(wget -O - http://100.100.100.200/latest/meta-data/region-id)
    fi
    DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
    PACKAGE=aliyun_assist_${VERSION}.txz
    PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
    
    if [ $use_curl -eq 1 ];then
        curl -o $PACKAGE $PKG_URI
    else
        wget -O $PACKAGE $PKG_URI
    fi
    pkg install -U -y $PACKAGE
    service aliyun start
  • マネージドインスタンス (Alibaba Cloud でホストされていないサーバー) の場合

    #!/bin/sh
    
    VERSION=latest
    DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
    PACKAGE=aliyun_assist_${VERSION}.txz
    PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
    
    use_curl=0
    which curl >/dev/null 2>&1 && use_curl=1
    if [ $use_curl -eq 1 ];then
        curl -o $PACKAGE $PKG_URI
    else
        wget -O $PACKAGE $PKG_URI
    fi
    pkg install -U -y $PACKAGE
    service aliyun start

マネージドインスタンスへのインストール

Linux

デフォルトで最新バージョンのエージェントをインストールします。 特定のバージョンをインストールするには、VERSION=latest の行を変更してください。
#!/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

Windows

方法1:ブラウザーでダウンロードしてインストール
  1. ブラウザーで次の URL を開き、Cloud Assistant エージェントをダウンロードしてください。

    https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. Cloud Assistant エージェントをインストールします。

    エージェントファイルをダブルクリックし、インストールウィザードに従ってください。 デフォルトのパスは C:\ProgramData\aliyun\assist\ です。

方法2:PowerShell を使用してインストール
curl -UseBasicParsing -Uri https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe'
& "C:\\aliyun_agent_latest_setup.exe" /S

バイナリまたはソースからのインストール

バイナリパッケージ

  • Alibaba Cloud ECS インスタンスの場合

    デフォルトで最新バージョンのエージェントをインストールします。 特定のバージョンをインストールするには、VERSION=latest の行を変更してください。
    #!/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}_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/
    TRUE_VERSION=$(cat $TARGET_DIR/version)
    sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
    sudo bash $TARGET_DIR/$TRUE_VERSION/update_install
  • マネージドインスタンス (Alibaba Cloud でホストされていないサーバー) の場合

    #!/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/
    TRUE_VERSION=$(cat $TARGET_DIR/version)
    sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
    sudo bash $TARGET_DIR/$TRUE_VERSION/update_install

ソースコード

次の例では yum を使用します。 他のディストリビューションの場合は、対応するパッケージマネージャーを使用してください。

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

    # Git のインストール
    sudo yum install git -y
    
    # Go のインストール
    sudo yum install go -y
  2. Cloud Assistant エージェントのソースコードをダウンロードします。

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  3. ソースコードディレクトリに移動してコンパイルします。

    # ソースコードディレクトリに移動
    cd ./aliyun_assist_client
    
    # ソースコードのコンパイル
    sudo go build

    コマンドがエラーなく実行された場合、インストールは成功です。

クラシックネットワークでのエージェントの問題

クラシックネットワーク内の ECS インスタンスの場合、Cloud Assistant エージェントはリージョン情報を自動的に取得できません。 インスタンスにリージョン設定ファイルを手動で作成する必要があります。

クラシックネットワークは、新規購入では利用できなくなったレガシーなネットワークタイプです。 パフォーマンスとセキュリティを向上させるために、Virtual Private Cloud (VPC) への移行を推奨します。

Linux

  1. エージェントのインストールディレクトリに、ECS インスタンスのリージョン ID を含む region-id という名前のファイルを作成します。

    たとえば、中国 (杭州) リージョンのインスタンスの場合、デフォルトのディレクトリ /usr/local/share/aliyun-assist/region-id ファイルを作成します。

    • CoreOS の場合:

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

      sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
  2. Cloud Assistant エージェントを起動します。

    aliyun-service -d

Windows

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

    デフォルトでは、Windows は拡張子を非表示にします。 システムを設定して拡張子を表示させ、region-id ファイルに拡張子がないことを確認してください。
  2. region-id ファイルに、インスタンスのリージョン ID (例:cn-hangzhou) を入力します。

例:中国 (杭州) の Windows Server 2012 R2 インスタンスの場合、C:\ProgramData\aliyun\assist\cn-hangzhou を含む region-id ファイルを作成します。Add region-id file on Windows