alexbarcelo/node-metadata-preprocessor

NodeMetadataPreprocessor

镜像概述

NodeMetadataPreprocessor镜像旨在通过Kubernetes节点的元数据，结合Jinja模板引擎动态生成适配当前节点环境的配置文件，简化集群中配置的自动化管理。

核心功能

1. 读取Kubernetes节点元数据（如节点名称、标签、资源限制等）；
2. 使用Jinja模板语法对配置文件进行动态渲染；
3. 输出预处理后的定制化配置文件。

使用场景

1. K8s集群中应用部署时，根据节点特性生成差异化配置；
2. 自动化配置管理，减少手动调整配置的工作量；
3. 适配多节点环境下的配置需求差异。

配置说明

• 需确保容器可访问Kubernetes节点元数据（可通过K8s downward API或挂载相关卷实现）；
• 提供Jinja模板文件路径及输出文件路径。

部署示例

Docker Run命令

bash
docker run \
  -v /local/templates:/app/templates \
  -v /local/output:/app/output \
  -e NODE_METADATA_PATH=/app/metadata/node_info.json \
  alexbarcelo/node-metadata-preprocessor \
  --template /app/templates/config.j2 \
  --output /app/output/config.conf

Kubernetes Deployment示例（简化）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: metadata-preprocessor
spec:
  replicas: 1
  selector:
    matchLabels:
      app: preprocessor
  template:
    metadata:
      labels:
        app: preprocessor
    spec:
      containers:
      - name: preprocessor
        image: alexbarcelo/node-metadata-preprocessor
        volumeMounts:
        - name: templates
          mountPath: /app/templates
        - name: output
          mountPath: /app/output
        env:
        - name: NODE_NAME
          valueFrom:
            fieldRef:
              fieldPath: spec.nodeName
        args: ["--template", "/app/templates/config.j2", "--output", "/app/output/config.conf"]
      volumes:
      - name: templates
        configMap:
          name: config-templates
      - name: output
        emptyDir: {}