文档中心

云服务器

请输入

运维

通过运维编排能力实现云助手客户端（Agent）批量安装

本文介绍如何为绑定了相同标签的ECS实例，批量完成云助手客户端（Agent）的安装操作。

操作场景

针对大批量新购ECS实例的云助手客户端安装需求，您可以通过标签筛选目标实例，结合自定义模板与编排计划自动执行安装脚本，实现云助手客户端（Agent）批量安装，帮助您提升运维效率、降低人工成本。

前提条件

您已购买实例，且该批实例已绑定了同一个标签。

说明

批量安装云助手客户端的实例总数不可超过1000个，若实例总量超出上限，请分设多个标签，分批为实例完成云助手客户端的安装。

该批实例还未安装云助手客户端（Agent）。

使用限制

暂仅Linux实例支持通过运维编排批量安装云助手客户端，Windows实例需手动执行脚本安装，了解更多。

操作说明

请确保所选标签仅包含未安装实例，或在步骤一创建自定义模板时设置未安装实例过滤规则，否则，已安装云助手客户端的实例会被重复安装。

说明

若重复安装云助手客户端和重启实例对业务无影响，则无需关注。

安装云助手客户端需对实例进行重启，因此可能会对您的业务造成影响，请选择合适的时间执行运维。

操作步骤

步骤一：创建自定义模板

创建一个安装云助手客户端（Agent）的模板，预设批量安装云助手客户端的标准化运维编排流程。

登录云服务器控制台。

在左侧导航树选择“运维与监控 > 运维编排”。

在顶部导航栏中选择您业务所在的项目和地域，此实践的项目保持默认，地域选择“华北2（北京）”地域。

在运维编排页面，单击“自定义模板”页签。

单击“创建自定义模板”按钮，参考下表配置相关参数。

说明

此处仅介绍与本实践相关的参数，完整的参数说明及更多参数详情请参见创建自定义模板。

参数	说明	取值示例
名称	输入自定义模板的名称。说明当前账号下/项目下模板名称唯一，不可以与公共模板名称相同，也不可以与其他自定义模板名称相同。	批量安装云助手客户端模板
JSON模式	通过JSON格式定义“批量安装云助手客户端模板”文件（运维编排流程），示例如下： { "Parameters": { "targets": { "Type": "Map" }, "NeedReboot": { "Type": "Boolean" }, "ForceStop": { "Type": "Boolean" } }, "Tasks": [ { "Name": "getInstances", "Action": "VOS::SelectTargetInstances", "Parameters": { "Filters": "{{ .targets }}" }, "Outputs": { "instanceIds": { "Type": "List", "Value": "{{ [.Instances[].InstanceId] }}" } } }, { "Name": "InstallCloudAssistant", "Action": "VOS::ECS::InstallCloudAssistant", "Parameters": { "InstanceId": "{{ VOS::LoopItem }}", "NeedReboot": "{{ .NeedReboot }}", "ForceStop": "{{ .ForceStop }}" }, "Outputs": { "InstallResult": { "Type": "Boolean", "Value": "{{ .InstallResult }}" } }, "Loop": { "LoopItem": "{{ .\"getInstances.instanceIds\" }}", "Outputs": { "LoopInstanceStatus": { "SelectedOutputFiled": "InstallResult" } } } } ], "Outputs": { "InstanceStatus": { "Type": "List", "Value": "{{ .\"InstallCloudAssistant.LoopInstanceStatus\" }}" } } }	-
所属项目	选择该自定义模板使用的项目范围。说明此处展示的项目为您在步骤三选择的项目，如需切换“项目”，请参考步骤三从顶部导航修改。	保持默认

单击“确定”按钮，完成自定义模板创建。

至此，在自定义模板列表页，将展示一个名称为“批量安装云助手客户端模板”的自定义模板。

步骤二：创建编排计划

创建一个“立即执行”批量安装云助手的编排计划，实现云助手客户端（Agent）的批量安装。

登录云服务器控制台。

在左侧导航树选择“运维与监控 > 运维编排”。

在顶部导航栏中选择您业务所在的地域，此实践的项目保持默认，地域选择“华北2（北京）”地域。

说明

此处仅介绍与本实践相关的参数，完整的参数说明及更多参数详情请参见创建编排计划。

参数	说明	取值示例
基本信息
名称	填写编排计划任务名称。	批量安装云助手客户端运维计划
角色	为您的账号选择一个云服务器（ECS）资源读写授信的角色，默认为“CustomRoleForOOS”，该角色集成了运维编排默认支持的所有权限，可以避免您在使用时无权限的问题。	保持默认
执行方式
执行方式	编排计划任务的执行方式，此处需选择“立即执行”。立即执行：编排计划任务创建完成后立即开始执行一次。	立即执行
任务步骤
步骤创建方式	选择该编排计划的任务步骤执行方式，此实践需基于已有模板。	选择已有模板
选择模板
-	选择用于执行待执行任务的编排计划模板。单击选择模板下拉列表，选择您在步骤一中创建的“批量安装云助手客户端模板”。	批量安装云助手客户端模板
参数配置注意选择的模板不同，参数项也有所不同，具体参数请以控制台实际展示为准，此处仅为本实践涉及的相关参数。
targets (Map)	输入{key}的JSON格式数据，格式如下： { "Type": "Tags", "Tags": [ { "Key": "purpose", "Value": "Agent" } ] } 说明请将purpose和Agent替换为您实例对应的实际键（Key）和值（Value），且此处配置的标签Key与Value，必须与待安装云助手客户端的实例所绑定的标签Key与Value保持完全一致。 targets (Map)参数需根据您的模板自主配置。	-
NeedReboot (Boolean)	选择云助手客户端安装完成后，是否需要重启对应实例。开启：需要重启实例。不开启（默认）：不需要重启实例。说明若未开启实例自动重启功能，云助手客户端安装完成后，需手动重启对应实例，才可确保安装成功。	开启
ForceStop (Boolean)	选择执行运维操作时，是否需要强制终止相关的运行进程、依赖服务等。开启：将会强制停止相关进程。不开启（默认）：不会强制停止相关进程。	保持默认

单击“创建”按钮，完成操作。

至此，您可以在编排计划列表页，将展示一个名称为“批量安装云助手客户端运维计划”的编排计划。

步骤三：查看客户端（Agent）安装结果

通过云助手控制台或登录目标实例查看该批实例客户端安装结果，了解更多。

最近更新时间：2025.12.25 14:05:13

这个页面对您有帮助吗？

有用

无用