dnationcloud/kubernetes-jsonnet-translator

dNation Kubernetes Jsonnet Translator

镜像概述和主要用途

dNation Kubernetes Jsonnet Translator是一个轻量容器，旨在在Kubernetes集群内部运行，用于将存储在ConfigMap中的Jsonnet内容转换为Grafana仪表板或Prometheus规则。该工具通过标签识别指定命名空间中包含Jsonnet代码的ConfigMap，评估Jsonnet配置后生成相应的Kubernetes对象，实现监控资源的动态管理。

核心功能和特性

• Kubernetes原生集成：在K8s集群内运行，直接与ConfigMap资源交互
• Jsonnet转换能力：将Jsonnet配置转换为Grafana仪表板或Prometheus规则
• 标签选择机制：通过标签筛选需要处理的Jsonnet ConfigMap
• 灵活配置：支持通过程序参数和ConfigMap注解进行配置
• Helm部署支持：提供Helm Chart简化部署流程

使用场景和适用范围

适用于需要在Kubernetes集群中集中管理监控资源的场景，特别是：

• 通过Jsonnet定义Grafana仪表板，实现配置即代码
• 动态生成和更新Prometheus监控规则
• 简化大规模监控资源的管理和版本控制

安装与使用方法

前提条件

• Helm 3

安装步骤

dNation Kubernetes Jsonnet Translator Chart托管在dNation Helm仓库中，安装步骤如下：

bash
# 添加dNation helm仓库
helm repo add dnationcloud https://dnationcloud.github.io/helm-hub/
helm repo update

# 安装dNation Jsonnet Translator
helm install dnation-kubernetes-jsonnet-translator dnationcloud/dnation-kubernetes-jsonnet-translator

测试示例

验证安装是否正常工作的示例可在https://github.com/dNationCloud/kubernetes-jsonnet-translator/tree/main/examples%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

配置说明

全局配置

全局配置通过程序参数设置（Helm安装时在values.yaml中配置）。可配置的参数及其默认值见https://github.com/dNationCloud/kubernetes-jsonnet-translator/blob/main/default_config.yaml%EF%BC%8C%E5%8F%82%E6%95%B0%E8%AF%A6%E7%BB%86%E6%8F%8F%E8%BF%B0%E8%A7%81https://github.com/dNationCloud/kubernetes-jsonnet-translator/blob/main/translator/arg_parser.py%E3%80%82

ConfigMap注解配置

Jsonnet ConfigMap的额外配置可通过注解实现，示例配置见https://github.com/dNationCloud/kubernetes-jsonnet-translator/blob/main/examples/grafana-jsonnet-ext.yaml#L11%E3%80%82

Jsonnet构建参数

支持的Jsonnet构建关键字参数可参考Jsonnet官方文档（不包含回调函数）。