文档首页/ 云搜索服务 CSS_企业搜索服务 KooSearch/ 用户指南/ 升级KooSearch服务
更新时间：2025-08-21 GMT+08:00
查看PDF
分享

升级KooSearch服务

KooSearch服务的升级功能升级的是集群的内核补丁。

场景描述

升级原理

升级过程采用的是one-by-one的方式。升级时，先下线一个节点，然后对该节点执行切换OS镜像的动作，再将已下线节点的网卡port挂载回来，以此保留节点IP地址，再进行初始化节点启动进程，待节点信息更新后，再依次将其余节点镜像进行替换。升级过程中存在节点下线再上线的动作，可能会中断服务，请在业务低峰期执行。

升级流程

  1. 进行升级前检查：升级前检查。

    升级前检查大部分支持系统检查，少部分需要人工检查。

  2. 创建升级任务，启动升级：创建升级任务。

约束限制

  • 最多同时支持20个集群升级，建议在业务低峰期进行升级操作。
  • 待升级的集群不能存在正在进行中的任务。
  • 升级任务一旦启动就无法中止，直到升级任务的“任务状态”显示“失败”或“成功”才结束。

升级前检查

为了保证升级成功，需要做升级前检查，升级前检查主要包括如下事项：

表1 升级前检查项

检查项

检查方式

描述

正常状态

集群状态

系统检查

升级任务启动后，系统会自动检查集群状态。“集群状态”为“可用”，表示集群可以正常提供服务。

“集群状态”为“可用”。

资源充足

系统检查

升级任务启动后，系统会自动检查资源。升级过程中会切换OS镜像，需要保证有资源可用。

资源可用且配额充足。

非标操作

人工检查

确认是否存在非标操作。非标操作指的是没有被记录下来的手动操作，这些操作在升级过程中无法自动传递，比如修改系统配置、回程路由等。

未记录到系统中的非标改动，在升级过程中将不会继承下来，升级后可能会影响您的业务，需要提前备份。

创建升级任务

  1. 进入KooSearch服务详情页面。
    1. 登录云搜索服务管理控制台。
    2. 在左侧导航栏选择“KooSearch>KooSearch文档问答”，进入KooSearch服务列表。
    3. 选择目标服务，单击服务名称，进入服务详情页。
  2. 选择“升级”页签。
  3. 在升级页面，配置升级参数。
    表2 升级参数说明

    参数

    描述

    目标镜像

    选择目标版本的镜像。选中镜像后，下方会显示镜像名称和目标版本的详细说明。

    实际支持的目标版本请以升级页面中“目标镜像”的可选值为准。如果无法选择目标镜像，有如下几个原因：

    • 当前集群已是最新版本集群。
    • 当前局点暂未录入新版本镜像。

    配置委托

    删除节点会释放网卡，需要VPC的操作权限。选择IAM委托，授权当前账号访问和使用VPC的权限。

    • 当首次配置委托时，可以单击“自动创建委托”新建委托“css_upgrade_agency”直接使用。
    • 当已有自动创建的委托时，可以单击“委托一键授权”，自动删除委托中VPC Administrator系统角色和VPC FullAccess系统策略的权限，并自动新增如下自定义策略授权委托到最小化权限。 
      "vpc:subnets:get",
"vpc:ports:*"
    • 执行“自动创建委托”和“委托一键授权”的用户需要如下最小权限。 
      "iam:agencies:listAgencies",
"iam:roles:listRoles",
"iam:agencies:getAgency",
"iam:agencies:createAgency",
"iam:permissions:listRolesForAgency",
"iam:permissions:grantRoleToAgency",
"iam:permissions:listRolesForAgencyOnProject",
"iam:permissions:revokeRoleFromAgency",
"iam:roles:createRole"
    • 使用委托的用户需要如下最小权限。 
      "iam:agencies:listAgencies",
"iam:agencies:getAgency",
"iam:permissions:listRolesForAgencyOnProject",
"iam:permissions:listRolesForAgency"
  4. 配置完成后，单击“确认提交”。
  5. 在“任务记录”列表，显示当前升级任务。当“任务状态”为“运行中”时，可以展开任务列表，单击“查看进度”查看详细的升级进度。

    当“任务状态”为“失败”时，可以重试任务或者直接终止任务。

    • 重试升级：在任务列表的操作列，单击“重试”，重新升级。
    • 终止升级：在任务列表的操作列，单击“终止”，结束升级。

      当升级任务终止后，请联系技术支持处理升级失败的任务。