容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务容器服务 VKE用户指南弹性伸缩工作负载弹性伸缩指标伸缩（HPA）基于自建 Prometheus 实现弹性伸缩
复制全文
下载 pdf基于自建 Prometheus 实现弹性伸缩
文档反馈
问问助手当用户使用自建 Prometheus 监控集群时，可以在集群中部署开源 Prometheus Adapter，用于对接自建 Prometheus，实现基于自定义指标的容器水平伸缩（HPA）。本文介绍如何在集群中部署开源 Prometheus Adapter，并实现 HPA。
差异性说明
Prometheus adapter 组件与开源 Prometheus adapter
对比项 | Prometheus adapter 组件 | 开源 Prometheus adapter |
对比项 | Prometheus adapter 组件 | 开源 Prometheus adapter |
稳定性与支持 | 容器服务提供稳定性保障与技术支持。 | 由用户运维 ，从社区获取支持。 |
适配性 | 可自动适配托管 Prometheus 服务。 | 需用户自行搭建并适配自建 Prometheus 服务。 |
易用性 | 易用性强。 | 与社区特性一致。 |
托管 Prometheus 与自建 Prometheus
对比项 | 托管 Prometheus | 自建 Prometheus |
对比项 | 托管 Prometheus | 自建 Prometheus |
适配性 | 与容器服务集群深度适配。 | 由用户运维 ，与社区一致。 |
服务范围 | 提供从采集到观测的完整托管方案。 | - |
访问方式 | 支持标准 Prometheus 访问方式。 | - |
前提条件
- 已创建集群，且集群运行状态正常。详情请参见 创建集群。
- 已完成自建 Prometheus 服务搭建，且保证 VKE 集群能够正常访问该服务，采集指标数据。
- 完成本地环境（Linux/Mac）的配置，包括：
- 安装并完成配置 Helm 工具，确保 Helm 能正常连接到指定的 Helm 仓库。
- 已安装 kubectl 工具到本地。具体操作说明，请参见 安装和设置 kubectl。
- 已通过 kubectl 连接目标集群。具体操作说明，请参见 连接集群。
使用限制
- 在修改 Prometheus URL 和配置鉴权时 ，若配置错误可能导致 Prometheus Adapter 无法正常获取指标数据 ，进而影响 HPA 的弹性伸缩功能。
- 拉取镜像时，若指定的镜像架构与 Kubernetes 集群节点架构不一致 ，可能导致镜像无法在集群中正常运行。
- 配置自定义指标时，若指标配置错误，HPA 将无法按照预期的自定义指标进行弹性伸缩，可能造成资源浪费或业务性能下降。
操作步骤
步骤一：拉取 Chart
- 在本地主机中，执行以下命令，拉取 Prometheus-adapter Chart 到本地。
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update
helm pull prometheus-community/prometheus-adapter
- 解压拉取到的 Chart 文件，并进入解压后的文件夹（本文以文件名prometheus-adapter-4.11.0.tgz为例）。
tar -zxvf prometheus-adapter-4.11.0.tgz && cd prometheus-adapter
步骤二：修改配置
- 在本地环境中打开values.yaml文件，将其中的 Prometheus URL 修改为自建 Prometheus 的 Query 地址。若不需要端口号，可直接删除。
-
- 若自建 Prometheus 配置了 Basic Auth 鉴权，则需要在values.yaml中添加extraArguments字段，进行 Prometheus Adapter 鉴权。鉴权 Token 需通过在线或离线工具，依据 Prometheus Basic Auth 的账号和密码生成，并添加到相应配置项中。
-
步骤三：构建镜像
- 在本地拉取与 Kubernetes 集群节点架构一致的镜像（本文以linux/amd64架构为例）。
docker pull --platform linux/amd64 registry.k8s.io/prometheus-adapter/prometheus-adapter:v0.12.0
- 为拉取的镜像打标签，并指定目标镜像仓库地址、镜像名称和版本号。本文以doc-cn-beijing.cr.volces.com/vke/prometheus-adapter-demo:v1.0为例。
docker tag registry.k8s.io/prometheus-adapter/prometheus-adapter:v0.12.0 doc-cn-beijing.cr.volces.com/vke/prometheus-adapter-demo:v1.0
- 将镜像推送到目标镜像仓库。如果您使用火山引擎镜像仓库产品，更多操作详情，请参见 推送和拉取镜像。
docker push doc-cn-beijing.cr.volces.com/vke/prometheus-adapter-demo:v1.0
- 修改values.yaml文件中的镜像路径，指向推送后的镜像地址。
-
步骤四：配置自定义指标
- 打开values.yaml中关于自定义指标的配置部分，将default设置为false，表示不启用默认配置。
-
- 配置custom自定义规格字段，以网络指标container_network_receive_bytes_total和container_network_transmit_bytes_total为例，配置示例如下。
rules:
default: false
custom:
- seriesQuery: 'container_network_receive_bytes_total'
resources:
overrides:
namespace: {resource: "namespace"}
pod: {resource: "pod"}
name: {as: 'k8s_pod_network_receive_throughput'}
metricsQuery: 'sum(rate(<<.Series>>{<<.LabelMatchers>>,pod!=""}[1m])) by (<<.GroupBy>>) / 125000.0'
- seriesQuery: 'container_network_transmit_bytes_total'
resources:
overrides:
namespace: {resource: "namespace"}
pod: {resource: "pod"}
name: {as: 'k8s_pod_network_transmit_throughput'}
metricsQuery: 'sum(rate(<<.Series>>{<<.LabelMatchers>>,pod!=""}[1m])) by (<<.GroupBy>>) / 125000.0'
步骤五：安装 Chart
在prometheus-adapter文件夹下，执行以下命令，安装 Chart。其中prom-adapter可根据需求换成其他名称。
helm install prom-adapter .
查看配置
Pormetheus-adapter 安装完成后，登录集群，确认相关工作负载、配置项均正常。
- 登录 容器服务控制台。
- 单击左侧导航栏中的 集群。
- 在集群列表页面，单击需要配置的目标集群。
- 在集群管理页面的左侧导航栏中，选择 工作负载 > 无状态负载，在列表中确认工作负载运行正常。
-
- 在集群管理页面的左侧导航栏中，选择 配置管理 > 配置项，查看配置项。
-
- 在集群管理页面的左侧导航栏中，单击 工作负载 > 对象浏览器，在 分类 下拉菜单中选择 API Group，查看 API Group。
-
结果验证
- 在集群中创建工作负载。本示例以创建无状态负载（Deployment）为例。
apiVersion: apps/v1
kind: Deployment
metadata:
name: workload-demo
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: workload-demo
template:
metadata:
labels:
app: workload-demo
spec:
containers:
- name: nginx
image: nginx:1.14.2
ports:
- containerPort: 80
- 创建与工作负载关联的 HPA，指定按照网络指标进行弹性伸缩。
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
name: hpa-demo
namespace: default
spec:
maxReplicas: 10
metrics:
- pods:
metric:
name: k8s_pod_network_receive_throughput
target:
averageValue: "80"
type: AverageValue
type: Pods
- pods:
metric:
name: k8s_pod_network_transmit_throughput
target:
averageValue: "80"
type: AverageValue
type: Pods
minReplicas: 1
scaleTargetRef:
apiVersion: apps/v1
kind: Deployment
name: workload-demo
- 查看工作负载详情，选择 弹性伸缩 页签，即可查看当前工作负载的 HPA 配置。实现基于自建 Prometheus 的工作负载水平伸缩。
最近更新时间：2025.10.23 11:11:16
这个页面对您有帮助吗？
有用
有用
无用
无用