wanderadock/git2kube

git2kube - 从Git到Kubernetes

镜像概述

git2kube是一款用于实现Git仓库与Kubernetes资源（ConfigMap/Secret）同步的工具，支持一键同步或周期性同步，帮助用户将Git中的配置文件自动同步到K8s集群，实现配置的版本化管理与动态更新。

核心功能

• Git仓库与K8s ConfigMap/Secret的双向同步（支持一次性或周期性同步）
• 可配置的健康检查端口，适配K8s存活/就绪探针
• 支持自定义资源标签与注解
• 文件过滤规则（通过include/exclude参数筛选同步文件）
• 符号链接同步模式（适用于Sidecar容器部署场景）
• 支持SSH密钥与Basic认证方式访问Git仓库

使用场景

1. K8s配置版本控制：将集群配置文件存储在Git仓库，通过git2kube自动同步到ConfigMap/Secret，实现配置的版本追溯与变更管理。
2. 多环境配置同步：针对开发、测试、生产环境，通过不同Git分支同步对应配置，确保环境配置一致性。
3. Sidecar部署：作为Sidecar容器运行，将Git配置同步到共享目录，供主应用容器读取最新配置。

配置说明

• 同步模式：--once（一次性同步）或--interval <时间>（周期性同步，如30s、5m）
• 文件过滤：--include <路径>（包含文件）、--exclude <路径>（排除文件）
• 认证配置：--ssh-key-path <路径>（SSH密钥）或--username <用户名> --password <密码>（Basic认证）
• 资源配置：--configmap <名称>或--secret <名称>指定目标K8s资源，--namespace <命名空间>指定资源所在命名空间

Docker部署示例

一次性同步Git仓库到ConfigMap

bash
docker run --rm \
  -v ~/.kube/config:/root/.kube/config \
  wanderadock/git2kube \
  --git-repo https://github.com/your/config-repo.git \
  --git-branch main \
  --configmap app-config \
  --namespace default \
  --once

周期性同步Git仓库到Secret（每5分钟）

bash
docker run -d \
  -v ~/.kube/config:/root/.kube/config \
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
  wanderadock/git2kube \
  --git-repo ***:your/secret-repo.git \
  --ssh-key-path /root/.ssh/id_rsa \
  --secret app-secret \
  --namespace default \
  --interval 5m