【产品变更】容器服务 Prometheus-agent 组件升级
最近更新时间：2024.03.01 11:23:10
首次发布时间：2023.05.12 15:58:54
背景
容器服务 prometheus-agent 组件已升级至 v2.0.0 版本。新版本显著提高了生产可用性，允许组件根据资源使用情况，自动进行扩缩容，可支持超大规模集群，建议您升级至最新版本。本文档将为您介绍如何将组件从 v1.x.x 旧版本升级到 v2.0.0 新版本。
不升级的影响
如果您不将组件升级到新版本，会带来以下问题：
- 无法享受云服务基础指标免费。
- 组件缺乏生产可用性。
- 后续版本无法迭代升级。
前提条件
- 组件升级过程中无法采集指标。正常情况下，升级过程通常持续 2～5 分钟。
说明
若出现异常情况，如卸载异常等，请联系技术支持。
- VMP 工作区需要采用 Basic Auth 认证方式。
升级步骤
步骤一：（可选）切换 VMP 工作区认证模式
说明
使用 v2.0.0 版本的 prometheus-agent 组件需要使用工作区的 Basic Auth 认证功能，如果您的工作区已经使用了该认证方式，本步骤可跳过。
- 登录 VMP 服务控制台。
- 在顶部导航栏，选择目标地域。
- 单击左侧导航栏的 工作区，进入工作区列表页面。
- 在工作区列表中，选择需要更新的工作区，单击工作区名称，进入工作区详情页面。
- 开启工作区的 Basic Auth 认证方式。
- 配置工作区认证的用户名和密码。
- 单击 确定，完成配置。
步骤二：卸载旧版本
卸载旧版本 prometheus-agent 组件
如果您集群中为旧版本的 prometheus-agent 组件，则需要首先删除旧版本，操作步骤如下：
- 登录 容器服务控制台。
- 在左侧导航栏中选择 集群，在集群列表中选择目标集群。
- 在集群管理页面的左侧导航栏中，选择 组件管理。
- 将鼠标移动到 prometheus-agent 组件上，选择该组件右上角的
...> 卸载。
- 二次确认后，卸载旧版本组件。
卸载脚本安装的 VM Agent 组件
说明
使用脚本安装的 VM Agent 由于暂时不支持自动扩缩容，同时也无法享受 云服务基础指标免费 特性。如果您想要享受上述特性，建议也将集群中的采集器切换为 prometheus-agent。
如果您集群中为脚本安装的 VM Agent，则需要首先删除该组件，操作步骤如下：
- 在本地环境中下载脚本，详情请参见 获取脚本。
- 使用 kubectl 正确连接容器服务（VKE）集群。
- 执行以下命令，卸载 VM Agent 采集器。
./install.sh uninstall \ --agent vmagent \ --region cn-beijing
- 等待对应的工作负载不存在后，执行以下命令，卸载 vm-operator。
./install.sh uninstall-operator \ --region cn-beijing \ --namespace volcano-metrics
步骤三：升级新版本
旧版本组件卸载成功后，重新安装新版本的组件，操作步骤如下：
- 登录 容器服务控制台。
- 在左侧导航栏中选择 集群，在集群列表中选择目标集群。
- 在集群管理页面的左侧导航栏中，选择 组件管理。
- 将鼠标移动到 prometheus-agent 组件上，选择该组件右上角的
...> 安装，安装新版本组件。配置详情，请参见 安装 prometheus-agent 组件。