altinityinfra/clickhouse-sink-connector Docker 镜像 - 轩辕镜像

ClickHouse接收器连接器PR专用镜像

镜像概述

该镜像为ClickHouse数据库的接收器连接器专用版本，专为代码拉取请求（PR）流程设计。旨在帮助开发团队在提交代码变更前，通过自动化方式验证数据写入ClickHouse的功能正确性，减少合并后的数据管道故障风险。

核心功能与特性

• ClickHouse集成：支持与ClickHouse数据库的标准协议通信，兼容常用数据写入接口（如HTTP、Native协议）
• PR流程适配：轻量级设计，快速启动，适合CI/CD环境中PR阶段的自动化测试
• 数据验证能力：内置基础数据校验逻辑，可验证数据格式、完整性及写入性能
• 配置灵活性：支持通过环境变量自定义ClickHouse连接参数及测试数据来源

使用场景

• PR提交前验证：开发人员提交代码变更（如数据处理逻辑、连接器功能优化）后，通过该镜像测试数据写入ClickHouse的正确性
• CI/CD流程集成：作为PR检查环节的一部分，在自动化测试流程中验证数据管道末端（ClickHouse写入）的功能
• 多环境测试：模拟不同ClickHouse集群配置（如权限策略、网络环境）下的数据写入表现

使用方法与配置说明

环境变量配置

基础使用示例（Docker Run）

bash
docker run --rm \
  -e CLICKHOUSE_HOST=clickhouse-test-server \
  -e CLICKHOUSE_PORT=9000 \
  -e CLICKHOUSE_USER=pr_test \
  -e CLICKHOUSE_PASSWORD=pr_test_pass \
  -e CLICKHOUSE_DATABASE=test_db \
  -v /local/test-data:/test/data \  # 挂载本地测试数据到容器内
  your-registry/clickhouse-sink-pr:latest

CI/CD集成示例（GitHub Actions）

在PR检查流程中添加如下步骤（.github/workflows/pr-check.yml）：

yaml
jobs:
  clickhouse-sink-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Start ClickHouse test instance
        run: docker run -d --name clickhouse-test -p 8123:8123 clickhouse/clickhouse-server:latest
      
      - name: Run PR sink test
        run: |
          docker run --rm \
            -e CLICKHOUSE_HOST=localhost \
            -e CLICKHOUSE_PORT=8123 \
            -e TEST_DATA_PATH=/github/workspace/test-data \
            -v ${{ github.workspace }}/test-data:/github/workspace/test-data \
            your-registry/clickhouse-sink-pr:latest

注意事项

• 确保CI/CD环境网络可访问目标ClickHouse测试实例（建议使用容器化ClickHouse作为测试环境）
• 测试数据应覆盖边界场景（如大字段、特殊字符、高并发写入）以提高验证准确性
• 根据ClickHouse版本选择匹配的镜像标签（如针对ClickHouse 23.3+使用v23系列标签）