Cloud Assistant で利用できる機能は、エージェントのバージョンによって異なります。 現在のバージョンが必要な機能をサポートしていない場合は、Cloud Assistant Agent をアップグレードする必要があります。 このトピックでは、Cloud Assistant Agent をアップグレードする方法と、その自動アップグレードを無効にする方法について説明します。
制限事項
Cloud Assistant Agent をアップグレードする ECS インスタンスは [実行中] 状態である必要があります。
Cloud Assistant Agent がインストールされている必要があります。 詳細については、「Cloud Assistant Agent のインストール」をご参照ください。
自動アップグレード
デフォルトでは、Cloud Assistant Agent は 30 分ごとに aliyun_assist_update アップグレードプログラムを実行します。 このプログラムは、次のいずれかのパスにあります。
Windows インスタンス:C:\ProgramData\aliyun\assist\{VERSION}\aliyun_assist_update.exe
Linux インスタンス:
/usr/local/share/aliyun-assist/{VERSION}/aliyun_assist_update
{VERSION} は Cloud Assistant Agent のバージョン番号を表します。 バージョン番号の確認方法については、「Cloud Assistant Agent のインストール」をご参照ください。
Cloud Assistant Agent の自動アップグレードポリシーを設定して、アップグレードが許可されるタイムウィンドウを制御できます。 これにより、ビジネスのピーク時間帯におけるサービスの中断を回避できます。
ECS コンソール - クラウドアシスタントに移動します。
Cloud Assistant ページで、右上隅にある [設定] をクリックします。

[クラウドアシスタントの設定] ダイアログボックスで、[クラウドアシスタントエージェントのアップグレード設定] タブをクリックします。
[クラウドアシスタントエージェントのアップグレード設定] チェックボックスをオンにします。 [アップグレード許可期間] と [タイムゾーン] を設定します。 次に、[OK] をクリックします。
説明最大 5 つの期間を指定できます。 2 つの期間の間隔は、1 時間以上である必要があります。

自動アップグレードの無効化
特定のバージョンの Cloud Assistant Agent の自動アップグレードを無効にするには、設定ファイルを作成して自動アップグレードを無効にするか、自動アップグレードプログラムの名前を変更します。
すべてのバージョンの Cloud Assistant Agent の自動アップグレードを無効にするには、設定ファイルを作成して自動アップグレードを無効にする必要があります。
自動アップグレードプログラムの名前変更
aliyun_assist_update ファイルの名前を変更して、Cloud Assistant Agent の自動アップグレードを無効にできます。
VERSION は Cloud Assistant Agent のバージョン番号を表します。 バージョン番号の確認方法については、「Cloud Assistant Agent のインストール」をご参照ください。
Windows Server オペレーティングシステムの場合は、PowerShell で次のコマンドを実行して、
aliyun_assist_update自動アップグレードプログラムの名前をaliyun_assist_update.bkに変更します。Rename-Item -Path 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe'</span> -NewName 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe.bk'</span>Linux オペレーティングシステムの場合は、次のコマンドを実行して、
aliyun_assist_update自動アップグレードプログラムの名前をaliyun_assist_update.bkに変更します。mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk
自動アップグレードを再開するには、ファイル名を aliyun_assist_update に戻します。
Windows Server システム:
Rename-Item -Path 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe.bk'</span> -NewName 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\aliyun_assist_update.exe'</span>Linux システム:
mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update
設定ファイルを作成して自動アップグレードを無効化
Linux の Cloud Assistant Agent 2.2.1.140 以降、および Windows の Cloud Assistant Agent 2.1.1.140 以降では、Cloud Assistant Agent を使用して指定されたパスに設定ファイルを作成し、Cloud Assistant Agent のアップグレードを無効にできます。
ステップ 1:Cloud Assistant Agent の起動時のアップグレードチェックの無効化
Cloud Assistant Agent のインストールディレクトリの `config` ディレクトリに disable_bootstrap_update ファイルを作成して、現在のバージョンの Cloud Assistant Agent の起動時アップグレードチェックを無効にできます。また、クロスバージョンディレクトリの `config` ディレクトリにファイルを作成して、ローカルマシン上のすべてのバージョンの Cloud Assistant Agent の起動時アップグレードチェックを無効にすることもできます。 disable_bootstrap_update ファイルにコンテンツを追加する必要はありません。
Windows Server システム:PowerShell で次のコマンドを実行します。
# 次のコマンドを実行して、特定のバージョンの Cloud Assistant Agent の起動時アップグレードチェックを無効にします。 New-Item -Path 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\config\disable_bootstrap_update'</span> # 次のコマンドを実行して、すべてのバージョンの Cloud Assistant Agent の起動時アップグレードチェックを無効にします。 New-Item -Path 'C:\ProgramData\aliyun\assist\config\disable_bootstrap_update'Linux システム:次のコマンドを実行します。
# 次のコマンドを実行して、特定のバージョンの Cloud Assistant Agent の起動時アップグレードチェックを無効にします。 touch /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update # 次のコマンドを実行して、すべてのバージョンの Cloud Assistant Agent の起動時アップグレードチェックを無効にします。 touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update
VERSION は Cloud Assistant Agent のバージョン番号を表します。 バージョン番号の確認方法については、「Cloud Assistant Agent のインストール」をご参照ください。
ステップ 2:Cloud Assistant Agent の自動更新チェックの無効化
Cloud Assistant Agent のインストールディレクトリの `config` ディレクトリに disable_update ファイルを作成して、その特定のバージョンの Cloud Assistant Agent の自動アップグレードを無効にできます。 クロスバージョンディレクトリの `config` ディレクトリにこのファイルを作成して、ローカルマシン上のすべてのバージョンの Cloud Assistant Agent の自動アップグレードを無効にすることもできます。 disable_update ファイルは空でかまいません。
Windows Server システム:PowerShell で次のコマンドを実行します。
# 次のコマンドは、特定のバージョンの Cloud Assistant Agent の自動アップグレードを無効にします。 New-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update # 次のコマンドは、すべてのバージョンの Cloud Assistant Agent の自動アップグレードを無効にします。 New-Item -Path C:\ProgramData\aliyun\assist\config\disable_updateLinux システム:次のコマンドを実行します。
# 次のコマンドは、特定のバージョンの Cloud Assistant Agent の自動アップグレードを無効にします。 touch /usr/local/share/aliyun-assist/VERSION/config/disable_update # 次のコマンドは、すべてのバージョンの Cloud Assistant Agent の自動アップグレードを無効にします。 touch /usr/local/share/aliyun-assist/config/disable_update
VERSION は Cloud Assistant Agent のバージョン番号を表します。 バージョン番号の確認方法については、「Cloud Assistant Agent のインストール」をご参照ください。
自動アップグレードを再開するには、disable_update および disable_bootstrap_update 設定ファイルを削除します。
Windows Server システム:PowerShell で次のコマンドを実行します。
Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_update Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_updateLinux システム:次のコマンドを実行します。
rm /usr/local/share/aliyun-assist/VERSION/config/disable_update rm /usr/local/share/aliyun-assist/config/disable_update rm /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update rm /usr/local/share/aliyun-assist/config/disable_bootstrap_update
手動アップグレード
Cloud Assistant がサポートする機能と必要な最小エージェントバージョンの詳細については、「サポートされている機能とバージョン」をご参照ください。
パブリックコマンドを使用したアップグレード
自動アップグレードが失敗した場合は、パブリックコマンドを実行してエージェントをアップグレードできます。
以下の手順では、コンソールを例として使用します。 OpenAPI を呼び出すか、コマンドラインインターフェイス (CLI) を使用して Cloud Assistant のパブリックコマンドを実行する方法については、「パブリックコマンドの表示と実行」をご参照ください。
ECS コンソール - クラウドアシスタントに移動します。
[Cloud Assistant] ページで、共通コマンド タブをクリックします。
次のいずれかのパブリックコマンドの最新バージョンを見つけて、実行 をクリックします。
Linux インスタンス:
ACS-ECS-UpdateAliyunAssist-linux.shWindows インスタンス:
ACS-ECS-UpdateAliyunAssist-windows.ps1
コマンドを実行 パネルでパラメーターを設定し、[実行] をクリックします。
実行プラン:コマンドを実行する時間を選択します。 詳細については、「実行計画の詳細」をご参照ください。
インスタンスの選択:Cloud Assistant クライアントをアップグレードするインスタンスを選択します。 インスタンスは実行中で、Cloud Assistant クライアントがインストールされている必要があります。
パラメーターの詳細については、「パブリックコマンドの表示と実行」をご参照ください。
実行結果が次の図のようになっている場合、Cloud Assistant Agent は正常にアップグレードされています。

パブリックコマンドの実行に失敗した場合は、エラーメッセージを表示し、診断情報に基づいて問題を修正してください。 詳細については、「実行失敗時の一般的なエラーとトラブルシューティング」をご参照ください。
インストールパッケージの手動ダウンロードによるアップグレード
最新のパッケージを手動でダウンロードしてインストールし、エージェントをアップグレードすることもできます。 インストール方法の詳細については、「Cloud Assistant Agent のインストール」をご参照ください。
例:x86 アーキテクチャを使用する Linux インスタンスの場合、次のコマンドを実行して、最新の Cloud Assistant インストールパッケージをダウンロードしてインストールします。 この例では、RPM パッケージを使用します。
wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && sudo rpm -ivh --force aliyun_assist_latest.rpm特定のカーネルバージョンでアップグレード可能な Cloud Assistant Agent の最高バージョン
インスタンスのカーネルバージョン番号 | アップグレード可能な Cloud Assistant Agent の最高バージョン |
2.6.32 より前の Linux カーネルバージョン |
|
FreeBSD 11 以前 (カーネルバージョン 12.x より前) | 2.3.3.529 |