CrateDB Docker 镜像文档

镜像概述

关于本镜像

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

主要用途

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

基本信息

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

核心功能与特性

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

使用场景

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

使用方法

拉取镜像

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

bash
docker pull arm64v8/crate:latest

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

启动单节点容器

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

bash
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 文件，定义单节点部署：

yaml
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:

启动服务：

bash
docker-compose up -d

连接数据库

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

bash
psql -h localhost -p 5432 -U crate

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

支持的标签及对应 Dockerfile 链接

标签	Dockerfile 链接
`6.0.3`, `6.0`, `latest`	GitHub
`5.10.13`, `5.10`	GitHub

配置参数

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

参数	说明	示例
`discovery.type`	集群发现模式，`single-node` 为单节点，`zen` 为多节点	`-Cdiscovery.type=single-node`
`cluster.name`	集群名称，同一集群节点需一致	`-Ccluster.name=my-crate-cluster`
`node.name`	节点名称，默认随机生成	`-Cnode.name=node-1`
`path.data`	数据存储路径（容器内），建议挂载外部卷持久化	`-Cpath.data=/data/crate`
`path.logs`	日志存储路径	`-Cpath.logs=/var/log/crate`