configseeder/kubernetes-connector

ConfigSeeder® Kubernetes Connector 镜像文档

1. 镜像概述与主要用途

ConfigSeeder® Kubernetes Connector 是 ConfigSeeder® 配置管理系统的官方扩展组件，用于从 ConfigSeeder® 检索配置数据，并将其转换为 Kubernetes 或 OpenShift 集群中的 ConfigMaps 和 Secrets 资源。该镜像设计为以 Kubernetes Job 或 CronJob 形式运行，旨在为集群内应用提供集中管理、安全分发的配置数据。

2. 核心功能与特性

• 配置数据检索：通过 ConfigSeeder® API 安全获取指定配置集数据
• 资源转换：自动将配置数据转换为 Kubernetes 原生 ConfigMaps（非敏感配置）和 Secrets（敏感配置）
• 灵活部署模式：支持一次性同步（Job）或周期性同步（CronJob）
• 多环境兼容：适配 Kubernetes 及 OpenShift 集群环境

3. 使用场景与适用范围

适用环境

• Kubernetes 集群（支持 Job/CronJob 资源的所有版本）
• OpenShift 集群

典型使用场景

• 集中式配置管理：需从 ConfigSeeder® 同步配置到 Kubernetes 集群的应用
• 动态配置更新：通过 CronJob 定期同步配置，实现应用配置动态更新
• 敏感信息管理：将 ConfigSeeder® 中的敏感配置转换为 Kubernetes Secrets

4. 使用方法与配置说明

4.1 部署方式（Kubernetes Job 示例）

以下为一次性同步配置的 Job 资源示例：

yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: configseeder-k8s-connector
  namespace: default
spec:
  template:
    spec:
      containers:
      - name: configseeder-k8s-connector
        image: configseeder/kubernetes-connector:latest  # 替换为实际镜像版本
        env:
        - name: CONFIGSEEDER_URL
          value: "https://configseeder.example.com"  # ConfigSeeder® 服务地址
        - name: CONFIGSEEDER_API_KEY
          valueFrom:
            secretKeyRef:
              name: configseeder-credentials  # 存储 API 密钥的 Secret 名称
              key: api-key  # Secret 中 API 密钥的键名
        - name: CONFIG_SET_ID
          value: "app-backend-config"  # 需同步的 ConfigSeeder® 配置集 ID
        - name: TARGET_NAMESPACE
          value: "app-namespace"  # 目标 ConfigMaps/Secrets 所在命名空间
      restartPolicy: Never
  backoffLimit: 4  # 失败重试次数

4.2 周期性同步（CronJob 示例）

如需定期同步，可部署为 CronJob（以下示例每 30 分钟同步一次）：

yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: configseeder-k8s-connector-cron
  namespace: default
spec:
  schedule: "*/30 * * * *"  # Cron 表达式，每 30 分钟执行一次
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: configseeder-k8s-connector
            image: configseeder/kubernetes-connector:latest
            env:
            - name: CONFIGSEEDER_URL
              value: "https://configseeder.example.com"
            - name: CONFIGSEEDER_API_KEY
              valueFrom:
                secretKeyRef:
                  name: configseeder-credentials
                  key: api-key
            - name: CONFIG_SET_ID
              value: "app-backend-config"
            - name: TARGET_NAMESPACE
              value: "app-namespace"
            - name: SYNC_MODE
              value: "OVERWRITE"  # 覆盖现有同名 ConfigMaps/Secrets
          restartPolicy: Never
      backoffLimit: 4

4.3 核心配置参数

5. 参考资源

• ConfigSeeder 官方网站
• Kubernetes Connector 功能介绍
• Kubernetes Connector 快速入门指南