K8s 集群中使用 Helm 部署 Prometheus 的自定义 values 配置实操教程

本教程将指导您在 Kubernetes 集群中通过 Helm 部署 Prometheus，并自定义 values 配置。Helm 是 Kubernetes 的包管理工具，Prometheus 是一个流行的监控系统。通过自定义 values 文件，您可以调整资源限制、存储配置、服务类型等参数。教程分为清晰步骤，确保操作可靠。

前提条件

在开始前，请确保满足以下条件：

• 已安装并配置好 Kubernetes 集群（版本 1.20+）。
• 已安装 Helm（版本 3.0+）。通过命令 helm version 验证。
• 拥有集群管理员权限（可通过 kubectl get nodes 确认）。
• 了解基本 YAML 语法（用于自定义配置）。

---

步骤 1：添加 Helm 仓库

首先，添加 Prometheus 的 Helm 仓库到本地：

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update  # 更新仓库索引

步骤 2：创建自定义 values 文件

创建一个 YAML 文件（例如 custom-values.yaml），用于覆盖默认配置。以下是常见自定义项示例：

# 自定义 values 文件示例：custom-values.yaml
# 调整资源限制（CPU 和内存）
alertmanager:
  resources:
    limits:
      cpu: "500m"
      memory: "512Mi"
    requests:
      cpu: "100m"
      memory: "256Mi"

# 修改存储配置（使用持久卷）
server:
  persistentVolume:
    enabled: true
    size: 20Gi  # 卷大小
    storageClass: "standard"  # 指定 StorageClass

# 暴露服务类型（NodePort 或 LoadBalancer）
service:
  type: NodePort  # 改为 LoadBalancer 如果需要外部访问
  nodePort: 30900  # 自定义端口

# 启用额外组件（如 Pushgateway）
pushgateway:
  enabled: true

关键参数说明：

• resources：控制 Pod 的资源使用，避免集群过载。
• persistentVolume：确保数据持久化，避免重启丢失。
• service.type：NodePort 适合内部访问，LoadBalancer 适合云环境外部访问。
• 您可以根据需求添加更多参数，参考官方 values.yaml。

步骤 3：部署 Prometheus

使用 Helm 安装 Prometheus，并应用自定义 values 文件：

helm install prometheus prometheus-community/prometheus \
  --namespace monitoring \  # 指定命名空间
  --create-namespace \      # 自动创建命名空间（如果不存在）
  -f custom-values.yaml     # 加载自定义配置

命令解析：

• helm install：安装 chart。
• prometheus：自定义发布名称（可改为其他）。
• --namespace monitoring：推荐在独立命名空间部署。
• -f custom-values.yaml：指定自定义文件路径（确保文件在当前目录）。

步骤 4：验证部署

检查部署状态：

kubectl get pods -n monitoring  # 查看 Pod 是否全部 Running
kubectl get svc -n monitoring   # 查看服务端口

如果使用 NodePort，访问 Prometheus Web UI：

• 获取节点 IP：kubectl get nodes -o wide
• 访问 http://<节点IP>:<NodePort>（例如 http://192.168.1.100:30900）。

步骤 5：更新配置（可选）

如果需修改 values，更新文件后运行：

helm upgrade prometheus prometheus-community/prometheus \
  --namespace monitoring \
  -f custom-values.yaml

---

注意事项

1. 资源规划：根据集群规模调整 resources，避免 OOM 错误。测试环境可降低限制。
2. 存储类：确保 storageClass 在集群中可用（通过 kubectl get storageclass 检查）。
3. 安全设置：生产环境建议启用 RBAC 和 TLS（在 values 文件中设置 rbac.create=true）。
4. 故障排查：
   • 如果 Pod 无法启动，检查日志：kubectl logs <pod-name> -n monitoring。
   • 确保 Helm chart 版本兼容（通过 helm search repo prometheus-community/prometheus 查看最新版）。
5. 卸载：如需删除部署，运行：

   helm uninstall prometheus -n monitoring
   kubectl delete pvc -n monitoring --all  # 清理持久卷
   

通过本教程，您已成功部署自定义配置的 Prometheus。自定义 values 文件让您灵活适应不同需求，提升监控效率。