mirantis/k8s-daemonupgradecontroller

Daemon Set升级控制器

镜像概述和主要用途

该控制器用于管理Kubernetes DaemonSet的升级过程。它通过PodTemplates存储升级历史，支持回滚到之前版本，并允许暂停升级过程。

核心功能和特性

• 管理DaemonSet升级：监控DaemonSet的Spec.Template变化，自动触发升级
• 存储升级历史：使用PodTemplates记录历史版本信息
• 支持回滚操作：可指定回滚到特定的历史revision
• 暂停升级机制：允许暂停正在进行的升级过程
• 多策略支持：提供RollingUpdate和Noop两种升级策略
• 可控的不可用性：可配置升级过程中允许同时不可用的pod数量

使用场景和适用范围

适用于需要精细化管理Kubernetes集群中DaemonSet升级的场景，特别是在需要控制升级节奏、确保服务稳定性、以及在出现问题时能够快速回滚的生产环境中。

详细使用方法和配置说明

安装

Daemon升级控制器可作为Docker容器在Kubernetes集群内部部署。

创建部署配置文件controller.yml：

yaml
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: daemonupgrader
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: daemonupgrader
    spec:
      containers:
      - name: daemonupgrader
        image: docker.xuanyuan.run/mirantis/k8s-daemonupgradecontroller:latest
        imagePullPolicy: IfNotPresent

使用kubectl部署：

shell
kubectl --namespace kube-system apply -f controller.yml

使用

所有配置通过DaemonSet的注解(annotations)进行设置。

默认情况下，控制器不会主动处理运行中的daemons。要启用升级功能，需设置策略类型注解：

yaml
metadata:
  annotations:
    daemonset.kubernetes.io/strategyType: "RollingUpdate"

设置后，当DaemonSet的Spec.Template发生变化时，控制器将删除旧pod并创建新pod。默认一次删除一个pod，并等待新pod进入Ready状态。可通过以下注解配置升级过程中允许的最大不可用pod数量：

yaml
metadata:
  annotations:
    daemonset.kubernetes.io/maxUnavailable: "1"

所有配置选项

daemonset.kubernetes.io/paused

• 描述：控制是否暂停升级过程
• 取值："true"或"1"表示暂停升级；其他值或不存在表示正常进行

daemonset.kubernetes.io/rollbackTo

• 描述：指定要回滚到的revision编号
• 行为：回滚完成后，该注解将自动设为空字符串

daemonset.kubernetes.io/strategyType

• 描述：设置升级策略类型
• 支持的策略：
  • RollingUpdate：删除旧pod并等待新pod创建，默认一次删除一个pod
  • Noop：不执行任何升级操作

daemonset.kubernetes.io/maxUnavailable

• 描述：设置升级过程中允许同时不可用的pod数量
• 默认值：1
• 取值：正整数，代表具体数量