vmtrooper/jenkins

Jenkins-Django-Python3镜像文档

镜像概述

该镜像基于官方Jenkins镜像定制，专门优化以支持Django-on-Python3工作负载。通过预安装必要的PyPI包和Jenkins插件，简化Django项目的持续集成/持续部署（CI/CD）流程配置。

核心功能与特性

预安装PyPI包

• pymongo：MongoDB数据库驱动
• django==1.8.4：Django Web框架（1.8.4版本）
• django-jenkins：Django与Jenkins集成工具
• selenium：Web应用自动化测试工具
• coverage：代码覆盖率检测工具
• jinja2：模板引擎

预安装Jenkins插件

• git:2.4.0：Git版本控制集成
• credentials:1.22：凭证管理
• ssh-credentials:1.11：SSH凭证管理
• git-client:1.18.0：Git客户端支持
• scm-api:0.2：源码管理API
• mailer:1.15：邮件通知
• script-security:1.13：脚本安全控制
• junit:1.2：JUnit测试报告集成
• matrix-project:1.4：矩阵项目支持
• token-macro:1.11：令牌宏功能
• github-api:1.69：GitHub API集成
• plain-credentials:1.1：明文凭证管理
• github:1.14.2：GitHub集成
• javadoc:1.0：Javadoc文档生成
• maven-plugin:2.12.1：Maven构建支持
• violations:0.7.11：代码违规检测
• dashboard-view:2.9.7：仪表板视图
• cobertura:1.9.7：Cobertura代码覆盖率报告

使用场景

• Django-on-Python3项目的自动化构建、测试与部署
• 需要集成Git、GitHub的CI/CD流程
• 需生成代码覆盖率报告、测试报告的开发场景
• 多环境配置（矩阵项目）的自动化测试

使用方法与配置说明

基本部署

通过以下命令启动容器：

bash
docker run -d -p 8080:8080 -p 50000:50000 --name jenkins-django [镜像名称]

• -p 8080:8080：映射Jenkins Web界面端口
• -p 50000:50000：映射Jenkins代理通信端口
• --name jenkins-django：指定容器名称

访问Jenkins

1. 启动容器后，访问 http://localhost:8080
2. 首次登录需输入初始管理员密码，可通过以下命令获取：

   bash
   docker exec jenkins-django cat /var/jenkins_home/secrets/initialAdminPassword
   

3. 完成初始化配置（推荐安装推荐插件，已预安装核心插件）

数据持久化

为避免数据丢失，建议挂载Jenkins数据目录：

bash
docker run -d -p 8080:8080 -p 50000:50000 -v /本地路径/jenkins_home:/var/jenkins_home --name jenkins-django [镜像名称]

环境变量配置

可通过-e参数设置环境变量，例如：

bash
docker run -d -e JENKINS_OPTS="--httpPort=8081" -p 8081:8081 --name jenkins-django [镜像名称]

• JENKINS_OPTS：Jenkins启动参数（如修改端口、设置前缀等）

注意事项

• 确保宿主机端口8080和50000未被占用
• 持久化目录需设置正确权限（建议权限：chown -R 1000:1000 /本地路径/jenkins_home）
• Django版本固定为1.8.4，如需其他版本需自行扩展镜像