eddify/citus-docker

Citus Docker镜像

https://imagelayers.io/?images=citusdata%2Fcitus:latest https://github.com/citusdata/docker/releases/latest

镜像概述

Citus是基于PostgreSQL的分布式关系型数据库（RDBMS），本镜像提供Citus实例的容器化部署能力，基于官方PostgreSQL镜像构建，支持单实例运行及集群扩展，便于快速搭建分布式数据存储与查询环境。

核心功能

1. 兼容PostgreSQL生态：基于PostgreSQL 9.6构建，支持PostgreSQL语法与工具链；
2. 端口暴露：默认开放5432端口，支持外部客户端（psql、应用程序）连接；
3. 集群扩展：可动态添加worker节点，提升分布式处理能力；
4. 数据持久化：默认PGDATA目录作为卷挂载，确保容器重启后数据不丢失；
5. 版本支持：提供稳定版及nightly版（包含Citus master分支最新功能）。

使用场景

• 大规模数据的分布式存储与查询需求；
• 高并发场景下的数据库水平扩展；
• 分布式数据库测试环境的快速搭建；
• 需要利用PostgreSQL生态同时具备分布式能力的业务场景。

配置说明

本镜像基于官方PostgreSQL镜像，可参考其文档进行高级配置，关键参数包括：

• PGDATA：指定数据库数据存储路径；
• POSTGRES_USER：设置默认数据库用户；
• POSTGRES_PASSWORD：设置数据库用户密码；
• POSTGRES_DB：指定默认创建的数据库名称。

部署示例

单实例部署

快速启动独立Citus实例：

bash
docker run --name citus_standalone -p 5432:5432 docker.xuanyuan.run/eddify/citus-docker

启动后可通过127.0.0.1:5432（本地）或docker-machine ip（使用docker-machine时）连接数据库。

Docker Compose集群部署

通过docker-compose.yml搭建多worker集群：

1. 复制镜像提供的docker-compose.yml到当前目录；
2. 启动集群：

bash
docker-compose -p citus up

3. 扩展worker节点（例如至5个）：

bash
docker-compose -p citus scale worker=5

4. 验证worker节点： 连接master节点后执行SQL：

sql
SELECT master_get_active_worker_nodes();

5. 停止集群：

bash
docker-compose -p citus down

Docker Cloud集群部署

通过Docker Cloud CLI搭建云端集群：

1. 创建节点集群：

bash
docker-cloud nodecluster create --tag master citus_master_node digitalocean nyc1 2gb
docker-cloud nodecluster create --tag worker -t2 citus_worker_nodes digitalocean nyc1 1gb

2. 启动栈：

bash
docker-cloud stack up -n citus-cloud

3. 扩展worker节点：

bash
docker-cloud service scale worker.citus-cloud 5

4. 终止栈：

bash
docker-cloud stack terminate citus-cloud

许可证

本仓库内文件遵循Apache License 2.0协议，Citus本身的许可证请参考其官方仓库。