bitnamicharts/metrics-server

Bitnami Metrics Server 镜像文档

镜像概述和主要用途

Metrics Server 是 Kubernetes 集群中的资源使用数据聚合工具，主要用于收集容器 CPU、内存等资源使用情况，并通过 Metrics API 提供访问接口。Bitnami 提供的此 Helm Chart 用于在 Kubernetes 集群中快速部署和配置 Metrics Server。

https://github.com/kubernetes-incubator/metrics-server

商标说明：本软件列表由 Bitnami 打包。所提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

核心功能和特性

• 资源数据聚合：收集 Kubernetes 集群中节点和 Pod 的 CPU、内存使用数据
• Metrics API 支持：实现 Kubernetes Metrics API（metrics.k8s.io/v1beta1），支持 kubectl top 等工具访问
• 轻量级设计：低资源消耗，适合大规模集群部署
• RBAC 集成：支持 Kubernetes 基于角色的访问控制（RBAC）
• 灵活配置：支持自定义证书、Pod 亲和性/反亲和性、资源请求与限制等
• 高可用性：可配置副本数和 PodDisruptionBudget，确保服务稳定性

使用场景和适用范围

适用场景

• Kubernetes 集群资源监控与分析
• 为 Horizontal Pod Autoscaler（HPA）提供指标数据
• 开发/测试环境中快速部署资源监控组件
• 生产环境中作为基础监控数据采集工具（需配合安全加固配置）

适用范围

• 开发环境：可直接使用社区版镜像（docker.io/bitnami）进行功能验证
• 生产环境：建议使用 Bitnami Secure Images，包含安全加固、CVE 透明度和长期支持

先决条件

• Kubernetes 集群版本 ≥ 1.23
• Helm 版本 ≥ 3.8.0
• 集群网络支持 Pod 间通信（确保 Metrics Server 可访问节点和 kubelet）

详细使用方法和配置说明

快速部署（TL;DR）

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/metrics-server

安装步骤

1. 添加 Helm 仓库（如未添加）

console
helm repo add bitnami oci://registry-1.docker.io/bitnamicharts
helm repo update

2. 部署 Metrics Server

console
helm install my-release bitnami/metrics-server

说明：如需指定镜像版本或自定义配置，可通过 --set 参数覆盖默认值，例如：

console
helm install my-release bitnami/metrics-server \
  --set replicas=2 \
  --set rbac.create=true \
  --set apiService.create=true

核心配置说明

启用 RBAC 安全控制

默认已启用 RBAC（rbac.create=true），会自动创建必要的 ServiceAccount、ClusterRole 和 ClusterRoleBinding。如需自定义权限，可通过 serviceAccount.name 指定已存在的 ServiceAccount。

配置证书

• 自签名证书（默认）：启用 apiService.insecureSkipTLSVerify=true（开发环境推荐）
• 自定义证书：设置 apiService.insecureSkipTLSVerify=false，并通过 apiService.caBundle 提供 base64 编码的 CA 证书链

资源请求与限制

建议根据集群规模配置资源限制，避免资源竞争：

yaml
resources:
  requests:
    cpu: 100m
    memory: 200Mi
  limits:
    cpu: 500m
    memory: 512Mi

Pod 亲和性/反亲和性

通过预设或自定义亲和性规则优化 Pod 调度：

yaml
# 使用预设反亲和性（避免同节点部署多个副本）
podAntiAffinityPreset: hard

# 或自定义亲和性规则
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
            - key: node-role.kubernetes.io/control-plane
              operator: Exists

参数说明

全局参数

通用参数

Metrics Server 参数

⚠️ 重要通知：Bitnami 镜像目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将升级其公共镜像目录，推出Bitnami Secure Images 计划。过渡期间的主要变更包括：

社区用户影响

• 首次开放安全优化版镜像的社区访问权限
• 免费 tier 将逐步淘汰非加固的 Debian 基础镜像，仅保留少量加固镜像（仅 latest 标签，适用于开发环境）

镜像迁移

• 2025 年 8 月 28 日起，所有现有镜像（含历史版本标签，如 2.50.0、10.6）将从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库，且不再接收更新

生产环境建议

• 生产工作负载需采用 Bitnami Secure Images，包含安全加固容器、更小***面、CVE 透明度（VEX/KEV）、SBOM 以及企业支持

更多详情请参见 https://github.com/bitnami/containers/issues/83267%E3%80%82

完整文档

本文档因长度限制已精简，完整内容请参见 https://github.com/bitnami/charts/blob/main/bitnami/metrics-server/README.md%E3%80%82