Elastic Compute Service：使用雲助手外掛程式

查詢外掛程式

• 查詢線上所有的雲助手外掛程式

  sudo acs-plugin-manager --list

• 查詢本地已安裝的雲助手外掛程式

  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     

輸出欄位說明

運行外掛程式

• 運行雲助手外掛程式

  預設情況下，此命令會優先執行本地已安裝的外掛程式。如果本地未安裝，或線上存在更新的版本，則會自動從線上下載並執行。

  sudo acs-plugin-manager --exec --plugin <plugin name>

• 運行本地已安裝的雲助手外掛程式

  使用--local參數後，將不會檢查線上版本或下載外掛程式，僅在本地尋找並執行。如果本地未安裝，命令會報錯。

  sudo acs-plugin-manager --exec --local --plugin <plugin name>

運行樣本

• 從外掛程式包檔案執行外掛程式

  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 <plugin name>

刪除外掛程式時，acs-plugin-manager 的行為因外掛程式類型而異：

• 一次性外掛程式（Once）：直接刪除外掛程式檔案目錄。

• 常駐外掛程式（Persist）：會先嘗試調用外掛程式的 --stop 和 --uninstall 介面以實現優雅卸載，成功後才會刪除檔案目錄。

運行樣本

acs-plugin-manager --remove --plugin ecs_tools_test
# --plugin 指定要刪除的外掛程式名稱
# 對於一次性外掛程式：直接刪除目錄 /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