openquantumsafe/ci-alpine-amd64

OQS持续集成测试专用Alpine环境镜像

镜像概述和主要用途

本镜像为OQS（Open Quantum Safe）项目的持续集成（CI）测试提供预构建的Alpine Linux环境。旨在解决CI流程中环境配置不一致、重复构建耗时等问题，通过提供包含核心依赖的标准化环境，确保OQS相关组件的集成测试可重复、高效执行，降低环境因素对测试结果的干扰。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，具备体积小（通常<100MB）、资源占用低、安全加固的特点，适合CI环境资源优化
• 预构建环境：已预装OQS持续集成测试所需的编译器（GCC/Clang）、测试工具（CMake、CTest）及OQS基础依赖库，减少环境准备时间
• CI流程适配：针对自动化测试流程优化，支持与主流CI工具（GitHub Actions、GitLab CI、Jenkins等）无缝集成
• 环境一致性：标准化配置确保不同执行环境（开发机、CI服务器）的测试结果一致，避免"环境差异导致测试失败"问题

使用场景和适用范围

• OQS项目开发者：本地开发阶段快速验证代码变更，无需手动配置完整测试环境
• CI/CD流水线：作为OQS组件（如liboqs、oqs-openssl等）自动化测试的执行环境，集成到构建-测试-部署流程
• 第三方集成测试：需验证基于OQS的应用或库兼容性的团队，确保集成组件在标准化环境中正常工作
• 教学与研究：OQS相关技术学习或量子安全算法研究中，快速搭建可复现的测试环境

使用方法和配置说明

基本使用

通过docker run命令启动容器，默认进入交互式Shell环境：

bash
docker run -it --rm oqs-ci-alpine

挂载测试代码执行测试

将本地测试项目目录挂载到容器中，执行测试命令：

bash
# 挂载当前目录（含测试代码）到容器/test目录，并运行测试脚本
docker run --rm -v $(pwd):/test oqs-ci-alpine /bin/sh -c "cd /test && ./ci-test.sh"

集成到GitHub Actions流水线

在项目.github/workflows/ci.yml中添加以下配置，实现自动化测试：

yaml
jobs:
  oqs-integration-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run OQS CI tests
        uses: docker/run-action@v3
        with:
          image: oqs-ci-alpine
          volumes:
            - ${{ github.workspace }}:/workspace
          working-directory: /workspace
          command: ./ci-test.sh  # 项目中的测试脚本路径

自定义环境配置

如需添加额外依赖或调整配置，可基于本镜像构建自定义镜像：

dockerfile
# 自定义Dockerfile
FROM oqs-ci-alpine

# 安装额外依赖（示例：添加Python测试工具）
RUN apk add --no-cache python3 py3-pip && pip3 install pytest

# 设置环境变量（示例：指定测试日志路径）
ENV OQS_TEST_LOG=/var/log/oqs-test.log

构建并使用自定义镜像：

bash
docker build -t custom-oqs-ci-alpine .
docker run --rm custom-oqs-ci-alpine pytest /path/to/tests