aptosretail/cratedb-crash

CrateDB Crash Shell 实用容器

镜像概述

该容器是用于运行CrateDB Crash shell命令的实用工具，预安装了CrateDB官方交互式shell工具Crash。Crash是CrateDB的原生命令行界面，支持执行SQL语句、管理集群配置及监控集群状态。本容器无需在本地系统安装Crash，即可快速连接并操作CrateDB集群，适用于开发调试、集群管理及自动化脚本场景。

核心功能与特性

• 预配置环境：容器内置最新稳定版Crash工具，无需额外安装依赖
• 集群连接：支持通过网络连接远程或本地CrateDB集群
• 交互模式：提供交互式命令行界面，支持命令补全与历史记录
• 批量执行：支持执行本地SQL脚本文件或单行命令
• 轻量设计：基于Alpine基础镜像，镜像体积小，启动速度快

使用场景

• 开发者调试CrateDB集群，执行SQL查询验证数据模型
• 数据库管理员执行集群维护命令（如索引创建、用户管理）
• 自动化运维脚本中集成Crash命令，实现批量操作
• CI/CD流程中嵌入容器，验证CrateDB集群部署状态

使用方法

基本交互式连接

通过交互式终端连接到CrateDB集群：

bash
docker run -it --rm crate/crash --host <crate-cluster-host> --port <crate-port>

• <crate-cluster-host>：CrateDB集群节点IP或域名（默认：localhost）
• <crate-port>：CrateDB HTTP端口（默认：4200）

示例（连接本地集群）：

bash
docker run -it --rm crate/crash --host 127.0.0.1

执行单行命令

直接执行单个SQL命令并退出：

bash
docker run --rm crate/crash --host <crate-cluster-host> -c "SELECT name, version FROM sys.nodes;"

执行本地SQL脚本

挂载本地SQL文件并执行：

bash
docker run --rm -v $(pwd)/scripts:/scripts crate/crash --host <crate-cluster-host> -f /scripts/init.sql

• 将本地./scripts目录挂载到容器/scripts路径
• -f参数指定要执行的SQL脚本文件路径

Docker Compose集成

在docker-compose.yml中配置容器，与CrateDB集群联动：

yaml
version: '3'
services:
  crash:
    image: crate/crash
    command: --host crate-node-1 --port 4200
    depends_on:
      - crate-node-1
  crate-node-1:
    image: crate:latest
    ports:
      - "4200:4200"
    environment:
      - CRATE_HEAP_SIZE=1g

配置参数

环境变量

命令行参数

注意事项

• 确保CrateDB集群的HTTP端口（默认4200）对容器可见且可访问
• 生产环境建议通过环境变量或Docker Secrets管理认证信息
• 执行批量操作时，可通过-v参数挂载本地目录，避免命令行长度限制