juliuszaromskis/cockroachdb

Cockroach DB 开发镜像

镜像概述

该镜像提供Cockroach DB的开发构建版本，专门针对Intel和Apple silicon M1 MAC平台优化，适用于本地开发和测试环境，帮助开发人员在不同架构的Mac设备上高效进行Cockroach DB应用开发。

核心功能和特性

• 多架构支持：兼容Intel x86_64和Apple silicon M1 (ARM64)架构，确保在不同Mac设备上正常运行
• 开发环境优化：包含Cockroach DB开发所需的完整工具链，支持快速启动和调试
• API兼容性：与官方Cockroach DB API保持一致，确保开发成果可无缝迁移至生产环境
• 轻量级设计：针对开发场景优化镜像大小，减少资源占用，加快启动速度

使用场景和适用范围

• 开发人员在本地构建和测试基于Cockroach DB的应用程序
• 多架构开发环境下的应用兼容性验证
• 学习和探索Cockroach DB功能特性的本地开发环境
• 小型开发团队的协作开发与测试环境搭建

使用方法和配置说明

基本启动命令

通过以下命令快速启动Cockroach DB开发容器：

bash
docker run -d -p 26257:26257 -p 8080:8080 --name cockroach-dev cockroachdb/dev:latest

• -p 26257:26257：映射数据库服务端口
• -p 8080:8080：映射Web管理界面端口
• --name cockroach-dev：指定容器名称

环境变量配置

示例：指定自定义用户和密码启动

bash
docker run -d \
  -p 26257:26257 -p 8080:8080 \
  -e COCKROACH_USER=devuser \
  -e COCKROACH_PASSWORD=devpass123 \
  -e COCKROACH_DB=devdb \
  --name cockroach-dev cockroachdb/dev:latest

数据持久化

为避免容器重启后数据丢失，可挂载本地目录作为数据卷：

bash
docker run -d \
  -p 26257:26257 -p 8080:8080 \
  -v ./cockroach-data:/cockroach/cockroach-data \
  --name cockroach-dev cockroachdb/dev:latest

连接数据库

使用Cockroach DB客户端连接到运行中的容器：

bash
docker exec -it cockroach-dev ./cockroach sql --insecure --host=localhost --user=devuser --database=devdb

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  cockroach:
    image: cockroachdb/dev:latest
    ports:
      - "26257:26257"  # 数据库服务端口
      - "8080:8080"    # Web管理界面端口
    volumes:
      - ./cockroach-data:/cockroach/cockroach-data  # 数据持久化
    environment:
      - COCKROACH_USER=devuser
      - COCKROACH_PASSWORD=devpass123
      - COCKROACH_DB=devdb
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

查看日志：

bash
docker-compose logs -f

停止服务：

bash
docker-compose down