コンソールまたは API を使用して、ログイン不要の管理、コマンドの実行、ファイル転送などの操作を行うには、対象の Elastic Compute Server (ECS) インスタンスにクラウドアシスタントエージェントをインストールして実行する必要があります。
注意事項
クラウドアシスタントエージェントは、次のオペレーティングシステム (OS) にインストールできます。
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 インスタンスには、クラウドアシスタントエージェントがプリインストールされています。
操作手順
コンソール
ECS コンソール - クラウドアシスタントに移動します。
上部のナビゲーションバーで、対象リソースのリソースグループとリージョンを選択します。
[ECS インスタンス] タブをクリックして、現在のリージョンにある ECS インスタンスのクラウドアシスタントのステータスを確認します。
正常:エージェントはインストールされています。
未インストール:[インストール] をクリックします。インストール後、インスタンスを再起動し、ステータスが [正常] に変わることを確認する必要があります。

異常:詳細については、「クラウドアシスタントの例外を処理する」をご参照ください。
Linux インスタンス
ステップ 1: インストール状況の確認
init システムのタイプを特定します。
init システムは、起動時にサービスプロセスを読み込んで管理する仕組みです。使用する 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 など。
エージェントがインストールされているかを確認します。
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: ダウンロードとインストール
このスクリプトは、デフォルトで最新バージョンのエージェントをインストールします。特定のバージョンをインストールするには、スクリプト内の 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: インストール状況の確認
クラウドアシスタントのサービスステータスを確認します。
[スタート] メニューをクリックし、 を検索します。
を選択します。
[Aliyun Assist Service] を探します。サービスが一覧にない場合、エージェントはインストールされていません。

ステップ 2: ダウンロードとインストール
方法 1: ブラウザからダウンロード
エージェントをダウンロードします。
URL 内の
{regionId}をインスタンスのリージョン ID に置き換え、ブラウザで開いてください。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エージェントをインストールします。
エージェントファイルをダブルクリックし、ウィザードに従ってインストールします。デフォルトのインストールパスは
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
このインストール手順は、すべての OS で共通です。
DescribeCloudAssistantStatus API を呼び出して、対象の ECS インスタンスにクラウドアシスタントエージェントがインストールされているかを確認します。
CloudAssistantStatusの戻り値がfalseの場合、エージェントはインストールされていません。エージェントがインストールされていない場合は、InstallCloudAssistant API を呼び出してインストールします。
インストール完了後、RebootInstance API を呼び出して ECS インスタンスを再起動し、インストールを完了します。
CLI
Alibaba Cloud CLI を使用する場合、クラウドアシスタントエージェントのインストール手順はすべての OS で共通です。<YOUR-REGION-ID> を対象の ECS インスタンスのリージョン ID に、<YOUR-INSTANCE-ID> を対象のインスタンス ID に置き換えてください。
Red Hat Enterprise Linux (RHEL) は、Alibaba Cloud CLI によるインストールをサポートしていません。
DescribeCloudAssistantStatus 操作を呼び出して、対象の ECS インスタンスにエージェントがインストールされているかを確認します。
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]コマンドが
CloudAssistantStatus=trueを返した場合、エージェントはすでにインストールされています。InstallCloudAssistant 操作を呼び出して、エージェントをインストールします。
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>RebootInstance 操作を呼び出して、ECS インスタンスを再起動します。
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
よくある質問
OS がエージェントをサポートしていない場合はどうすればよいですか?
OS のアップグレード/移行:現在のシステムをサポートされているバージョンにアップグレードまたは移行します。
OS (システムディスク) の交換:システムディスクを交換することで、サポートされている OS をインスタンスにインストールします。
OS がサポートされているのに、最新バージョンのエージェントをインストールできないのはなぜですか?
一部のカーネルでは、インストール可能なエージェントのバージョンが制限されています。
uname -r を実行して、カーネルバージョンを確認してください。インスタンスのカーネルバージョン | インストール可能なエージェントの最新バージョン |
Linux カーネルバージョン < 2.6.32 |
|
FreeBSD カーネルバージョン < 12.x | 2.3.3.529 |
FreeBSD OS にエージェントをインストールするにはどうすればよいですか?
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
マネージドインスタンス (Alibaba Cloud 以外のサーバー) にエージェントをインストールするにはどうすればよいですか?
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
fiWindows
方法 1: ブラウザからダウンロード
ブラウザで次の URL を開き、エージェントをダウンロードします。
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exeエージェントをインストールします。
エージェントファイルをダブルクリックし、ウィザードに従ってインストールします。デフォルトのインストールパスは
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 を使用します。他の Linux ディストリビューションを使用している場合は、対応するパッケージマネージャーを使用してください。
Git と Go をインストールします。
# Git をインストール sudo yum install git -y # Go をインストール sudo yum install go -yエージェントのソースコードをダウンロードします。
sudo git clone https://github.com/aliyun/aliyun_assist_clientソースコードディレクトリに移動し、コードをコンパイルします。
# ソースコードディレクトリに移動 cd ./aliyun_assist_client # ソースコードをコンパイル sudo go buildエラーが表示されなければ、インストールは成功です。
クラシックネットワークインスタンスにインストールした後、エージェントが動作しないのはなぜですか?
クラシックネットワーク内の ECS インスタンスではリージョン情報が自動取得されないため、設定ファイルを作成して手動でリージョンを設定する必要があります。
クラシックネットワークは、 Alibaba Cloud が提供していた旧世代のネットワークタイプであり、現在は購入できなくなっています。パフォーマンスとセキュリティを向上させるために、インスタンスを Virtual Private Cloud (VPC) に移行することを推奨します。
Linux
エージェントのインストールディレクトリに、ECS インスタンスのリージョン ID を含む
region-idという名前のファイルを作成します。たとえば、中国 (杭州) リージョンの場合、デフォルトのインストールディレクトリに
region-idファイルを作成します。CoreOS:
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'その他の OS (Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server、OpenSUSE など):
sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
エージェントを実行します。
aliyun-service -d
Windows
エージェントのインストールディレクトリに、region-id という名前のファイルを作成します。.txt や .conf などの拡張子は追加しないでください。
Windows はデフォルトで既知のファイルタイプの拡張子を非表示にしています。region-id ファイルに余計な拡張子がないことを確認するために、ファイル拡張子を表示するように設定を変更してください。
region-id ファイルに、ECS インスタンスのリージョン ID (例: cn-hangzhou) を入力します。
例:次の図は、Windows Server 2012 R2 インスタンスのデフォルトのインストールパス C:\ProgramData\aliyun\assist\ にある、cn-hangzhou リージョン用の region-id ファイルを示しています。