h2oserver/h2o-ci

h2o CI构建基础镜像

镜像概述

本镜像为h2o/h2o项目提供CI（持续集成）环境下的标准化构建基础。h2o是一款高性能HTTP服务器，支持HTTP/1.x、HTTP/2及HTTP/3协议。该镜像集成了构建h2o所需的完整依赖环境，旨在确保开发团队在自动化构建流程中实现一致、可靠的编译结果。

核心功能与特性

• 标准化构建环境：预配置编译工具链、依赖库及系统组件，满足h2o源码构建的全部环境需求
• CI流程适配：针对持续集成场景优化，减少环境配置耗时，提升自动化构建效率
• 跨平台一致性：在不同CI服务（GitHub Actions、GitLab CI等）中提供统一的构建行为，避免"环境差异导致的构建失败"
• 版本同步：构建依赖随h2o项目迭代更新，通过misc/docker-ci目录维护最新配置

使用场景与适用范围

• h2o项目持续集成：集成到自动化构建流程，实现代码提交后的即时构建验证
• 开发环境一致性保障：为本地开发与CI构建提供相同环境，降低"本地可构建但CI失败"的问题
• 定制化构建支持：作为基础环境用于构建h2o衍生版本或包含自定义补丁的源码

使用方法与配置说明

获取与构建镜像

镜像构建脚本及Dockerfile位于h2o项目仓库的misc/docker-ci目录，构建步骤如下：

1. 克隆h2o源码仓库：

   bash
   git clone https://github.com/h2o/h2o.git
   cd h2o
   

2. 进入docker-ci目录并构建镜像：

   bash
   cd misc/docker-ci
   docker build -t h2o-ci-base .
   

CI环境集成示例

GitHub Actions配置

在项目根目录创建.github/workflows/build.yml：

yaml
name: H2O CI Build
on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Build CI base image
        run: |
          cd misc/docker-ci
          docker build -t h2o-ci-base .

      - name: Build H2O
        run: |
          docker run --rm -v $PWD:/h2o docker.xuanyuan.run/h2o-ci-base sh -c "cd /h2o && ./autogen.sh && ./configure && make -j$(nproc)"

GitLab CI配置

在项目根目录创建.gitlab-ci.yml：

yaml
stages:
  - build

build_h2o:
  stage: build
  image: docker.xuanyuan.run/docker:latest
  services:
    - docker:dind
  script:
    - cd misc/docker-ci
    - docker build -t h2o-ci-base .
    - docker run --rm -v $PWD/../../:/h2o h2o-ci-base sh -c "cd /h2o && ./autogen.sh && ./configure && make -j$(nproc)"

本地测试使用

在本地环境模拟CI构建流程：

bash
# 挂载本地源码目录并执行构建
docker run --rm -v /path/to/local/h2o:/h2o docker.xuanyuan.run/h2o-ci-base sh -c "cd /h2o && ./autogen.sh && ./configure && make"

注意事项

• 本镜像仅包含构建依赖，不提供运行时环境，构建产物需另行处理
• 建议定期同步misc/docker-ci目录内容，确保依赖环境与h2o最新版本兼容
• 多平台构建可能需要添加--platform参数（如docker build --platform linux/amd64 -t h2o-ci-base .）

相关资源

• 镜像配置源码：https://github.com/h2o/h2o/tree/master/misc/docker-ci
• h2o项目主页：https://github.com/h2o/h2o