Cloud Assistant Agentは、ECSインスタンスでCloud Assistantコマンドを実行するためのプログラムです。 このトピックでは、Cloud Assistant Agentをインストールする方法について説明します。
前提条件
Cloud Assistant Agentをインストールする前に、インスタンスタイプとオペレーティングシステムを照会して、Cloud Assistantがサポートされていることを確認します。 詳細については、「制限」をご参照ください。
背景情報
2017年12月1日以降にパブリックイメージから作成されたECSインスタンスには、Cloud Assistant Agentがプリインストールされています。
インスタンスが2017年12月1日より前に購入されたか、アップロードしたカスタムイメージから作成されたもので、Cloud Assistantの機能を使用する場合は、このトピックの手順に従ってCloud Assistant Agentを手動でインストールします。
Alibaba Cloud以外のサーバーをAlibaba Cloudマネージドインスタンスとして登録することにより、サーバーは、Cloud Assistant、CloudOps Orchestration Service、Apsara Devopsなど、Alibaba Cloudが提供するさまざまなオンラインサービスを利用して、サーバーを管理または使用できます。 詳細については、「Alibaba Cloudマネージドインスタンス」をご参照ください。
Cloud Assistantでサポートされている機能に基づいて、適切なバージョンのCloud Assistantをインストールする必要があります。 次の表に、Cloud Assistantでサポートされている機能と、各機能でサポートされている最も古いバージョンのCloud Assistant Agentを示します。
Cloud Assistantでサポートされる機能 | Linuxインスタンスの最小バージョン番号 | Windowsインスタンスの最小バージョン番号 | 関連ドキュメント |
Cloud Assistantハートビートのレポートのサポート | 1.0.2.458 | 1.0.0.149 | なし |
ファイルの送信 | 1.0.2.569 | 1.0.0.149 | |
コマンドを実行するためのユーザー名の指定のサポート | 2.2.0.106 | 2.1.0.50 | |
次回のインスタンス起動時に実行するコマンドの設定のサポート | 2.2.0.46 | 2.1.0.50 | |
すべてのインスタンス起動時に実行するコマンドの設定のサポート | |||
セッション管理のサポート (session Manager) | 2.2.3.196 | 2.1.3.196 | |
スケジュールされたタスクの実行プランでのレート式またはat式の使用のサポート | 2.2.3.282 | 2.1.3.282 | |
スケジュールされたタスクの実行計画に <Year> フィールドまたは <Time zone> フィールドを含むcron式を指定するサポート | 2.2.3.282 | 2.1.3.282 | |
組み込み環境パラメータの指定のサポート | 2.2.3.309 | 2.1.3.309 | |
組み込み環境パラメータとしてのインスタンス名の使用のサポート | 2.2.3.344 | 2.1.3.344 | |
特定の終了コードを使用してインスタンスを停止または再起動するためのサポート | 2.2.3.317 | 2.1.3.317 | |
コマンドを実行するコンテナーの名前を指定するためのサポート | 2.2.3.344 | 2.1.3.344 | |
コマンドを実行するコンテナーのIDを指定するためのサポート | 2.2.3.344 | 2.1.3.344 |
次の表に、さまざまなオペレーティングシステムでのCloud Assistantクライアントのインストール方法を示します。
インスタンスオペレーティングシステム | インストール方法 |
Windows | |
Linux (Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux、Debian、Ubuntu) |
|
Linux (その他) |
|
WindowsインスタンスへのCloud Assistant Agentのインストール
管理者アカウントを使用してECSインスタンスへのリモート接続を確立します。
詳細については、「ECSリモート接続方法の概要」をご参照ください。
ダウンロードします。Cloud Assistantエージェント.
Cloud Assistant AgentはURLをダウンロードします。
パブリックURL (最新バージョン): Cloud Assistant Agent latest version
パブリックURL (特定のバージョン):
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe
内部URL (最新バージョン):
https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
内部URL (特定のバージョン):
https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe
説明{version} は、Cloud Assistant Agentの特定のバージョン番号です。
{regionId} は、インスタンスが配置されているリージョンのリージョンIDです。
ECSコンソールの [基本情報] セクションの [インスタンスの詳細] ページで、ECSインスタンスのリージョンを確認できます。 次に、[リージョンとゾーン] で対応するリージョンIDを表示できます。
次のCloud Assistantのバージョン番号は、パブリックURLまたは内部URLからダウンロードするために指定できます。
パブリックURL: 1.0.0.128、2.1.2.181、2.1.3.187、2.1.3.221、2.1.3.247、2.1.3.256、2.1.3.269、2.1.3.282、2.1.3.289、2.1.3.326、2.1.3.349、2.1.3.372、2.1.3.398
内部URL: 1.0.128、2.1.3.221、2.1.3.247、2.1.3.256、2.1.3.265、2.1.3.269、2.1.3.282、2.1.3.289、2.1.3.326、2.1.3.349、2.1.3.372、2.1.3.398
たとえば、中国 (杭州) リージョンの内部URLからバージョン1.0.0.128をダウンロードするには、次のURLを使用します。
https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_1.0.0.128_setup.exe
Cloud Assistant Agentファイルをダブルクリックし、インストールウィザードのプロンプトに従ってセットアップを完了します。
デフォルトのインストールパスを選択した場合、WindowsインスタンスのCloud Assistant AgentのインストールディレクトリはC:\ProgramData\aliyun\assist\ です。
上記のダウンロードとインストールの手順をPowerShellスクリプトに統合することもできます。 次のスクリプトでは、例として最新バージョンの内部URLを使用しています。 使用する場合は、
{regionId}
をインスタンスが配置されているリージョンのリージョンIDに置き換えます。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'
(オプション) インスタンスがクラシックネットワークにある場合は、次の操作を実行します。
Cloud Assistantのインストールディレクトリにregion-idという名前のファイルを作成します (.txtや .confなどの拡張子は追加しないでください) 。
重要Windowsは、既知のファイルタイプの拡張子を非表示にします。 region-idに拡張子があるかどうかを判断するには、既知のファイルタイプの拡張子を表示するようにWindowsを設定する必要があります。
region-IDファイルに、cn-hangzhouなどのECSインスタンスのリージョンidを入力します。
説明ECSコンソールの [基本情報] エリアの [インスタンスの詳細] ページでECSインスタンスのリージョンを確認し、[リージョンとゾーン] で対応するリージョンIDを確認できます。
たとえば、Windows Server 2012 R2では、新しく作成されたregion-idファイルと、デフォルトのインストールパスC:\ProgramData\aliyun\assist\ に入力されたregion ID cn-hangzhouは次のようになります。
LinuxインスタンスにCloud Assistant Agentをインストールする
RPMおよびDEBパッケージ管理方法
Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux、Debian、およびUbuntuオペレーティングシステムに適用できます。
sudo権限を持つユーザーとしてECSインスタンスに接続します。
詳細については、「WorkbenchでSSHプロトコルを使用したLinuxインスタンスへのログイン」をご参照ください。
次のスクリプトを実行して、Cloud Assistantインストールパッケージをダウンロードしてインストールします。
重要次のスクリプトは、デフォルトで最新バージョンのAgentをインストールします。 特定のバージョンをインストールする場合は、スクリプトの
version=latest
をVERSION=2.2.3.398
などの指定されたバージョン番号に変更します。 利用可能なバージョンは次のとおりです。x86バージョン: 2.2.0.102、2.2.0.106、2.2.2.181、2.2.3.187、2.2.3.221、2.2.3.247、2.2.3.256、2.2.3.269、2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.2.3.372、2.2.3.398
ARMバージョン: 2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398
内部ネットワークのダウンロードとインストールスクリプト
ECSインスタンスに推奨されます。 デフォルトでは、内部ネットワーク経由でダウンロードできます。
#!/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
パブリックネットワークのダウンロードとインストールスクリプト
Alibaba Cloud以外のホストおよびパブリックネットワークにアクセスできるECSインスタンスに適用できます。
#!/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
バイナリインストール方法
主流のLinuxオペレーティングシステムに適用できます。
sudo権限を持つユーザーとしてECSインスタンスに接続します。
詳細については、「WorkbenchでSSHプロトコルを使用したLinuxインスタンスへのログイン」をご参照ください。
次のスクリプトを実行して、Cloud Assistantインストールパッケージをダウンロードしてインストールします。
重要次のスクリプトは、デフォルトで最新バージョンのAgentをインストールします。 特定のバージョンをインストールする場合は、スクリプトの
version=latest
をVERSION=2.2.3.398
などの指定されたバージョン番号に変更します。 利用可能なバージョンは次のとおりです。x86バージョン: 2.2.3.282、2.2.3.289、2.2.3.326、2.2.3.349、2.2.3.372、2.2.3.398
ARMバージョン: 2.4.3.282、2.4.3.326、2.4.3.349、2.4.3.372、2.4.3.398
内部ネットワークのダウンロードとインストールスクリプト
ECSインスタンスに推奨されます。 デフォルトでは、内部ネットワーク経由でダウンロードできます。
#!/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}.deb" PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) PACKAGE="aliyun-assist-${VERSION}-1_arm64.deb" 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/ sudo chmod a+x $TARGET_DIR/$VERSION/update_install sudo bash $TARGET_DIR/$VERSION/update_install
パブリックネットワークのダウンロードとインストールスクリプト
Alibaba Cloud以外のホストおよびパブリックネットワークにアクセスできるECSインスタンスに適用できます。
#!/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/ sudo chmod a+x $TARGET_DIR/$VERSION/update_install sudo bash $TARGET_DIR/$VERSION/update_install
ソースコードのインストール方法
sudo権限を持つユーザーとしてECSインスタンスに接続します。
詳細については、「WorkbenchでSSHプロトコルを使用したLinuxインスタンスへのログイン」をご参照ください。
GitやGoなどの必要なソフトウェアをインストールします。
この例では、YUMを使用します。他のLinuxオペレーティングシステムの場合は、適切なパッケージマネージャを使用します。
Gitをインストールするには:
sudo yum install git -y
Goをインストールするには:
sudo yum install go -y
Cloud Assistant Agentソースコードをダウンロードします。
sudo git clone https://github.com/aliyun/aliyun_assist_client
ソースコードがあるディレクトリに移動します。
cd ./aliyun_assist_client
ソースコードをコンパイルします。
sudo go build
エラーメッセージが返されない場合、インストールは成功です。
インスタンスがクラシックネットワーク上にある場合は、以下を実行します。
Cloud Assistantインストールディレクトリにregion-idという名前のファイルを作成し、ECSインスタンスのリージョンIDを書き込みます。 次のコマンドを使用してregion-idファイルを作成し、リージョンID cn-hangzhouをデフォルトのCloud Assistantインストールパスに追加します。
CoreOSオペレーティングシステムの場合:
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
その他のオペレーティングシステム (Alibaba Cloud Linux、Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、openSUSE) の場合:
sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
これらのオペレーティングシステムの場合、echoコマンドの出力は次のとおりです。
Cloud Assistantエージェントを実行します。
aliyun-service -d
Alibaba Cloud CLIを使用してWindowsまたはLinuxインスタンスにCloud Assistant Agentをインストールする
この方法を利用するには、インスタンスに接続する必要はありませんが、Alibaba Cloud CLIをインストールする必要があります。 さまざまなオペレーティングシステムへのAlibaba Cloud CLIのインストール手順については、以下のトピックを参照してください。
RHELはAlibaba Cloud CLIを使用したインストールをサポートしていません。
呼び出しDescribeCloudAssistantStatusターゲットECSインスタンスにCloud Assistantエージェントインストール済みです。
aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]
レスポンスが
CloudAssistantStatus=true
の場合、ECSインスタンスにはすでにCloud Assistant Agentがインストールされています。インストールされていない場合は、次の手順に進みます。呼び出しInstallCloudAssistantをインストールするには、Cloud Assistantエージェント.
aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p
呼び出しRebootInstanceECSインスタンスを再起動します。
aliyun ecs RebootInstance --InstanceId i-bp1g6zv0ce8og******p
インスタンスがクラシックネットワーク上にある場合は、インスタンス内にリージョン宣言を追加します。
root /システム権限でECSインスタンスにリモートログインします。
詳細は、「ECSリモート接続方法の概要」をご参照ください。
Cloud Assistantのバージョンを確認します。
Linuxの場合: 以下のコマンドを実行します。
aliyun-service -v
Windowsの場合: ガイダンスについては、「Cloud Assistant Agentの自動アップグレードのアップグレードまたは無効化」をご参照ください。
Cloud Assistant Agentのバージョンが1.0.1.400より高い場合、Cloud Assistant Agentは正常にインストールされています。 それ以外の場合は、次のステップに進みます。
を作成します。Create aリージョンidファイルを入力し、ECSインスタンスのリージョンIDを入力します。
Linux
ECSインスタンスのリージョンを指定するには、Cloud Assistantのインストールディレクトリにregion-idという名前のファイルを作成し、インスタンスのリージョンIDを入力します。 次のコマンドを使用して、Cloud Assistantのデフォルトのインストールパスにリージョンid「cn-hangzhou」のリージョンIDファイルを生成します。
CoreOSオペレーティングシステムの場合:
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
その他のオペレーティングシステム (Alibaba Cloud Linux、Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、openSUSEなど)
sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
Alibaba Cloud Linux、Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、openSUSEなどの他のオペレーティングシステムの場合、echoコマンドの出力を以下に示します。
Windows
Cloud Assistantのインストールディレクトリにregion-idという名前のファイルを作成します (.txtや .confなどの拡張子は追加しないでください) 。
重要Windowsは、既知のファイルタイプの拡張子を非表示にします。 region-idに拡張子があるかどうかを判断するには、既知のファイルタイプの拡張子を表示するようにWindowsを設定する必要があります。
region-IDファイルに、cn-hangzhouなどのECSインスタンスのリージョンidを入力します。
説明ECSコンソールの [基本情報] エリアの [インスタンスの詳細] ページでECSインスタンスのリージョンを確認し、[リージョンとゾーン] で対応するリージョンIDを確認できます。
たとえば、Windows Server 2012 R2では、新しく作成されたregion-idファイルと、デフォルトのインストールパスC:\ProgramData\aliyun\assist\ に入力されたregion ID cn-hangzhouは次のようになります。
インスタンスのCloud Assistant Agentに関する情報の表示
Cloud Assistant Agentをインストールした後、次の手順を実行して、ECSインスタンス上のCloud Assistant Agentのバージョン番号、ステータス、およびその他の情報を表示できます。
にログインします。ECSコンソール.
左側のナビゲーションウィンドウで、 .
上部のナビゲーションバーで、リソースが属するリージョンとリソースグループを選択します。
[ECSインスタンス] タブをクリックして、選択したリージョンのECSインスタンスのクラウドアシスタントエージェント情報を表示します。
特定のカーネルバージョンでサポートされている最新バージョンのCloud Assistant Agent
インスタンスのカーネルバージョン | 特定のカーネルバージョンでサポートされている最新バージョンのCloud Assistant Agent |
2.6.32より前のLinuxカーネルバージョン |
|
FreeBSD 11以前 (12.xより前のカーネルバージョン) | 2.3.3.529 |