Bitnami Metrics Server 镜像文档

镜像概述和主要用途

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

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

参数说明

全局参数

参数名	描述	默认值
`global.imageRegistry`	全局 Docker 镜像仓库地址	`""`
`global.imagePullSecrets`	全局镜像拉取密钥（数组形式）	`[]`
`global.security.allowInsecureImages`	是否允许跳过镜像校验	`false`
`global.compatibility.openshift.adaptSecurityContext`	适配 OpenShift 安全上下文（`auto`/`force`/`disabled`）	`auto`

通用参数

参数名	描述	默认值
`kubeVersion`	目标 Kubernetes 版本（未设置则使用 Helm 自动检测）	`""`
`nameOverride`	覆盖资源名称前缀	`""`
`fullnameOverride`	完全覆盖资源全名	`""`
`commonLabels`	所有资源的通用标签	`{}`
`commonAnnotations`	所有资源的通用注解	`{}`
`diagnosticMode.enabled`	启用诊断模式（禁用探针并覆盖命令）	`false`
`diagnosticMode.command`	诊断模式下的容器命令	`["sleep"]`
`diagnosticMode.args`	诊断模式下的命令参数	`["infinity"]`

Metrics Server 参数

参数名	描述	默认值
`image.registry`	Metrics Server 镜像仓库	`REGISTRY_NAME`
`image.repository`	Metrics Server 镜像名称	`REPOSITORY_NAME/metrics-server`
`image.digest`	镜像摘要（覆盖标签）	`""`
`image.pullPolicy`	镜像拉取策略	`IfNotPresent`
`replicas`	部署副本数	`1`
`rbac.create`	是否创建 RBAC 资源	`true`
`serviceAccount.create`	是否创建 ServiceAccount	`true`
`serviceAccount.name`	自定义 ServiceAccount 名称（为空则自动生成）	`""`
`apiService.create`	是否创建 Metrics API Service	`false`
`apiService.insecureSkipTLSVerify`	是否跳过 TLS 证书校验（自定义证书时设为 `false`）	`true`
`apiService.caBundle`	base64 编码的 CA 证书链	`""`
`containerPorts.https`	容器 HTTPS 端口	`8443`
`hostNetwork`	是否启用主机网络模式	`false`
`dnsPolicy`	DNS 策略	`ClusterFirst`
`extraArgs`	传递给 Metrics Server 的额外参数	`[]`
`podAntiAffinityPreset`	Pod 反亲和性预设（`soft`/`hard`，为空则禁用）	`soft`
`pdb.create`	是否创建 PodDisruptionBudget	`true`
`pdb.minAvailable`	最小可用副本数（与 `maxUnavailable` 二选一）	`""`
`pdb.maxUnavailable`	最大不可用副本数（与 `minAvailable` 二选一）	`""`
`affinity`	自定义 Pod 亲和性规则（覆盖预设）	`{}`