すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:Cloud Assistant Agent のアップグレードまたは自動アップグレードの無効化

最終更新日:Dec 17, 2025

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 の自動アップグレードポリシーを設定して、アップグレードが許可されるタイムウィンドウを制御できます。 これにより、ビジネスのピーク時間帯におけるサービスの中断を回避できます。

  1. ECS コンソール - クラウドアシスタントに移動します。

  2. Cloud Assistant ページで、右上隅にある [設定] をクリックします。

    image

  3. [クラウドアシスタントの設定] ダイアログボックスで、[クラウドアシスタントエージェントのアップグレード設定] タブをクリックします。

  4. [クラウドアシスタントエージェントのアップグレード設定] チェックボックスをオンにします。 [アップグレード許可期間][タイムゾーン] を設定します。 次に、[OK] をクリックします。

    説明

    最大 5 つの期間を指定できます。 2 つの期間の間隔は、1 時間以上である必要があります。

    image

自動アップグレードの無効化

  • 特定のバージョンの Cloud Assistant Agent の自動アップグレードを無効にするには、設定ファイルを作成して自動アップグレードを無効にするか、自動アップグレードプログラムの名前を変更します。

  • すべてのバージョンの Cloud Assistant Agent の自動アップグレードを無効にするには、設定ファイルを作成して自動アップグレードを無効にする必要があります。

自動アップグレードプログラムの名前変更

aliyun_assist_update ファイルの名前を変更して、Cloud Assistant Agent の自動アップグレードを無効にできます。

説明

VERSIONCloud 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
説明

VERSIONCloud 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_update
  • Linux システム:次のコマンドを実行します。

    # 次のコマンドは、特定のバージョンの 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
説明

VERSIONCloud 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_update
  • Linux システム:次のコマンドを実行します。

    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 のパブリックコマンドを実行する方法については、「パブリックコマンドの表示と実行」をご参照ください。

  1. ECS コンソール - クラウドアシスタントに移動します。

  2. [Cloud Assistant] ページで、共通コマンド タブをクリックします。

  3. 次のいずれかのパブリックコマンドの最新バージョンを見つけて、実行 をクリックします。

    • Linux インスタンス:ACS-ECS-UpdateAliyunAssist-linux.sh

    • Windows インスタンス:ACS-ECS-UpdateAliyunAssist-windows.ps1

      image.png

  4. コマンドを実行 パネルでパラメーターを設定し、[実行] をクリックします。

    • 実行プラン:コマンドを実行する時間を選択します。 詳細については、「実行計画の詳細」をご参照ください。

    • インスタンスの選択:Cloud Assistant クライアントをアップグレードするインスタンスを選択します。 インスタンスは実行中で、Cloud Assistant クライアントがインストールされている必要があります。

      パラメーターの詳細については、「パブリックコマンドの表示と実行」をご参照ください。

    実行結果が次の図のようになっている場合、Cloud Assistant Agent は正常にアップグレードされています。image.png

説明

パブリックコマンドの実行に失敗した場合は、エラーメッセージを表示し、診断情報に基づいて問題を修正してください。 詳細については、「実行失敗時の一般的なエラーとトラブルシューティング」をご参照ください。

インストールパッケージの手動ダウンロードによるアップグレード

最新のパッケージを手動でダウンロードしてインストールし、エージェントをアップグレードすることもできます。 インストール方法の詳細については、「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 カーネルバージョン

  • x86/x64 アーキテクチャ:2.2.3.398

  • ARM アーキテクチャ:2.4.3.398

FreeBSD 11 以前 (カーネルバージョン 12.x より前)

2.3.3.529