nsuke/thrift

Apache Thrift CI临时Docker镜像

镜像概述

本Docker镜像为Apache Thrift项目的持续集成(CI)流程提供临时运行环境，集成了Thrift编译器、多语言库、测试工具及教程资源，旨在支持自动化构建、单元测试和跨语言兼容性验证。

核心功能与特性

• 完整工具链：包含Thrift编译器（C++实现）及多语言库（C++、Go、Java、PHP、Python、Ruby等）
• 测试支持：内置测试用例和跨语言测试框架，可执行单元测试与多语言交互测试
• CI优化：专为自动化流程设计，确保环境一致性，支持快速部署和流程标准化
• 文档资源：包含教程和示例代码，便于CI过程中的功能验证和问题排查

适用场景

• Apache Thrift项目的持续集成构建流程
• Thrift多语言库的自动化测试与版本兼容性验证
• Thrift应用开发中的临时测试环境搭建
• Thrift版本更新的自动化验证与回归测试

使用方法

基本启动命令

bash
docker run -it --rm thrift-ci:latest /bin/bash

执行构建与测试流程

在容器内执行Thrift项目标准构建流程：

bash
# 生成配置脚本（首次构建时）
./bootstrap.sh

# 配置构建选项（可指定Boost路径、编译参数等）
./configure --with-boost=/usr/local CXXFLAGS='-g -O2'

# 编译项目
make

# 运行单元测试（支持多语言库测试）
make -k check

# 运行跨语言测试套件
make cross

Docker Compose配置示例

yaml
version: '3'
services:
  thrift-ci:
    image: thrift-ci:latest
    volumes:
      - ./thrift-source:/thrift  # 挂载本地Thrift源码目录
    command: >
      /bin/bash -c "cd /thrift && 
                    ./bootstrap.sh && 
                    ./configure --with-boost=/usr/local && 
                    make && 
                    make check && 
                    make cross"

镜像结构

镜像遵循Apache Thrift项目标准目录结构：

• /thrift/compiler：Thrift编译器（C++实现）
• /thrift/lib：多语言库实现，按语言分目录（cpp/、go/、java/、php/、py/、rb/等）
• /thrift/test：测试用例和跨语言测试代码
• /thrift/tutorial：Thrift开发教程和示例代码

配置说明

构建参数

• --with-boost=<path>：指定Boost库路径（如/usr/local）
• CXXFLAGS='-g -O2'：C++编译选项（调试符号、优化级别）
• CFLAGS='-g -O2'：C编译选项
• CPPFLAGS='-DDEBUG_MY_FEATURE'：预处理器定义
• --enable-coverage：启用代码覆盖率测试（需添加-fprofile-arcs -ftest-coverage编译选项）

环境变量

• PY_PREFIX：指定Python库安装路径（覆盖默认distutils行为）
• DESTDIR：指定安装根目录（对C++和Python库均有效）

注意事项

• 本镜像为CI临时环境，不建议用于生产部署
• 部分语言库（Java、Ruby、PHP等）需通过对应语言构建工具手动安装，详情参见lib/<language>/README.md
• 首次从源码仓库构建时需执行./bootstrap.sh生成配置脚本，下载tarball包则无需此步骤

许可证

基于Apache License 2.0许可，详见Apache License 2.0。

资源链接

• Apache Thrift官方网站：[***]
• 安装文档：[***]