apache/hive-ci-jenkins

Apache Hive CI Jenkins 镜像文档

1. 镜像概述

本镜像为Apache Hive项目量身定制，基于Jenkins构建，集成了Hive CI流程所需的工具链和配置，旨在简化Hive开发团队的持续集成流程。通过标准化CI环境，减少环境配置差异带来的问题，提升Hive代码构建、测试和部署的自动化水平与执行效率。

2. 核心功能与特性

• 预配置Hive CI工具链：内置Maven、Git、JDK、Hadoop客户端等Hive构建测试必需工具，无需额外安装
• 标准化CI流程模板：包含Hive项目常见CI流程配置（如单元测试、集成测试、代码质量检查），支持快速启用
• Hive生态集成：优化与Hive源码仓库、测试环境及构建产物仓库的对接能力
• 轻量级部署：基于Alpine或精简基础镜像构建，平衡功能与资源占用
• 可扩展架构：支持添加自定义插件、构建代理及第三方服务集成（如SonarQube代码分析）

3. 使用场景与适用范围

• Hive开发团队进行日常代码提交后的自动化构建与测试
• Hive版本发布前的集成测试与构建验证
• Hive补丁（Patch）的自动化验证流程
• 需要标准化Hive CI环境的开发或测试团队

4. 使用方法与配置说明

4.1 快速启动

通过以下命令快速启动容器：

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v hive-jenkins-data:/var/jenkins_home \
  --name hive-ci-jenkins \
  apache/hive-ci-jenkins:latest

• -p 8080:8080：映射Jenkins Web控制台端口
• -p 50000:50000：映射Jenkins代理通信端口（用于分布式构建）
• -v hive-jenkins-data:/var/jenkins_home：挂载数据卷持久化Jenkins配置与构建数据

4.2 首次访问与初始化

1. 容器启动后，通过http://<host-ip>:8080访问Jenkins控制台
2. 获取初始管理员密码：

   bash
   docker exec -it hive-ci-jenkins cat /var/jenkins_home/secrets/initialAdminPassword
   

3. 登录后，系统将自动加载Hive CI推荐插件与流程模板，完成初始化

4.3 环境变量配置

可通过环境变量自定义镜像行为，常用变量如下：

示例（指定管理员密码与Hive分支）：

bash
docker run -d \
  -p 8080:8080 \
  -e JENKINS_ADMIN_PASSWORD=hiveci123 \
  -e HIVE_DEFAULT_BRANCH=branch-3.1 \
  -v hive-jenkins-data:/var/jenkins_home \
  apache/hive-ci-jenkins:latest

4.4 持久化与数据管理

• 核心数据目录：/var/jenkins_home（包含配置、插件、工作空间等），推荐通过数据卷持久化
• 构建产物存储：可通过Jenkins配置对接外部存储（如S3、NFS），或挂载额外数据卷至/var/jenkins_home/workspace

4.5 自定义CI流程

1. 登录Jenkins控制台，进入"新建任务"
2. 选择"Hive CI流程模板"（预配置）
3. 根据需求调整参数（如源码分支、测试套件、构建目标）
4. 保存后即可触发自动化构建流程

5. 注意事项

• 首次启动时插件加载可能需要5-10分钟，取决于网络环境
• 建议为容器分配至少2GB内存，避免构建过程中资源不足
• 生产环境使用时，需通过环境变量JENKINS_ADMIN_PASSWORD设置强密码，并启用HTTPS加密（可通过反向代理实现）
• 定期备份/var/jenkins_home数据卷，防止配置与构建历史丢失