Kuberhealthy Helm Chart 新增自定义标签支持详解

Kuberhealthy作为Kubernetes集群健康检查工具，其Helm Chart近期迎来了一项重要功能更新——支持为Deployment和Pod添加自定义标签。这一改进极大提升了与其他监控系统的集成能力，特别是需要特定标签体系的服务。

功能背景

在Kubernetes生态中，资源标签(Labels)是元数据管理的关键机制。通过标签可以实现：

1. 资源分类和选择
2. 监控系统指标采集
3. 成本核算分组
4. 自动化运维策略匹配

原有Kuberhealthy Helm Chart仅设置了基础的应用名称标签(app: kuberhealthy)，这在需要与监控系统深度集成的场景下显得捉襟见肘。

技术实现

新版本通过values.yaml新增了两个配置项：

deployment:
  customLabels: {}
pod:
  customLabels: {}

用户可以在部署时通过values文件或--set参数添加任意自定义标签。例如对于Datadog的统一服务标签(Unified Service Tagging)需求，可以配置为：

deployment:
  customLabels:
    tags.datadoghq.com/env: "prod"
    tags.datadoghq.com/service: "kuberhealthy"
    tags.datadoghq.com/version: "v2.6.0"
pod:
  customLabels:
    tags.datadoghq.com/component: "health-check"

实现原理

在Helm模板中，新增的逻辑通过toYaml函数将自定义标签合并到标准标签中：

# deployment.yaml片段
metadata:
  labels:
    app: {{ template "kuberhealthy.name" . }}
    {{- toYaml .Values.deployment.customLabels | nindent 4 }}
spec:
  template:
    metadata:
      labels:
        app: {{ template "kuberhealthy.name" . }}
        {{- toYaml .Values.pod.customLabels | nindent 8 }}

最佳实践

1. 监控系统集成：为Prometheus、Datadog等监控工具添加专用标签
2. 多环境管理：通过env标签区分不同环境实例
3. 版本控制：标注组件版本便于升级追踪
4. 成本分摊：添加部门/项目标签用于资源核算

注意事项

1. 标签键需符合DNS子域名规范（RFC 1123）
2. 避免使用系统保留前缀（如kubernetes.io）
3. 标签值建议控制在63字符以内
4. 频繁变更的标签可能影响控制器性能

该增强功能已合并到主分支，用户可通过更新Helm Chart版本获得此能力。这标志着Kuberhealthy在可观测性集成方面迈出了重要一步，为复杂环境下的监控需求提供了更灵活的解决方案。