xingse/kubernetes-deployment-restart-controller

镜像概述

本镜像提供一个Kubernetes控制器，旨在解决配置资源（ConfigMaps/Secrets）变更后应用未自动更新的问题。当关联的ConfigMaps或Secrets发生修改时，控制器会自动识别并重启引用这些资源的Deployments，确保应用及时加载最新配置。

核心功能

• 实时监听ConfigMaps和Secrets的变更事件
• 自动识别引用目标配置资源的Deployments
• 触发相关Deployments的滚动重启操作
• 支持通过标签选择器过滤需监控的Deployments
• 可配置监听的命名空间范围

使用场景

1. 微服务配置更新：微服务架构中，配置变更后无需手动重启服务，控制器自动完成更新
2. CI/CD流水线集成：配置文件更新后，自动触发应用重启，实现配置与应用同步
3. 多环境管理：在开发、测试、生产环境中，确保配置变更快速生效
4. 批量应用配置：对多个引用同一配置的Deployments进行批量重启

配置说明

控制器支持通过环境变量或命令行参数进行配置：

• 环境变量：
  • NAMESPACE：指定监听的命名空间（默认：所有命名空间）
  • LABEL_SELECTOR：过滤需监控的Deployments的标签选择器（例如：app=my-service）
• 命令行参数：
  • --namespace：同环境变量NAMESPACE
  • --label-selector：同环境变量LABEL_SELECTOR

部署示例

使用kubectl部署

创建控制器部署文件（controller-deployment.yaml）：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: k8s-deployment-restart-controller
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      app: restart-controller
  template:
    metadata:
      labels:
        app: restart-controller
    spec:
      serviceAccountName: restart-controller-sa
      containers:
      - name: controller
        image: xingse/kubernetes-deployment-restart-controller
        env:
        - name: NAMESPACE
          value: "default"
        - name: LABEL_SELECTOR
          value: "app=my-app"

执行部署：

bash
kubectl apply -f controller-deployment.yaml

使用Docker运行（本地测试）

bash
docker run -v ~/.kube/config:/root/.kube/config \
  xingse/kubernetes-deployment-restart-controller \
  --namespace=default \
  --label-selector=app=my-app