使用云助手插件

查询插件

• 查询线上所有的云助手插件

  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