コンソールまたは 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 エージェントをプリインストールしています。
手順
コンソール
ECS コンソール - Cloud Assistant ページに移動します。
ページの左上隅で、対象のリソースグループとリージョンを選択します。
ECS インスタンス タブをクリックして、現在のリージョンにある ECS インスタンスの Cloud Assistant のステータスを表示します。
正常:エージェントはインストール済みです。
未インストール: インストール をクリックし、インストールが完了するまで待ちます。インスタンスを再起動し、ステータスが 正常 に変わることを確認します。
異常:詳細については、「Cloud Assistant の例外の処理」をご参照ください。
Linux インスタンス
ステップ 1:エージェントのインストールの確認
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出力が空の場合、エージェントはインストールされていません。
ステップ 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
fiWindows インスタンス
ステップ 1:エージェントのインストールの確認
Cloud Assistant サービスの状態を確認します。
スタートメニューを開き、 を検索します。
に移動します。
[Aliyun Assist Service] を探します。リストにない場合、エージェントはインストールされていません。
サービスが存在し、そのステータスが [実行中] で、スタートアップの種類が [自動] に設定されている場合、Cloud Assistant エージェントは正常にインストールされ、実行されています。
ステップ 2:エージェントのダウンロードとインストール
方法 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.exeCloud 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" /SAPI
API によるインストール手順は、サポートされているすべてのオペレーティングシステムで同じです。
DescribeCloudAssistantStatus API を呼び出して、対象の ECS インスタンスに Cloud Assistant エージェントがインストールされているかどうかを確認します。
CloudAssistantStatusパラメーターがfalseを返す場合、エージェントはインストールされていません。エージェントがインストールされていない場合は、InstallCloudAssistant API を呼び出して Cloud Assistant エージェントをインストールします。
インストールが完了したら、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 を使用したインストールをサポートしていません。
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 インスタンスにインストールされています。InstallCloudAssistant API を呼び出して Cloud Assistant エージェントをインストールします。
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>RebootInstance API を呼び出して ECS インスタンスを再起動します。
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
よくある質問
サポート対象外のオペレーティングシステム
OS の移行:現在のシステムをサポートされているバージョンにアップグレードまたは移行します。
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}"
# システムが 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
fiWindows
方法 1:ブラウザ経由でダウンロード
ブラウザで次の URL を開き、Cloud Assistant エージェントをダウンロードします。
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exeCloud 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 ディストリビューションの場合は、対応するパッケージマネージャーを使用してください。
Git や Go などの前提条件をインストールします。
# Git をインストールします sudo yum install git -y # Go をインストールします sudo yum install go -yCloud Assistant エージェントのソースコードをダウンロードします。
sudo git clone https://github.com/aliyun/aliyun_assist_clientソースコードディレクトリに移動し、ソースコードをコンパイルします。
# ソースコードディレクトリに移動します。 cd ./aliyun_assist_client # ソースコードをコンパイルします。 sudo go build応答にエラーメッセージが含まれていない場合、インストールは成功です。