CrateDB Docker 镜像文档

镜像概述

关于本镜像

本镜像为 crate 官方镜像 的 arm64v8 架构版本。有关多架构镜像的更多信息，参见 官方镜像文档中的“非 amd64 架构” 及 官方镜像 FAQ 中的“镜像源在 Git 中变更后如何处理？”。

主要用途

CrateDB 是一个开源的分布式 SQL 数据库，使您能够将数据转化为业务价值。它专为存储和实时分析海量机器数据而设计，兼具 NoSQL 数据库的扩展性与灵活性，可部署在从个人计算机到多区域混合云的各种环境中。

基本信息

• 维护者：Crate.io
• 获取帮助：项目文档、StackOverflow、支持渠道
• 支持架构：amd64、arm64v8
• 提交 issue：[***]

核心功能与特性

• 全面的 SQL 支持：标准 SQL 语法，结合动态模式、可查询对象、地理空间特性、时间序列数据支持、原生 BLOB 支持及实时全文搜索，同时处理关系型和文档型嵌套数据结构。
• 分布式架构：水平扩展、高可用且容错的集群，在虚拟化和容器化环境中表现优异。
• 高效查询执行：极快的分布式查询执行能力，支持全集群并行实时查询。
• 自动化数据管理：自动分区、自动分片和自动复制，简化集群运维。

使用场景

• 物联网（IoT）数据存储与分析：高效处理设备产生的海量时序数据，支持实时查询与分析。
• 实时日志与事件处理：低延迟摄入和查询大规模日志数据，适用于监控、故障排查场景。
• 监控与指标数据管理：存储服务器、应用程序监控指标，支持聚合分析和可视化。
• 大规模业务数据平台：作为混合数据架构的核心，统一处理结构化和非结构化数据。

使用方法

拉取镜像

使用以下命令拉取最新版本镜像：

docker pull arm64v8/crate:latest

如需指定版本，替换 latest 为具体标签（如 6.0.3）。

启动单节点容器

通过以下命令启动单节点 CrateDB 实例（适用于开发和测试）：

docker run --name crate -d \
  --publish 4200:4200 \  # Admin UI 端口
  --publish 5432:5432 \  # PostgreSQL 兼容端口（用于客户端连接）
  arm64v8/crate:latest \
  -Cdiscovery.type=single-node  # 单节点模式配置

参数说明

• --publish 4200:4200：映射 Admin UI 端口，可通过 http://localhost:4200 访问管理界面。
• --publish 5432:5432：映射 PostgreSQL 兼容端口，支持使用 psql 等客户端连接。
• -Cdiscovery.type=single-node：配置为单节点模式，禁用集群发现。

Docker Compose 示例

创建 docker-compose.yml 文件，定义单节点部署：

version: '3'
services:
  crate:
    image: arm64v8/crate:latest
    container_name: crate
    ports:
      - "4200:4200"
      - "5432:5432"
    command: -Cdiscovery.type=single-node
    volumes:
      - crate-data:/data  # 持久化数据（可选）
volumes:
  crate-data:

启动服务：

docker-compose up -d

连接数据库

使用 psql 客户端连接（需提前安装 PostgreSQL 客户端）：

psql -h localhost -p 5432 -U crate

默认用户为 crate，无密码（生产环境需配置认证）。

支持的标签及对应 Dockerfile 链接

配置参数

CrateDB 通过命令行参数（-Ckey=value）或配置文件进行配置。常用参数：

注意事项

内存管理兼容性问题

Linux 内核 3.x 与 Docker >=1.12 组合可能存在内存统计 bug，导致内核杀死 CrateDB 进程。该问题已在 内核 >=4.0 中修复，生产环境建议使用内核 4.0 及以上版本。

问题反馈

• 镜像相关问题：docker-crate GitHub Issues
• CrateDB 本身问题：crate GitHub Issues

贡献指南

本镜像由 Crate.io 维护，欢迎社区贡献。详见 贡献文档。

许可证

CrateDB 基于 Apache License 2.0 许可，详见 LICENSE。
镜像可能包含其他软件（如基础系统组件、依赖库），其许可证需另行查阅。镜像用户需确保合规使用所有包含软件。