hivemq/init-dns-wait

hivemq/init-dns-wait 镜像文档

镜像概述

hivemq/init-dns-wait 是一个初始化容器，用于检查服务的DNS条目，确保新节点在旧节点终止后才启动。该镜像主要被旧版HiveMQ Operator使用，用于控制HiveMQ集群节点的启动顺序。

核心功能

• 检查指定服务的DNS条目，确认当前可用节点数量
• 控制新节点启动时机，确保旧节点已终止
• 基于配置参数实现等待逻辑，包括冷却时间、目标节点数量和总超时时间

使用场景

适用于HiveMQ集群部署场景，特别是在使用旧版HiveMQ Operator时，需要确保节点启动顺序，避免新旧节点同时运行导致的集群不稳定问题。

使用方法

前提条件

• 已部署Kubernetes集群
• 已创建HiveMQ相关Deployment资源
• 需使用旧版HiveMQ Operator（注意：旧版已退役，建议迁移至新版）

部署步骤

1. 在Deployment中添加initContainers

在Deployment的spec.template.spec.initContainers字段中添加以下配置：

yaml
- name: dns-wait
  image: docker.xuanyuan.run/hivemq/init-dns-wait:1.0.0
  volumeMounts:
  - mountPath: /mnt/misc
    name: dns-wait-config

2. 添加对应的volume配置

在Deployment的spec.template.spec.volumes字段中添加卷配置：

yaml
- name: dns-wait-config
  configMap:
    name: dns-wait-config

3. 创建ConfigMap配置

在与Deployment相同的命名空间中创建ConfigMap，根据实际需求替换参数值：

yaml
apiVersion: v1
kind: ConfigMap
data:
  # HiveMQ DNS发现地址
  address: your-discovery.namespace.svc.cluster.local.
  # 旧节点离开后等待复制任务的时间（秒）
  coolDown: "40"
  # 升级过程中等待的目标节点数量（应设置为集群大小+1）
  count: "13"
  # 轮询DNS地址的总等待时间（秒），超时后节点将继续启动
  timeOut: "600"
metadata:
  name: dns-wait-config

配置参数说明

注意事项

警告：旧版HiveMQ Operator及其Helm chart已于2025年4月退役，不再接收更新或支持。如需迁移到当前Kubernetes的HiveMQ Platform Operator，请参阅https://docs.hivemq.com/hivemq-operator/migration-guide.html%E3%80%82