文档

使用云助手插件

更新时间:

云助手不仅能远程执行命令和上传文件,还提供了插件机制。通过云助手插件,您可以使用简单的命令就能够完成复杂的配置操作,提升运维管理效率。

使用限制

下述版本的云助手Agent中已默认支持云助手插件,如果您需要使用云助手插件,请确保您的云助手Agent版本符合或高于以下版本。具体操作,请参见升级或禁止升级云助手Agent

  • Windows:1.0.0.137

  • Linux:1.0.2.510

运行方式

云助手插件支持以下两种方式运行:

  • 使用具有sudo访问权限的用户远程连接ECS实例,并在ECS实例上直接执行命令(仅支持Linux)。

    如何远程连接ECS实例,请参见连接方式概述

  • 通过ECS控制台中的云助手控制台

查询插件

运行插件前,您需要先查询插件名称(Name)。

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

acs-plugin-manager --list

查询本地已安装的云助手插件

acs-plugin-manager --list --local

云助手插件参数说明如下:

参数名

说明

Name

插件名称。

Version

插件版本。

Publisher

插件提供者。

OsType

插件支持的操作系统。可能值:

  • LINUX:支持在Linux操作系统中执行。

  • WINDOWS:支持在Windows操作系统中执行。

Arch

插件支持的架构。可能值:

  • X64:支持在x64架构中执行。

  • X86:支持在x86架构中执行。

  • ARM:支持在ARM架构中执行。

  • ALL:支持在x64、x86、ARM架构中执行。

PluginType

插件类型。可能值:

  • Once:一次性插件,执行结束后即终止。

  • Persist:常驻插件,以常驻进程的方式运行。

运行插件

运行云助手插件

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

运行本地已安装的云助手插件

acs-plugin-manager --exec --local --plugin <plugin name>
说明
  • <plugin name>请替换成实际的插件名称,关于如何查询插件,请参见查询插件

  • 默认情况下运行插件会检查本地是否已经安装了此插件,如果本地未安装此插件或者已安装插件版本号小于线上版本,那么会从线上下载插件安装并运行。使用--local参数可以限制仅运行本地已安装的插件,如果插件未安装则会报错。

删除插件

执行如下命令,删除本地已安装的插件。

acs-plugin-manager --remove --plugin <plugin name>
说明

<plugin name>请替换成实际的插件名称,关于如何查询本地已安装的插件,请参见查询插件

常见云助手插件

云助手提供了多种插件,常见云助手插件使用示例如下:

配置kdump

kdump是Linux内核的一个功能,可在发生内核错误时创建核心转储。通过ecs_dump_config插件,开启、关闭或查询dump功能。

  • 开启dump

    acs-plugin-manager --exec --plugin=ecs_dump_config --params --enable
  • 关闭dump

    acs-plugin-manager --exec --plugin=ecs_dump_config --params --disable
  • 查询dump状态

    acs-plugin-manager --exec --plugin=ecs_dump_config --params --status

自动配置弹性网卡

一般情况下添加弹性网卡后,您需要手动设置所添加网卡的网络配置。通过multi-nic-util插件可以自动配置网卡的相关网络配置。

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

配置IPv6

通过ecs-utils-ipv6插件为已分配IPv6地址的ECS实例一键配置IPv6地址,或者为没有分配IPv6地址的ECS实例一键清理IPv6配置。ecs-utils-ipv6插件支持开启、关闭、自动配置(默认)、手动配置IPv6。ecs-utils-ipv6插件集成ecs-util-ipv6工具,更多信息,请参见步骤4:配置IPv6地址

  • 开启IPv6

    acs-plugin-manager --exec --plugin=ecs-utils-ipv6 --params --enable
  • 关闭IPv6

    acs-plugin-manager --exec --plugin=ecs-utils-ipv6 --params --disable
  • 自动配置IPv6

    acs-plugin-manager --exec --plugin=ecs-utils-ipv6
  • 手动配置IPv6

    acs-plugin-manager --exec --plugin=ecs-utils-ipv6 --params --static,<dev>,<ip6s>,<prefix_len>,<gw6>

    示例如下所示。

    acs-plugin-manager --exec --plugin=ecs-utils-ipv6 --params --static,eth0,fe80::216:3eff:****:****,64,2408:400a:108:8300:ffff:ffff:****:****

配置网卡多队列

多队列指实例规格支持的最大网卡队列数,单个ECS实例vCPU处理网络中断存在性能瓶颈时,通过网卡多队列功能可以将实例中的网络中断分散给不同的CPU处理。通过执行ethtool -l ehtname命令查看网卡当前队列数及支持的队列数。

通过ecs_tools_multiqueue插件可以将所有网卡的队列数设置为支持的最大值。

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

Intel超线程HT管理

在裸金属实例规格中,部分业务场景下需要关闭Intel的超线程,您可以通过ecs_disable_intel_hyper-threading插件来实现。

插件实现原理是在grub文件中增加内核参数nr_cpus=实例规格vCPU/2。参数nr_cpus会限定内核支持的最大CPU数,从而实现关闭HT的效果。

增加内核参数后,需重启实例才能生效。插件执行后,输出信息中会有提示您需重启实例的相关信息。

说明

此插件不支持在非裸金属实例规格上关闭HT。在非裸金属规格实例上执行此插件后,会提示该实例非裸金属实例规格并退出。

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

管理安全补丁

ECS实例上的安全漏洞需要及时处理并修复,否则将带来严重的安全隐患。通过补丁管理插件patch_manager,您可以扫描和安装ECS实例内部缺失的安全补丁。

  • 扫描安全补丁

    acs-plugin-manager --exec --plugin=patch_manager --params --operation,scan
  • 安装安全补丁,系统根据需要自动重启ECS实例

    acs-plugin-manager --exec --plugin=patch_manager --params --operation,install,--reboot,ifneed
  • 只安装安全补丁,不重启ECS实例

    acs-plugin-manager --exec --plugin=patch_manager --params --operation,install,--reboot,no
  • 本页导读 (1)