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

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

最終更新日:Aug 21, 2026

コンソールまたは API を使用して、ログインせずにインスタンスを管理したり、コマンドを実行したり、ファイルを送信したりするには、対象のインスタンスに 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:Windows Server 2012+。

Alibaba Cloud は、2017 年 12 月 1 日以降にパブリックイメージから作成された Elastic Compute Service (ECS) インスタンスに Cloud Assistant エージェントをプリインストールしています。

手順

コンソール

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

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

  3. ECS インスタンス タブをクリックして、現在のリージョンにある ECS インスタンスの Cloud Assistant のステータスを表示します。

    • 正常:エージェントはインストール済みです。

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

    • 異常:詳細については、「Cloud Assistant の例外の処理」をご参照ください。

Linux インスタンス

ステップ 1:エージェントのインストールの確認

  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

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

ステップ 2:エージェントのダウンロードとインストール

このスクリプトは Alibaba Cloud ECS インスタンス用です。デフォルトでは、最新のエージェントバージョンがインストールされます。特定のバージョンをインストールするには、VERSION=latest を変更します。

#!/bin/bash
VERSION=latest
PACKAGE=
PKG_URI=

REGION=$(curl -s 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}"

# システムが openSUSE または SLES であるか検出します。
is_suse_like() {
    if [[ -f /etc/os-release ]]; then
        local os_id
        os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
        local os_version
        os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
        if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
            return 0
        fi
    fi
    return 1
}

case $arch in
    "i386"|"i686"|"x86_64"|"amd64")
        if command -v rpm && ! command -v dpkg; then
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.rpm"
            else
                PACKAGE="aliyun_assist_${VERSION}.rpm"
            fi
        else
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.deb"
            else
                PACKAGE="aliyun_assist_${VERSION}.deb"
            fi
        fi
        PKG_URI="https://$DOMAIN/linux/$PACKAGE"
        ;;
    *)
        if command -v rpm && ! command -v dpkg; then
            PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
        else
            PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
        fi
        PKG_URI="https://$DOMAIN/arm/$PACKAGE"
        ;;
esac

echo "[main] package = ${PACKAGE}"
echo "[main] pkg_uri = ${PKG_URI}"

if command -v wget; then
    sudo wget -O "${PACKAGE}" "${PKG_URI}"
elif command -v curl; then
    sudo curl -o "${PACKAGE}" "${PKG_URI}"
else
    echo "[WARN] command wget/curl not found, exit"
    exit 1
fi

if command -v rpm && ! command -v dpkg; 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. リモートデスクトップクライアントまたは Windows アプリを使用して Windows インスタンスに接続します。

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

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

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

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

      サービスが存在し、そのステータスが [実行中] で、スタートアップの種類が [自動] に設定されている場合、Cloud Assistant エージェントは正常にインストールされ、実行されています。

ステップ 2:エージェントのダウンロードとインストール

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

    {regionId} をお使いのインスタンスの リージョン ID に置き換えてから、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 エージェントをインストールします。

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

方法 2:PowerShell の使用

{regionId} をインスタンスのリージョン ID に置き換えてから、 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

API によるインストール手順は、サポートされているすべてのオペレーティングシステムで同じです。

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

    CloudAssistantStatus パラメーターが false を返す場合、エージェントはインストールされていません。

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

  3. インストールが完了したら、RebootInstance API を呼び出して ECS インスタンスを再起動し、変更を反映させます。

CLI

Alibaba Cloud CLI を使用して、サポートされているほとんどのオペレーティングシステムに Cloud Assistant エージェントをインストールできます。 <YOUR-REGION-ID> をお使いの ECS インスタンスの リージョン ID に、<YOUR-INSTANCE-ID> をお使いの ECS インスタンスの ID に置き換えます。

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

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

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

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

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

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

よくある質問

サポート対象外のオペレーティングシステム

  • OS の移行:現在のシステムをサポートされているバージョンにアップグレードまたは移行します。

  • 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}"

# システムが openSUSE または SLES であるか検出します。
is_suse_like() {
    if [[ -f /etc/os-release ]]; then
        local os_id
        os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
        local os_version
        os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
        if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
            return 0
        fi
    fi
    return 1
}

case $arch in
    "i386"|"i686"|"x86_64"|"amd64")
        if command -v rpm && ! command -v dpkg; then
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.rpm"
            else
                PACKAGE="aliyun_assist_${VERSION}.rpm"
            fi
        else
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.deb"
            else
                PACKAGE="aliyun_assist_${VERSION}.deb"
            fi
        fi
        PKG_URI="https://$DOMAIN/linux/$PACKAGE"
        ;;
    *)
        if command -v rpm && ! command -v dpkg; then
            PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
        else
            PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
        fi
        PKG_URI="https://$DOMAIN/arm/$PACKAGE"
        ;;
esac

echo "[main] package = ${PACKAGE}"
echo "[main] pkg_uri = ${PKG_URI}"

if command -v wget; then
    sudo wget -O "${PACKAGE}" "${PKG_URI}"
elif command -v curl; then
    sudo curl -o "${PACKAGE}" "${PKG_URI}"
else
    echo "[WARN] command wget/curl not found, exit"
    exit 1
fi

if command -v rpm && ! command -v dpkg; 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 エージェントをインストールします。

    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 -s 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}"
    
    # システムが openSUSE または SLES であるか検出します。
    is_suse_like() {
        if [[ -f /etc/os-release ]]; then
            local os_id
            os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
            local os_version
            os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
            if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
                return 0
            fi
        fi
        return 1
    }
    
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_update_x86_64.zip"
            else
                PACKAGE="aliyun_assist_${VERSION}_update.zip"
            fi
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
            ;;
    esac
    
    echo "[main] package = ${PACKAGE}"
    echo "[main] pkg_uri = ${PKG_URI}"
    
    if command -v wget; then
        sudo wget -O "${PACKAGE}" "${PKG_URI}"
    elif command -v curl; then
        sudo 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}"
    
    # システムが openSUSE または SLES であるか検出します。
    is_suse_like() {
        if [[ -f /etc/os-release ]]; then
            local os_id
            os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
            local os_version
            os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
            if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
                return 0
            fi
        fi
        return 1
    }
    
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_update_x86_64.zip"
            else
                PACKAGE="aliyun_assist_${VERSION}_update.zip"
            fi
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
            ;;
    esac
    
    echo "[main] package = ${PACKAGE}"
    echo "[main] pkg_uri = ${PKG_URI}"
    
    if command -v wget; then
        sudo wget -O "${PACKAGE}" "${PKG_URI}"
    elif command -v curl; then
        sudo 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 を使用します。他の Linux ディストリビューションの場合は、対応するパッケージマネージャーを使用してください。

  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

    応答にエラーメッセージが含まれていない場合、インストールは成功です。