## 背景容器服务 prometheus\-agent 组件已升级至 v2.0.0 版本。新版本显著提高了生产可用性，允许组件根据资源使用情况，自动进行扩缩容，可支持超大规模集群，建议您升级至最新版本。本文档将为您介绍如何将组件从 v1.x.x 旧版本升级到 v2.0.0 新版本。 ## 不升级的影响如果您不将组件升级到新版本，会带来以下问题： * 无法享受云服务基础指标免费。 * 组件缺乏生产可用性。 * 后续版本无法迭代升级。 ## 前提条件 * 组件升级过程中无法采集指标。正常情况下，升级过程通常持续 2～5 分钟。 :::tip 若出现异常情况，如卸载异常等，请联系技术支持。 ::: * VMP 工作区需要采用 Basic Auth 认证方式。 ## 升级步骤 ### 步骤一：（可选）切换 VMP 工作区认证模式 :::tip 使用 v2.0.0 版本的 prometheus\-agent 组件需要使用工作区的 Basic Auth 认证功能，如果您的工作区已经使用了该认证方式，本步骤可跳过。 ::: 1. 登录 [VMP 服务控制台](https://console.volcengine.com/prometheus)。 2. 在顶部导航栏，选择目标地域。 3. 单击左侧导航栏的 **工作区**，进入工作区列表页面。 4. 在工作区列表中，选择需要更新的工作区，单击工作区名称，进入工作区详情页面。 5. 开启工作区的 **Basic Auth** 认证方式。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0a6d7d527dc7bcaf00d8c5e51e4bea60.png =795x) 6. 配置工作区认证的用户名和密码。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a48e3eb48b4ce045750075434d195c5b.png =670x) 7. 单击 **确定**，完成配置。 ### 步骤二：卸载旧版本 #### 卸载旧版本 prometheus\-agent 组件如果您集群中为旧版本的 prometheus\-agent 组件，则需要首先删除旧版本，操作步骤如下： 1. 登录 [容器服务控制台](https://console.volcengine.com/vke/overview)。 2. 在左侧导航栏中选择 **集群**，在集群列表中选择目标集群。 3. 在集群管理页面的左侧导航栏中，选择 **组件管理**。 4. 将鼠标移动到 prometheus\-agent 组件上，选择该组件右上角的 `...` \> **卸载**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c5ef207f49f9f347ed28287ab55115e8.png =773x) 5. 二次确认后，卸载旧版本组件。 #### 卸载脚本安装的 VM Agent 组件 :::tip 使用脚本安装的 VM Agent 由于暂时不支持自动扩缩容，同时也无法享受 **云服务基础指标免费** 特性。如果您想要享受上述特性，建议也将集群中的采集器切换为 prometheus\-agent。 ::: 如果您集群中为脚本安装的 VM Agent，则需要首先删除该组件，操作步骤如下： 1. 在本地环境中下载脚本，详情请参见 [获取脚本](https://www.volcengine.com/docs/6731/173989)。 2. 使用 kubectl 正确连接容器服务（VKE）集群。 3. 执行以下命令，卸载 VM Agent 采集器。 ```bash ./install.sh uninstall \ --agent vmagent \ --region cn-beijing ``` 4. 等待对应的工作负载不存在后，执行以下命令，卸载 vm\-operator。 ```bash ./install.sh uninstall-operator \ --region cn-beijing \ --namespace volcano-metrics ``` ### 步骤三：升级新版本旧版本组件卸载成功后，重新安装新版本的组件，操作步骤如下： 1. 登录 [容器服务控制台](https://console.volcengine.com/vke/overview)。 2. 在左侧导航栏中选择 **集群**，在集群列表中选择目标集群。 3. 在集群管理页面的左侧导航栏中，选择 **组件管理**。 4. 将鼠标移动到 prometheus\-agent 组件上，选择该组件右上角的 `...` \> **安装**，安装新版本组件。配置详情，请参见 [安装 prometheus-agent 组件](https://www.volcengine.com/docs/6460/101014#prometheus-agent-%E7%BB%84%E4%BB%B6)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_99b0c14694aa1bd2c5371de151809afc.png =966x)

托管 Prometheus