cockroachdb/acceptance

CockroachDB验收测试Docker镜像

镜像概述和主要用途

该Docker镜像专为运行CockroachDB验收测试设计，主要用于验证各类语言的简单客户端能否通过Postgres wire协议连接并与CockroachDB进行交互，确保数据库在多语言环境下的兼容性和基础功能正常。

核心功能和特性

• 验收测试执行：支持CockroachDB全套验收测试流程的运行
• 多语言工具集成：内置php、node、java等多种语言客户端运行所需的工具和依赖环境
• 协议兼容性验证：验证客户端通过Postgres wire协议与CockroachDB的连接能力
• 交互功能测试：确保不同语言客户端能正常与CockroachDB进行数据交互操作

使用场景和适用范围

• CockroachDB开发阶段的功能验证与兼容性测试
• 多语言客户端与CockroachDB集成前的预验证测试
• 自动化测试流程中的验收测试环节
• 数据库版本更新或配置变更后的回归测试

使用方法和配置说明

基本使用步骤

1. 拉取镜像（假设镜像名称为cockroachdb/acceptance-test）：

   bash
   docker pull cockroachdb/acceptance-test
   

2. 运行测试：

   bash
   docker run --rm cockroachdb/acceptance-test
   

高级配置选项

• 挂载自定义测试用例：通过卷挂载本地测试文件目录以执行自定义测试：

  bash
  docker run --rm -v /path/to/local/tests:/tests cockroachdb/acceptance-test
  

• 环境变量配置：可通过环境变量指定CockroachDB实例地址、测试超时时间等参数：

  bash
  docker run --rm \
    -e COCKROACHDB_HOST=your-cockroachdb-instance \
    -e TEST_TIMEOUT=300 \
    cockroachdb/acceptance-test
  

Docker Compose集成示例

yaml
version: '3'
services:
  acceptance-test:
    image: cockroachdb/acceptance-test
    environment:
      - COCKROACHDB_HOST=cockroachdb
      - TEST_TIMEOUT=300
    depends_on:
      - cockroachdb

  cockroachdb:
    image: cockroachdb/cockroach:latest
    command: start-single-node --insecure
    ports:
      - "26257:26257"