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

Elastic Compute Service:クラウドアシスタントエージェントのアップグレードまたは自動アップグレードの無効化

最終更新日:Jan 23, 2026

Cloud Assistant で利用可能な機能は、エージェントのバージョンによって異なります。現在のバージョンに必要な機能がない場合は、クラウドアシスタントエージェントをアップグレードできます。このトピックでは、クラウドアシスタントエージェントをアップグレードする方法と、その自動アップグレードを無効化する方法について説明します。

制限事項

  • クラウドアシスタントエージェントをアップグレードする ECS インスタンスは、実行中状態である必要があります。

  • クラウドアシスタントエージェントがインストールされていることを確認してください。詳細については、「クラウドアシスタントエージェントのインストール」をご参照ください。

自動アップグレード

重要

メキシコおよび中国 (中衛) リージョンでは、インスタンス上のクラウドアシスタントエージェントのバージョンが以下のバージョンより古い場合、自動アップグレードはサポートされません。InstallCloudAssistant API 操作を呼び出すか、手動でクラウドアシスタントエージェントをインストールして、新しい機能を使用する必要があります。

  • Linux: 2.2.3.515

  • Windows: 2.1.3.515

デフォルトでは、クラウドアシスタントエージェントは 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}クラウドアシスタントエージェントのバージョン番号です。バージョン番号の確認方法については、「クラウドアシスタントエージェントのインストール」をご参照ください。

クラウドアシスタントエージェントの自動アップグレードポリシーを設定して、アップグレードのタイムウィンドウを指定できます。これにより、ビジネスのピーク時間帯におけるサービスの中断を防ぐことができます。

  1. ECS コンソール - ECS Cloud Assistant に移動します。

  2. クラウドアシスタントページの右上の [設定] をクリックします。

    image

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

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

    説明

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

    image

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

  • 特定のバージョンのクラウドアシスタントエージェントの自動アップグレードを無効化するには、設定ファイルを作成して自動アップグレードを無効化するか、自動アップグレードプログラムの名前を変更します。

  • すべてのバージョンのクラウドアシスタントエージェントの自動アップグレードを無効化するには、設定ファイルを作成して自動アップグレードを無効化する必要があります。

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

aliyun_assist_update ファイルの名前を変更することで、クラウドアシスタントエージェントの自動アップグレードを無効化できます。

説明

VERSIONクラウドアシスタントエージェントのバージョン番号です。バージョン番号の確認方法については、「クラウドアシスタントエージェントのインストール」をご参照ください。

  • Windows Server: PowerShell で次のコマンドを実行して、aliyun_assist_update 自動アップグレードプログラムの名前を aliyun_assist_update.bk に変更します。

    Rename-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe.bk'
  • 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\VERSION\aliyun_assist_update.exe.bk' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe'
  • Linux:

    mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update

設定ファイルを作成して自動アップグレードを無効化

Linux の クラウドアシスタントエージェント 2.2.1.140 以降、および Windows の クラウドアシスタントエージェント 2.1.1.140 以降では、クラウドアシスタントエージェントを使用して指定されたパスに設定ファイルを作成することで、クラウドアシスタントエージェントのアップグレードを防ぐことができます:

ステップ 1: クラウドアシスタントエージェント の起動時のアップグレード確認を無効にする

現在のバージョンのクラウドアシスタントエージェントの起動時アップグレードチェックを無効にするには、クラウドアシスタントエージェントのインストールディレクトリにある config ディレクトリに disable_bootstrap_update ファイルを作成します。インスタンス上のすべてのバージョンのクラウドアシスタントエージェントのチェックを無効にするには、共有 config ディレクトリにファイルを作成します。disable_bootstrap_update ファイルに内容を記述する必要はありません。

  • Windows Server: PowerShell で次のコマンドを実行します。

    # たとえば、次のコマンドは、特定のバージョンのクラウドアシスタントエージェントが起動時にアップグレードをチェックするのを無効にします。
    New-Item -Path 'C:\ProgramData\aliyun\assist\<span class="var-span" contenteditable="true" data-var="VERSION">VERSION\config\disable_bootstrap_update'</span>
    # たとえば、次のコマンドは、すべてのバージョンのクラウドアシスタントエージェントが起動時にアップグレードをチェックするのを無効にします。
    New-Item -Path 'C:\ProgramData\aliyun\assist\config\disable_bootstrap_update'
  • Linux: 次のコマンドを実行します。

    # 次のコマンドは、特定のバージョンのクラウドアシスタントエージェントの起動時アップグレードチェックを無効にします。
    touch /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update
    # 次のコマンドは、すべてのバージョンのクラウドアシスタントエージェントの起動時アップグレードチェックを無効にします。
    touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update
説明

VERSIONクラウドアシスタントエージェントのバージョン番号です。バージョン番号の確認方法については、「クラウドアシスタントエージェントのインストール」をご参照ください。

ステップ 2: 自動更新チェックの無効化: クラウドアシスタントエージェント

特定のバージョンのクラウドアシスタントエージェントの自動アップグレードを無効にするには、クラウドアシスタントエージェントのインストールディレクトリにある config ディレクトリに disable_update ファイルを作成します。インスタンス上のすべてのバージョンのクラウドアシスタントエージェントの自動アップグレードを無効にするには、すべてのバージョンで共有される config ディレクトリにファイルを作成します。disable_update ファイルに内容を記述する必要はありません。

  • Windows Server: PowerShell で次のコマンドを実行します。

    # 次のコマンドは、特定のバージョンのクラウドアシスタントエージェントの自動アップグレードを無効にします。
    New-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update
    # 次のコマンドは、すべてのバージョンのクラウドアシスタントエージェントの自動アップグレードを無効にします。
    New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update
  • Linux: 次のコマンドを実行します。

    # 次のコマンドは、特定のバージョンのクラウドアシスタントエージェントの自動アップグレードを無効にします。
    touch /usr/local/share/aliyun-assist/VERSION/config/disable_update
    # 次のコマンドは、すべてのバージョンのクラウドアシスタントエージェントの自動アップグレードを無効にします。
    touch /usr/local/share/aliyun-assist/config/disable_update
説明

VERSIONクラウドアシスタントエージェントのバージョン番号です。バージョン番号の確認方法については、「クラウドアシスタントエージェントのインストール」をご参照ください。

自動アップグレードを再開するには、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 コンソール - ECS Cloud Assistant に移動します。

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

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

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

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

      image.png

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

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

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

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

    実行結果が次の図のようであれば、クラウドアシスタントエージェントは正常にアップグレードされています。image.png

説明

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

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

最新のインストールパッケージを手動でダウンロードしてエージェントをアップグレードすることもできます。インストール方法の詳細については、「クラウドアシスタントエージェントのインストール」をご参照ください。

例: x86 アーキテクチャを使用する Linux インスタンスで、次のコマンドを実行して、RPM パッケージマネージャー (RPM) パッケージを使用して最新のクラウドアシスタントエージェントインストールパッケージをダウンロードし、インストールします。

wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && sudo rpm -ivh --force aliyun_assist_latest.rpm

特定のカーネルバージョンでアップグレード可能なクラウドアシスタントエージェントの最高バージョン

インスタンスのカーネルバージョン

アップグレード可能なクラウドアシスタントエージェントの最高バージョン

2.6.32 より前の Linux カーネルバージョン

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

  • ARM アーキテクチャ: 2.4.3.398

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

2.3.3.529