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 エージェントがプリインストールされています。
手順
コンソール
-
ECS コンソール - Cloud Assistant ページに移動します。
-
左上隅で、対象インスタンスのリージョンとリソースグループを選択します。
-
[ECS Instances] タブをクリックし、現在のリージョン内のインスタンスの Cloud Assistant エージェントのステータスを確認します。
-
[正常]:エージェントはインストールされています。
-
[未インストール]:[インストール] をクリックし、インストールが完了するまで待ちます。 インスタンスを再起動し、ステータスが [正常] に変わるかどうかを確認します。

-
[異常]:「Cloud Assistant の例外処理」を参照してください。
-
Linux インスタンス
エージェントインストールの確認
-
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 など。
-
-
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 インスタンス
エージェントインストールの確認
-
リモート デスクトップ クライアントまたは Windows アプリを使用して Windows インスタンスに接続します。
-
Cloud Assistant サービスのステータスを確認します。
-
スタートメニューを開き、 を検索します。
-
に移動します。
-
[Aliyun Assist Service] を探します。 リストにない場合、エージェントはインストールされていません。

-
エージェントのダウンロードとインストール
方法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 -
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
サポートされているすべてのオペレーティングシステムに適用されます。
-
DescribeCloudAssistantStatus API を呼び出して、対象インスタンスに Cloud Assistant エージェントがインストールされているかどうかを確認します。
CloudAssistantStatusがfalseの場合、エージェントはインストールされていません。 -
エージェントがインストールされていない場合は、InstallCloudAssistant API を呼び出してインストールします。
-
インストール後、RebootInstance API を呼び出してインスタンスを再起動します。
CLI
Alibaba Cloud CLI を使用します。 サポートされているすべてのオペレーティングシステムに適用されます。 <YOUR-REGION-ID> を ECS インスタンスの リージョン ID に、<YOUR-INSTANCE-ID> をインスタンス ID に置き換えてください。
Alibaba Cloud CLI のインストールは、Red Hat Enterprise Linux (RHEL) ではサポートされていません。
-
DescribeCloudAssistantStatus API を呼び出して、対象インスタンスに Cloud Assistant エージェントがインストールされているかどうかを確認します。
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]コマンドが
CloudAssistantStatus=trueを返す場合、エージェントはすでにインストールされています。 -
InstallCloudAssistant API を呼び出してエージェントをインストールします。
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> -
RebootInstance API を呼び出してインスタンスを再起動します。
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
よくある質問
サポートされていないオペレーティングシステム
-
OS の移行: サポートされているバージョンにアップグレードまたは移行してください。
-
OS (システムディスク) の交換: システムディスクをサポートされているオペレーティングシステムに交換してください。
最新バージョンをインストールできない場合
一部のカーネルでは、インストールできるエージェントのバージョンが制限されます。
uname -r を実行して、カーネルのバージョンを確認してください。
|
インスタンスのカーネルバージョン |
サポートされている最新バージョン |
|
Linux カーネルバージョン < 2.6.32 |
|
|
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:ブラウザーでダウンロードしてインストール
-
ブラウザーで次の URL を開き、Cloud Assistant エージェントをダウンロードしてください。
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -
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 を使用します。 他のディストリビューションの場合は、対応するパッケージマネージャーを使用してください。
-
Git や Go などの必要なソフトウェアをインストールします。
# Git のインストール sudo yum install git -y # Go のインストール sudo yum install go -y -
Cloud Assistant エージェントのソースコードをダウンロードします。
sudo git clone https://github.com/aliyun/aliyun_assist_client -
ソースコードディレクトリに移動してコンパイルします。
# ソースコードディレクトリに移動 cd ./aliyun_assist_client # ソースコードのコンパイル sudo go buildコマンドがエラーなく実行された場合、インストールは成功です。
クラシックネットワークでのエージェントの問題
クラシックネットワーク内の ECS インスタンスの場合、Cloud Assistant エージェントはリージョン情報を自動的に取得できません。 インスタンスにリージョン設定ファイルを手動で作成する必要があります。
クラシックネットワークは、新規購入では利用できなくなったレガシーなネットワークタイプです。 パフォーマンスとセキュリティを向上させるために、Virtual Private Cloud (VPC) への移行を推奨します。
Linux
-
エージェントのインストールディレクトリに、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'
-
-
Cloud Assistant エージェントを起動します。
aliyun-service -d
Windows
-
エージェントのインストールディレクトリに、region-id という名前のファイルを作成します (拡張子 .txt や .conf などは付けないでください)。
デフォルトでは、Windows は拡張子を非表示にします。 システムを設定して拡張子を表示させ、region-id ファイルに拡張子がないことを確認してください。
-
region-id ファイルに、インスタンスのリージョン ID (例:cn-hangzhou) を入力します。
例:中国 (杭州) の Windows Server 2012 R2 インスタンスの場合、C:\ProgramData\aliyun\assist\ に cn-hangzhou を含む region-id ファイルを作成します。