citusdata/workerlist-gen

workerlist-gen

workerlist-gen是一个轻量Docker镜像，需与Citus主节点容器同主机运行。它通过https://github.com/jwilder/docker-gen监听Docker事件，自动重新生成Citus工作节点列表文件，适用于动态调整的Citus集群场景。

核心功能

1. 监听Docker事件：当带有com.citusdata.role=Worker标签的容器被添加或销毁时，自动更新工作节点列表。
2. 生成配置文件：将所有Worker节点的主机名（默认端口5432）写入/etc/citus/pg_worker_list.conf。
3. 触发元数据更新：文件更新后，通过psql调用master_initialize_node_metadata，强制Citus主节点刷新工作节点表（需通过套接字连接名为citus_master的容器）。

使用场景

• Citus集群动态扩展：新增Worker节点时自动加入列表。
• Citus集群缩容：移除Worker节点时自动从列表中删除。
• 集群维护：确保主节点始终拥有最新的工作节点元数据。

配置说明

基础部署示例

假设Docker守护进程套接字位于默认路径/var/run/docker.sock：

bash
docker run --name workerlist-gen           \
  -v /var/run/docker.sock:/tmp/docker.sock \
  citusdata/workerlist-gen

环境变量

• CITUS_CONFDIR：工作节点列表文件的输出目录（默认：/etc/citus）。

真实场景示例

若Citus主节点容器citus_master将配置文件挂载在/etc/citusconf（非默认路径）：

bash
docker run --name workerlist-gen           \
  -v /var/run/docker.sock:/tmp/docker.sock \
  --volumes-from citus_master              \
  -e CITUS_CONFDIR=/etc/citusconf          \
  citusdata/workerlist-gen

通过--volumes-from共享配置目录，确保主节点能读取更新后的列表文件。

许可证

Copyright © 2016 Citus Data, Inc.

基于Apache License 2.0许可（详见LICENSE）。您可在遵循许可条款的前提下使用、复制、修改本软件。