stakater/jenkins-kubernetes

Jenkins Docker镜像文档

镜像概述

本镜像为自定义Jenkins镜像，基于https://github.com/openshift/jenkins%E5%92%8Chttps://github.com/jenkinsci/docker/tree/alpine%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%93%E9%97%A8%E4%BC%98%E5%8C%96%E4%BB%A5%E9%80%82%E5%BA%94Kubernetes%E7%8E%AF%E5%A2%83%E8%BF%90%E8%A1%8C%E3%80%82%E6%8F%90%E4%BE%9B%E5%AE%8C%E6%95%B4%E7%9A%84Jenkins%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%94%AF%E6%8C%81%E6%8F%92%E4%BB%B6%E7%AE%A1%E7%90%86%E3%80%81%E6%9D%83%E9%99%90%E6%8E%A7%E5%88%B6%E5%92%8CKubernetes%E9%9B%86%E6%88%90%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%AE%B9%E5%99%A8%E5%8C%96%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E6%8C%81%E7%BB%AD%E9%9B%86%E6%88%90/%E6%8C%81%E7%BB%AD%E9%83%A8%E7%BD%B2(CI/CD)%E6%B5%81%E7%A8%8B%E3%80%82

核心功能与特性

• Kubernetes兼容性：移除OpenShift特定组件，优化Kubernetes环境运行
• 安全运行：以非root用户(jenkins:1000)运行，避免权限风险
• 插件管理：支持通过install-plugins.sh安装指定插件，核心插件预配置
• 配置灵活性：Kubernetes环境中可通过ConfigMap覆盖镜像默认配置
• 版本更新：基于最新Jenkins 2版本构建，无嵌入式插件，按需安装

使用场景

• Kubernetes集群中的CI/CD流水线管理
• 容器化应用的自动化构建、测试与部署
• 需要自定义插件和配置的Jenkins部署
• 多团队共享的Jenkins服务

使用方法

构建镜像

bash
docker build -t stakater/jenkins2 .

运行容器

基本运行：

bash
docker run -it --rm stakater/jenkins2

带交互shell：

bash
docker run -it --init --rm stakater/jenkins2:latest /bin/sh

--init参数用于进程清理，支持CTRL+C正常退出

持久化存储

推荐挂载Jenkins数据目录：

bash
docker run -d -v /host/path/jenkins_home:/var/jenkins_home stakater/jenkins2

配置说明

环境变量

• HOME=/var/jenkins_home：Jenkins主目录
• JENKINS_HOME=/var/jenkins_home：Jenkins数据存储路径

目录结构

Jenkins主目录文件列表：

-rw-r--r--  1 jenkins jenkins 1684 Nov 17 21:17 config.xml
lrwxrwxrwx  1 jenkins jenkins   21 Nov 17 21:17 config.xml.tpl -> ..data/config.xml.tpl
-rw-r--r--  1 jenkins jenkins 1031 Nov 17 21:17 copy_reference_file.log
-rw-r--r--  1 jenkins jenkins  156 Nov 17 21:17 hudson.model.UpdateCenter.xml
...
drwxr-xr-x  2 jenkins jenkins 4096 Nov 17 21:17 plugins
...

用户与权限

容器内运行用户信息：

bash
bash-4.3$ id
uid=1000(jenkins) gid=1000(jenkins) groups=1000(jenkins)

插件管理

必要插件

• openshiftsync：Kubernetes流水线插件的直接依赖，支持Kubernetes集成测试

插件安装

• 预定义插件：通过install-plugins.sh从列表安装指定版本插件
• 自定义插件：需通过assemble.sh脚本第25行配置的文件夹复制到镜像中
• 插件存储路径：/usr/share/jenkins/ref/plugins（初始化时复制到JENKINS_HOME）

注意事项

1. 配置文件依赖：Jenkins启动依赖config.xml，文件损坏会导致启动失败
2. 插件要求：Jenkins 2版本无嵌入式插件，插件目录必须有必要插件，否则启动失败
3. 权限处理：Kubernetes环境中无需使用fix-permissions.sh，已通过用户权限控制
4. 配置覆盖：Kubernetes环境中，重要配置通过ConfigMap提供，覆盖镜像默认配置
5. 启动流程：入口脚本为run.sh，kube-slave-common.sh负责K8s插件配置

参考资料

• https://github.com/jenkinsci/docker
• https://hub.docker.com/r/jenkins/jenkins/
• https://github.com/openshift/jenkins
• Jenkins管理文档