616slayer616/jenkins

Jenkins with Blue Ocean 及 Docker 作业构建支持

全新的 Jenkins 体验。

支持的标签及对应 Dockerfile 链接

• lts https://github.com/616slayer616/docker-jenkins/blob/master/lts/Dockerfile - 长期支持版本
• latest https://github.com/616slayer616/docker-jenkins/blob/master/latest/Dockerfile - 每周更新版本

http://dockeri.co/image/616slayer616/jenkins](https://registry.hub.docker.com/616slayer616/jenkins/)

基于 https://store.docker.com/community/images/jenkins/jenkins "官方镜像"构建。此镜像添加了在 Jenkins 容器内运行 Docker CLI 的支持，并允许使用声明式流水线在 Docker 中构建作业。同时捆绑了 https://jenkins.io/projects/blueocean/%E3%80%82

关于镜像的说明

当 https://github.com/616slayer616/docker-jenkins 仓库有变更推送和/或 https://store.docker.com/community/images/jenkinsci/jenkins 更新时，此镜像会自动构建。

什么是 Pipeline？

Pipeline 是一系列步骤的集合，用于编排构建、测试和部署应用所需的工作。Pipeline 在名为 Jenkinsfile 的文件中定义，该文件存储在项目源代码仓库的根目录。

什么是声明式 Pipeline？

声明式 Pipeline 与 Blue Ocean 一同在 2016 年 9 月 14 日的 Jenkins World 上发布，是一种配置而非编写脚本的 Pipeline 新方式。

声明式 Pipeline 中的 Docker 支持允许你在单个仓库中版本化应用代码、Jenkins Pipeline 配置以及 Pipeline 运行环境。这是一个非常强大的组合。

声明式 Pipeline 引入了 postBuild 部分，可轻松在 Pipeline 结束时条件性地运行操作，无需 Pipeline 脚本中复杂的 try...catch 逻辑。

声明式 Pipeline 示例

pipeline {
  agent { docker 'php' }
  stages {
    stage('build') {
      steps {
        sh 'php --version'    
      }
    }
  }
}

https://github.com/jenkinsci/pipeline-model-definition-plugin/wiki/getting%20started#quick-start%E3%80%82

什么是 Blue Ocean？

Blue Ocean 是一个重新思考 Jenkins 用户体验的新项目。专为 Jenkins Pipeline 设计，同时兼容 Freestyle 作业，Blue Ocean 减少了杂乱，为团队每位成员提高了清晰度。

!https://raw.githubusercontent.com/616slayer616/docker-jenkins/master/docs/images/blue-ocean/pipeline-activity.png "Blue Ocean"

使用方法

有关 Jenkins Docker 镜像的其他配置和使用，请参考 https://github.com/jenkinsci/docker/blob/master/README.md%E3%80%82

使用 docker-compose

1. 克隆仓库或仅下载 docker-compose.yml 文件。
2. 进入该文件夹并运行 docker-compose up -d。

解决 "docker.sock is not a valid Windows path" 错误

如果遇到此错误（Docker 18 及以上版本），请将环境变量 COMPOSE_CONVERT_WINDOWS_PATHS 设置为 true。

例如，在 Powershell 中：$env:COMPOSE_CONVERT_WINDOWS_PATHS=1。

更多信息请参见 https://github.com/docker/compose/issues/4240 问题。

升级

1. 准备 Jenkins 关闭（管理 Jenkins > 准备关闭）。
2. 进入 docker-compose.yml 所在文件夹。
3. 再次运行 docker-compose up -d 以使用新镜像重新创建容器并作为守护进程运行。

使用 docker run

也可以不克隆仓库，直接使用 docker run 命令运行镜像。

bash
docker run -d --name my_jenkins -v /your/home/jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock -p 8080:8080 --group-add docker 616slayer616/jenkins

请根据需要修改 /your/home/jenkins_home 路径。

例如，在 Windows 上：

bash
docker run -d --name my_jenkins -v /C/Users/<your-profile>/Documents/docker/jenkins/jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock -p 8080:8080  --group-add docker 616slayer616/jenkins

资源

• https://github.com/jenkinsci/pipeline-model-definition-plugin/wiki/getting%20started
• https://jenkins.io/doc/book/pipeline/
• https://jenkins.io/blog/2016/09/19/blueocean-beta-declarative-pipeline-pipeline-editor/
• https://jenkins.io/projects/blueocean/