Elastic Compute Service:クラウドアシスタントプラグインの使用

プラグインのクエリ

• すべてのオンライン Cloud Assistant プラグインのクエリ

  sudo acs-plugin-manager --list

• ローカルにインストールされている Cloud Assistant プラグインのクエリ

  sudo acs-plugin-manager --list --local

出力例

Name                         Version  Publisher  OsType  Arch  PluginType  
config_ecs_instance_connect  1.20     aliyun     LINUX   X64   Once
ecs_tools_test               1.4      aliyun     LINUX   ALL   Persist     

次の表に、出力フィールドの説明を示します。

プラグインの実行

• Cloud Assistant プラグインの実行

  デフォルトでは、このコマンドはまずローカルにインストールされたプラグインを実行しようとします。プラグインがローカルにインストールされていない場合、またはオンラインで新しいバージョンが利用可能な場合、コマンドは自動的に最新バージョンをダウンロードして実行します。

  sudo acs-plugin-manager --exec --plugin <プラグイン名>

• ローカルにインストールされた Cloud Assistant プラグインの実行

  --local パラメーターを使用すると、コマンドはオンラインバージョンをチェックしたり、プラグインをダウンロードしたりしません。ローカルインストールからのみプラグインを検索して実行します。プラグインがローカルにインストールされていない場合、コマンドはエラーを返します。

  sudo acs-plugin-manager --exec --local --plugin <プラグイン名>

コマンド例

• プラグインパッケージファイルからプラグインを実行する

  acs-plugin-manager --exec --file /root/ecs_tools_test.zip --params "--start,--on"
  # --file はプラグインパッケージファイルのパスを指定します。
  # --params はプラグインの実行時パラメーターを指定します。デフォルトでは、複数のパラメーターはカンマ (,) で区切られます。
  # --separator を使用して、別の区切り文字を指定できます (例：--separator '#')。

• プラグインをダウンロードして実行する

  acs-plugin-manager --exec --plugin ecs_tools_test --pluginVersion 1.2 --params --start
  # --plugin はプラグイン名を指定します (必須)。
  # --pluginVersion はプラグインのバージョン番号を指定します。このパラメーターを指定しない場合、最新バージョンが自動的にプルされます。
  # このコマンドは、ローカルとオンラインの両方で ecs_tools_test プラグインをクエリします。pluginVersion が空でない場合、プラグインのバージョンも検索条件として使用されます。
  # プラグインがローカルに存在する場合、ローカルプラグインが実行されます。それ以外の場合、プラグインパッケージはオンラインソースからプルされます。

• ローカルプラグインに実行を制限する

  acs-plugin-manager --exec --local --plugin ecs_tools_test  --params --start
  # --local は、ローカルにインストールされたプラグインからのみ ecs_tools_test プラグインを検索して実行するようにコマンドを制限します。プラグインがローカルで見つからない場合、オンラインソースからはプルされません。

プラグインのステータス確認

インストールされている常駐 (Persist) プラグインの実行ステータスをクエリできます。

sudo acs-plugin-manager --status

出力例

[
  {
    "name": "ecs_tools_test",
    "status": "PERSIST_RUNNING",
    "version": "1.2"
  },
  {
    "name": "ecs_tools_test_1",
    "status": "PERSIST_RUNNING",
    "version": "1.2"
  }
]

status フィールドは、プラグインの現在のステータスを示します。PERSIST_RUNNING は、プラグインが実行中であることを示します。

プラグインのテスト

--verify コマンドは、プラグインファイルを Linux の /usr/local/share/aliyun-assist/plugin/verify_plugin_test ディレクトリ、または Windows の C:\ProgramData\aliyun\assist\plugin\verify_plugin_test ディレクトリに展開します。その後、プラグインの実行可能ファイルを実行します。これは一時的な実行です。プラグイン情報はローカルの installed_plugins ファイルには記録されず、プラグインリストやステータスのクエリではこのプラグインに関する情報は返されません。

コマンド例

acs-plugin-manager --verify --url https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/ecs_tools_test/linux/ecs_tools_test_1.2.zip --params --upgrade

--verify：プラグインをテストします。プラグインパッケージを verify_plugin_test ディレクトリに展開します。

--url：プラグインパッケージのアドレスを指定します。アドレスには http(s) または file プロトコルを使用できます。例：

• Linux：file:///root/assistpluginlinux.zip

• Windows：file:///C:/ProgramData/aliyun/assist/2.1.3.282/assistpluginwindows.zip

プラグインの削除

sudo acs-plugin-manager --remove --plugin <プラグイン名>

プラグインを削除する際、acs-plugin-manager の動作はプラグインのタイプによって異なります。

• 1 回限り (Once) のプラグイン：プラグインファイルディレクトリが削除されます。

• 常駐 (Persist) プラグイン：コマンドはまず、グレースフルアンインストールのためにプラグインの --stop および --uninstall 操作を呼び出そうとします。ファイルディレクトリは、アンインストールが成功した後にのみ削除されます。

コマンド例

acs-plugin-manager --remove --plugin ecs_tools_test
# --plugin は削除するプラグインの名前を指定します。
# 1 回限りのプラグインの場合：/usr/local/share/aliyun-assist/plugin/<plugin-name> ディレクトリが直接削除されます。
# 常駐プラグインの場合：プラグインの --stop および --uninstall インターフェイスが順番に呼び出されます。--uninstall インターフェイスが 0 の値を返した場合、プラグインディレクトリは削除されます。それ以外の場合、削除操作は停止されます。
# プラグインを削除すると、その中のすべてのバージョンのサブディレクトリを含む、プラグインのディレクトリ全体が削除されます。

ヘルプの取得

acs-plugin-manager でサポートされているコマンドとパラメーターの完全なリストを表示できます。

sudo acs-plugin-manager --help

Flags:
  --help,-h          --help、このヘルプページを表示します
  --version,-v       --version、バージョン番号を表示します
  --local,-L          
  --plugin,-P        名前でプラグインを指定します
  --pluginId         ID でプラグインを指定します
  --pluginVersion,-n プラグインのバージョン番号を指定します
  --params,-p        プラグインの実行時パラメーターを設定します。パラメーターの区切り文字を設定するには --separator を使用します。
  --paramsV2         区切り文字を使用せずにプラグインの実行時パラメーターを設定します。
  --url,-u           プラグインのアドレスを指定します
  --separator,-s     プラグインパラメーターの区切り文字を指定します。デフォルトはカンマです。
  --file,-F          プラグインファイルを指定します
  --verbose,-V       --verbose、より多くのログを表示します
  --list,-l          --list、すべてのプラグインをリスト表示します
                     --list --local、ローカルにインストールされたプラグインのみをリスト表示します
  --verify,-f        --verify --url <> --params <>、プラグインを検証します
  --status,-S        --status、すべてのプラグインのステータスを表示します
  --exec,-e          --exec --plugin <> --params <>、オンライン検索を優先してプラグインを実行します
                     --exec --local --plugin <> --params <>、ローカルストレージからのみプラグインを検索して実行します
                     --exec --file <> --params <>、プラグインパッケージファイルからプラグインを実行します
  --fetchTimeout     プラグインのフェッチに許容される最大時間 (秒)。デフォルト：20。値 0 は時間制限なしを意味します。
  --timeout          プラグインの実行に許容される最大時間 (秒)。デフォルトでは、プラグインパッケージで定義されたタイムアウト値が使用されます。値 0 は時間制限なしを意味します。
  --remove,-r        --remove --plugin <>、ローカルプラグインを削除し、そのディレクトリファイルを削除します

kdump の構成

sudo acs-plugin-manager --exec --plugin=multi-nic-util

sudo acs-plugin-manager --exec --plugin=ecs_tools_multiqueue

sudo acs-plugin-manager --exec --plugin=ecs_disable_intel_hyper-threading