サードパーティのサーバーを Alibaba Cloud のマネージドインスタンスとして登録することで、Cloud Assistant、CloudOps Orchestration Service、Alibaba Cloud DevOps などの Alibaba Cloud サービスによる管理が可能になります。たとえば、Cloud Assistant を使用して、ログインせずにサーバーを管理できます。
制限事項
サードパーティサーバーの要件
サポートされるオペレーティングシステム:
Alibaba Cloud Linux 2 および 3
CentOS 6 以降
CoreOS および OpenSUSE
Debian 8、9、10 以降
Red Hat Enterprise Linux (RHEL) 5、6、7 以降
SUSE Linux Enterprise Server (SLES) 11、12、15 以降
Ubuntu 12、14、16、18 以降
Windows Server 2012、2016、2019 以降
サーバーはパブリックネットワークにアクセスできる必要があります。
リージョンの利用可能性
マネージドインスタンス機能は、次のリージョンでのみ利用できます:
中国 (青島)、中国 (北京)、中国 (張家口)、中国 (フフホト)、中国 (ウランチャブ)、中国 (杭州)、中国 (上海)、中国 (深セン)、中国 (河源)、中国 (広州)、中国 (成都)、香港 (中国)、日本 (東京)、韓国 (ソウル)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、フィリピン (マニラ)、タイ (バンコク)、ドイツ (フランクフルト)、英国 (ロンドン)、米国 (シリコンバレー)、米国 (バージニア)、UAE (ドバイ)、SAU (リヤド)。
課金
マネージドインスタンス機能は無料サービスです。
使用する他の Alibaba Cloud サービスについては課金される場合があります。詳細については、各サービスのドキュメントをご参照ください。
ステップ 1:登録コードの作成
サードパーティサーバーを登録するには、まず登録コード (アクティベーションコードとも呼ばれます) を作成する必要があります。このコードはサーバーの ID を検証するための認証情報として機能し、承認されたサーバーのみが Alibaba Cloud マネージドインスタンスとして登録できるようにします。
1 つの登録コードを使用して、最大 1,000 個のマネージドインスタンスを登録できます。
リージョンごとに最大 5,000 個の登録コードを作成できます。
1,000 個を超える登録コードがある場合、既存のコードの使用率が 50% を超えている場合にのみ、新しいコードを作成できます。
ECS クラウドアシスタント ページの インスタンスの管理 タブで、インスタンスの登録 をクリックします。 登録済みインスタンス数/登録クォータ 列で登録コードの使用状況データを確認できます。
ECS コンソール - ECS クラウドアシスタントに移動します。
上部メニューで、対象リソースのリージョンとリソースグループを選択します。
重要登録コードとそれに対応するマネージドインスタンスは、選択したリージョンに固有です。
ネットワーク接続が最も高速なリージョンを選択することを推奨します。サードパーティサーバーで ping コマンドを実行して、異なるリージョンへの接続速度をテストできます。
<RegionId>プレースホルダーのリージョン ID は、「リージョンとゾーン」から取得できます。ping -c 4 <RegionId>.axt.aliyuncs.comインスタンスの管理 タブで、登録コードを作成します。
シナリオ 1: 現在のリージョンにインスタンスが登録されていない場合は、登録コードの作成 をクリックし、手順 4 に進みます。

シナリオ 2: 現在のリージョンにインスタンスが登録されている場合は、インスタンスの登録 をクリックします。インスタンスの登録 ペインで、登録コードの作成 をクリックします。

登録コードの作成 ペインで、マネージドインスタンスのパラメーターを設定します。
パラメーター
説明
[インスタンス名のプレフィックス]
マネージドインスタンス名のプレフィックス。管理を容易にするために、プレフィックスを指定することを推奨します。
[送信元 IP アドレス]
管理対象インスタンスの IP アドレスまたは CIDR ブロック。
パブリック IP アドレスまたは CIDR ブロックを指定した場合、指定した範囲内の IP アドレスを持つサーバーのみ登録できます。
このパラメーターを空にした場合、サーバーに IP アドレス制限は適用されません。
[インスタンスクォータ]
このコードで登録できるインスタンスの最大数。
値の範囲:1~1,000。デフォルト値:10。
[有効期間]
登録コードが有効な期間。有効期限が切れたコードは、新しいサーバーの登録に使用できません。
デフォルト:4 時間。
[説明]
登録コードの説明 (用途など)。これにより、登録コードの管理が容易になります。
[タグ]
登録コードにタグキーとタグ値を追加すると、分類、管理、メンテナンスが容易になります。
重要このコードで登録されたマネージドインスタンスには、指定されたタグキーとタグ値が自動的に付与されます。
[リソースグループ]
マネージドインスタンスを追加するリソースグループを選択します。これにより、用途や権限に基づいてマネージドインスタンスを管理できます。
重要登録コードを使用して登録されたマネージドインスタンスは、登録コードのリソースグループに自動的に追加されます。
リソースグループを指定しない場合、インスタンスはデフォルトのリソースグループに追加されます。
マネージドインスタンスの RAM ポリシーとリソースグループベースの認可の詳細については、「マネージドインスタンスのカスタム RAM ポリシーの例」および「リソースグループと認可」をご参照ください。
登録コードの生成 をクリックします。
インストールスクリプトが生成されます。このスクリプトをサードパーティサーバーで実行する必要があります。

インストールスクリプトを取得します。
サーバーのオペレーティングシステムを選択し、ダウンロード または コピー をクリックして、インストールスクリプトをローカルマシンに保存します。
rpm: Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux などのオペレーティングシステム用。
deb: Debian や Ubuntu などのオペレーティングシステム用。
exe: Windows Server オペレーティングシステム用。
重要登録コードが生成されると、インストールスクリプトは一度だけ表示されるため、ローカルパスに保存する必要があります。たとえば、
installAssistant.shとして保存し、後続のステップでインスタンスを登録する際に使用します。異なるオペレーティングシステムを使用しているサーバーがある場合は、各オペレーティングシステム用のインストールスクリプトをダウンロードする必要があります。
手順 2: サーバーへの Cloud Assistant Agent のインストールとインスタンスの登録
前のステップで取得したインストールスクリプトをサーバーで実行し、マネージドインスタンスとして登録します。
Linux サーバー
パブリックネットワーク経由での接続
サードパーティサーバーにログインします。
サーバーにインストールスクリプトを作成します。
次のコマンドを実行してスクリプトファイルを作成し、ステップ 1 でコピーしたインストールスクリプトをファイルに貼り付けます。
vim installAssistant.shEscキーを押し、:wqと入力して保存します。
次のコマンドを実行して、インストールスクリプトに実行権限を付与します。
sudo chmod 755 installAssistant.sh次のコマンドを実行して、サーバーに Cloud Assistant Agent をインストールします。
sudo ./installAssistant.sh次のメッセージが表示され、インストールが成功したことを示します。

プロキシサーバー経由での接続
このセクションでは、CentOS 7.8 を例として、プロキシサーバー経由で Cloud Assistant Agent をインストールし、マネージドインスタンスを登録する方法について説明します。
SSH などの方法を使用してサーバーにログインします。
詳細については、「接続方法」をご参照ください。
次のコマンドを実行して、プロキシサーバー経由で Cloud Assistant Agent をダウンロードします。
x86 ベースアーキテクチャ:
sudo https_proxy=<http://your_proxy_address> && wget https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpmARM ベースアーキテクチャ:
sudo https_proxy=<http://your_proxy_address> && wget https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm重要<http://your_proxy_address>をプロキシサーバーのアドレスに置き換えてください。次のコマンドを実行して Cloud Assistant Agent をインストールします。
x86 ベースアーキテクチャ:
sudo rpm -ivh aliyun_assist_latest.rpm --forceARM ベースアーキテクチャ:
sudo rpm -ivh aliyun-assist-latest-1.aarch64.rpm --forceCloud Assistant サービスのプロキシを設定します。
Cloud Assistant サービスの設定ファイルを変更します。
Cloud Assistant サービスの設定ファイルを変更して、ALIYUN_ASSIST_PROXY 環境変数を設定します。
Vim を使用して /etc/sysconfig/aliyun ファイルを作成します。
sudo vim /etc/sysconfig/aliyun次の内容を入力してファイルを保存します。
ALIYUN_ASSIST_PROXY=<http://your_proxy_address>重要<http://your_proxy_address>をプロキシサーバーのアドレスに置き換えてください。
次のコマンドを実行して、systemd 設定を再読み込みします。
sudo systemctl daemon-reload次のコマンドを実行して、Cloud Assistant サービスを再起動します。
sudo systemctl restart aliyun.serviceCloud Assistant サービスが起動したら、Cloud Assistant ログファイルを確認します。デフォルトでは、ログファイルは /usr/local/share/aliyun-assist/{version}/log/aliyun_assist_main.log パスに保存されます。ログファイルに
Detected environment variable ALIYUN_ASSIST_PROXY for proxy settingが含まれている場合、Cloud Assistant サービスにプロキシが設定されていることを示します。
次のコマンドを実行して、プロキシサーバー経由でマネージドインスタンスを登録します。
次のコマンドを実行して、プロキシサーバーを設定します。
export ALIYUN_ASSIST_PROXY=<http://your_proxy_address>重要<http://your_proxy_address>をプロキシサーバーのアドレスに置き換えてください。次のコマンドを実行して、サーバーをマネージドインスタンスとして登録します。
重要このコマンドは参考用です。ステップ 1 のコンソールからコマンドをコピーしてください。
sudo aliyun-service --register --RegionId "cn-hangzhou" \ --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \ --ActivationId "045CE381-0404-4F42-A44B-CC232B3E****"
Express Connect 経由での VPC 接続
このセクションでは、CentOS を例として、Express Connect 回線を介して Cloud Assistant エージェントをインストールし、次に VPC の内部ネットワークを介してマネージドインスタンスを登録する方法について説明します。
SSH などの方法を使用してサーバーにログインします。
詳細については、「接続方法」をご参照ください。
次のスクリプトを実行して、VPC 内部ネットワーク経由でマネージドインスタンスを登録します。
次のコードは例です。
RegionId、ActivationCode、ActivationIdの値を、ステップ 1 で生成されたスクリプトの値に置き換えてください。CentOS
#/bin/bash ## リージョンIDを設定します。 regionId="cn-hangzhou" if [[ -n $regionId ]]; then bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com" ## Cloud Assistant エージェントをダウンロードします。 wget -q https://${bucket}/linux/aliyun_assist_latest.rpm ## Cloud Assistant エージェントをインストールします。 sudo rpm -ivh aliyun_assist_latest.rpm --force fi ## VPC 内部ネットワーク経由でマネージドインスタンスを登録します。注意:NetworkMode パラメーターを vpc に設定する必要があります。 ## コンソールの登録コード作成ページから、RegionId、ActivationCode、ActivationId パラメーターの値をコピーします。 sudo aliyun-service --register \ --NetworkMode "vpc" \ --RegionId "${regionId}" \ --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \ --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"Debian およびその他の Linux
#!/bin/bash ## リージョンIDを設定します。 regionId="cn-hangzhou" if [[ -n $regionId ]]; then bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com" ## Cloud Assistant エージェントをダウンロードします。 wget -q https://${bucket}/linux/aliyun_assist_latest.deb ## Cloud Assistant エージェントをインストールします。 sudo dpkg -i aliyun_assist_latest.deb fi ## VPC 内部ネットワーク経由でマネージドインスタンスを登録します。注意:NetworkMode パラメーターを vpc に設定する必要があります。 ## コンソールの登録コード作成ページから、RegionId、ActivationCode、ActivationId パラメーターの値をコピーします。 sudo aliyun-service --register \ --NetworkMode "vpc" \ --RegionId "${regionId}" \ --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \ --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"
Windows サーバー
パブリックネットワーク経由での接続
リモートデスクトップ接続 などの方法を使用してサーバーにログインします。
詳細については、「接続方法」をご参照ください。
インストールスクリプトをサーバーにアップロードします。
ステップ 1 のインストールスクリプトを使用します。
説明リモートデスクトップ接続 を使用すると、スクリプトファイルをサーバーにコピーできます。ネットワーク環境にファイルのコピーを妨げる他の制限がある場合は、FTP などの他のソフトウェアを使用してスクリプトをアップロードできます。
インストールスクリプトを右クリックし、[PowerShell で実行] を選択して Cloud Assistant エージェント をインストールします。

プロキシサーバー経由での接続
このセクションでは、Windows Server 2016 Datacenter Edition を例として、Cloud Assistant Agent をインストールし、プロキシサーバー経由でマネージドインスタンスを登録する方法について説明します。
リモートデスクトップ接続 などの方法を使用してサーバーにログインします。
詳細については、「接続方法」をご参照ください。
ブラウザのプロキシサーバーを設定します。
を選択します。
[ネットワークとインターネット]をクリックします。
[ネットワークと共有センター] をクリックします。
左下隅で、[インターネット オプション] をクリックします。

接続 タブで、[LAN 設定] をクリックします。
[プロキシサーバー] セクションで、プロキシサーバーのアドレスとポートを指定し、OK をクリックします。
Cloud Assistant Agent インストールパッケージをダウンロードします。
スタートメニューから、**[Windows PowerShell]** > **[Windows PowerShell]** を選択します。
Windows PowerShell を右クリックし、[管理者として実行] を選択します。
[Windows PowerShell] ウィンドウで、次のコマンドを実行して Cloud Assistant Agent インストールパッケージをダウンロードします。
Invoke-WebRequest -Uri 'https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe' -OutFile 'C:\\aliyun_agent_latest_setup.exe'
ダウンロードが完了したら、Cloud Assistant エージェントをインストールします。
C:\ ドライブに移動します。
aliyun_agent_latest_setup.exe をダブルクリックし、インストールウィザードの指示に従って Cloud Assistant エージェントをインストールします。
Cloud Assistant のプロキシサーバーを設定します。
を選択します。
[システムとセキュリティ] をクリックします。
システム をクリックします。
左側のナビゲーションペインで、[システムの詳細設定] をクリックします。

高級 タブで、Environment Variable をクリックします。
システム変数 セクションで、新規作成 をクリックします。
変数名 と 変数値 を設定し、決定 をクリックします。
[変数名]:ALIYUN_ASSIST_PROXY と入力します。
[変数値]:プロキシサーバーのアドレスを入力します。
[Windows PowerShell] で、次のコマンドを実行して Cloud Assistant サービスを再起動します。
次のコマンドを実行して、Cloud Assistant サービスを停止します。
net stop AliyunService次のコマンドを実行して、Cloud Assistant サービスを再起動します。
net start AliyunService
Windows PowerShell で、プロキシサーバー経由でマネージドインスタンスを登録します。
次のコマンドを実行して、Cloud Assistant インストールディレクトリに移動します。
cd C:\ProgramData\aliyun\assist\{version}重要{version}をインストールした Cloud Assistant のバージョン番号に置き換えてください。次のコマンドを実行して、サーバーをマネージドインスタンスとして登録します。
次のコマンドは例です。
RegionId、ActivationCode、ActivationIdの値を、ステップ 1 で生成されたスクリプトの値に置き換えてください。.\aliyun_assist_service.exe --register --RegionId="cn-hangzhou" --ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****" --ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"
Express Connect 経由での VPC 接続
このセクションでは、Windows Server 2016 Datacenter Edition を例として、Express Connect 回線経由でCloud Assistant エージェントをインストールし、マネージドインスタンスを登録する方法について説明します。
リモートデスクトップ接続 などの方法を使用してサーバーにログインします。
詳細については、「接続方法」をご参照ください。
スタートメニューから、**[Windows PowerShell]** > **[Windows PowerShell]** を選択します。
Windows PowerShell を右クリックし、[管理者として実行] を選択します。
[Windows PowerShell] ウィンドウで、次のコマンドを実行します。
次のコマンドは例です。
RegionId、ActivationCode、ActivationIdの値を、ステップ 1 で生成されたスクリプトの値に置き換えてください。$RegionId = "cn-hangzhou" $Bucket = "aliyun-client-assist-${RegionId}.oss-${RegionId}-internal.aliyuncs.com" Invoke-WebRequest -Uri "https://${Bucket}/windows/aliyun_agent_latest_setup.exe" ` -OutFile 'C:\\aliyun_agent_latest_setup.exe' &"C:\\aliyun_agent_latest_setup.exe" '/S' '--register' ` '--NetworkMode="vpc"' '--RegionId="cn-hangzhou"' ` '--ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****"' ` '--ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"' type C:\ProgramData\aliyun\assist\hybrid\instance-id Start-Sleep -s 30 net stop AliyunService net start AliyunService
ステップ 3:接続の確認
Cloud Assistant エージェントをインストールしてインスタンスを登録した後、ECS コンソールに戻り、接続ステータスを確認します。接続ステータスが正常の場合、サードパーティサーバーが正常に管理されたことになります。
ECS コンソール - ECS クラウドアシスタントに移動します。
上部メニューで、対象リソースのリージョンとリソースグループを選択します。
インスタンスの管理 タブに、管理対象インスタンスのリストが表示されます。
デフォルトでは、Alibaba Cloud アカウント配下のすべてのリソースが表示されます。 特定のリソースグループ内のマネージドインスタンスと登録コードを表示するには、左上隅にあるアカウントのすべてのリソース ドロップダウンリストからリソースグループを選択します。

上図に示すように、接続ステータス が 通常 であることは、サーバーが正常に管理されていることを示します。
サードパーティサーバーがマネージドインスタンスとして登録されると、Cloud Assistant を使用してログインせずにサーバーを管理できます。Cloud Assistant の使用方法の詳細については、「コマンドの作成と実行」および「ECS インスタンスへのファイルの送信」をご参照ください。
(オプション) サードパーティサーバーの登録解除
サードパーティサーバーを Alibaba Cloud で管理する必要がなくなった場合は、マネージドインスタンスの登録を解除してから、Cloud Assistant サービスを停止してアンインストールできます。
Linux サーバー
SSH などの方法を使用してサーバーにログインします。
詳細については、「接続方法」をご参照ください。
次のコマンドを実行して、マネージドインスタンスの登録を解除します。
sudo aliyun-service --deregisterCloud Assistant デーモンを停止してアンインストールします。
次のコマンドを実行して、Cloud Assistant デーモンを停止します。
sudo /usr/local/share/assist-daemon/assist_daemon --stop説明Cloud Assistant デーモンのデフォルトパスは /usr/local/share/assist-daemon/assist_daemon です。
次のコマンドを実行して、Cloud Assistant デーモンをアンインストールします。
sudo /usr/local/share/assist-daemon/assist_daemon --delete
次のコマンドを実行して Cloud Assistant Agent を停止します。
説明Linux カーネルのバージョンによって、使用される init サービスが異なります。Ubuntu 18.04 など新しいバージョンのカーネルを使用する Linux ディストリビューションは、通常 systemd init サービスを使用します。このセクションでは、systemd init サービスを例として使用します。その他の init サービスの詳細については、「Cloud Assistant エージェントの停止とアンインストール」をご参照ください。
sudo systemctl stop aliyun.service次のコマンドを実行して Cloud Assistant Agent をアンインストールします。
RPM ベースのパッケージ管理システムの場合:
sudo rpm -qa | grep aliyun_assist | xargs sudo rpm -eDEB ベースのパッケージ管理システムの場合:
sudo dpkg -r aliyun-assist
Cloud Assistant デーモンと Cloud Assistant エージェントのディレクトリを削除します。
次のコマンドを実行して、Cloud Assistant デーモンのディレクトリを削除します。
sudo rm -rf /usr/local/share/assist-daemon次のコマンドを実行して、Cloud Assistant Agent のディレクトリを削除します。
sudo rm -rf /usr/local/share/aliyun-assist
Windows サーバー
このセクションでは、Windows Server 2019 を例として使用します。他の Windows バージョンでは、Windows PowerShell とサービスのパスが異なる場合があります。
リモートデスクトップ接続 などの方法を使用してサーバーにログインします。
詳細については、「接続方法」をご参照ください。
Windows PowerShell を実行します。

スタートメニューをクリックします。
**[Windows PowerShell]** > **[Windows PowerShell]** を選択します。
Windows PowerShell を右クリックし、[管理者として実行] を選択します。
Windows PowerShell ウィンドウで、次のコマンドを実行してマネージドインスタンスの登録を解除します。
aliyun-service --deregisterサービスウィンドウを開きます。

スタートメニューをクリックします。
を選択します。
Aliyun Assist Service を見つけ、[サービスの停止] をクリックします。

よくある質問
マネージドインスタンスが切断されるのはなぜですか?
Cloud Assistant のステータスが異常または切断されている場合、問題は Cloud Assistant エージェントの実行ステータスに関連している可能性があります。マネージドサーバーにログインし、systemctl status aliyun.service コマンドを実行してエージェントの実行ステータスを確認してください。
runningは、Cloud Assistant が正常に実行されていることを示します。ステータスが
runningでない場合は、systemctl restart aliyun.serviceコマンドを実行して Cloud Assistant を再起動してください。Cloud Assistant の問題の詳細については、「Cloud Assistant のステータスの確認と例外のトラブルシューティング」をご参照ください。その他の問題については、
/usr/local/share/aliyun-assist/<version>/logからログを収集し、Alibaba Cloud テクニカルサポートにお問い合わせください。
既存の登録コードを確認するにはどうすればよいですか?
インスタンスの登録 をクリックします。 表示される インスタンスの登録 ペインで、既存の登録コードの一覧を表示したり、新しいコードを作成したりできます。
有効期間が制限を超えるのはなぜですか?
登録コードを作成するときに、メッセージ Activation TTL exceeds limit. が表示された場合、対応するエラーコードは
ActivationTTL.ExceedLimitです。これは、有効期間パラメーターの値が無効であることを示しています。有効期間パラメーターの値を小さくして、もう一度お試しください。登録コードのデフォルトの 有効期間 は 4 時間です。サードパーティサーバーの登録が失敗し、エラーコード
activation_has_expiredが報告される場合、登録コードの有効期限が切れています。新しい登録コードを作成して、サーバーを再度登録してください。
関連ドキュメント
マネージドインスタンスの登録に成功すると、Cloud Assistant、CloudOps Orchestration Service、Alibaba Cloud DevOps など、Alibaba Cloud が提供するさまざまなオンラインサービスを利用できるようになります。
次の Cloud Assistant API を呼び出して、アクティベーションコードとマネージドインスタンスを管理することもできます。