shimmi/jenkins

带有Blue Ocean并支持Docker中构建作业的Jenkins

全新的Jenkins体验。

支持的标签及对应的Dockerfile链接

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

基于官方Jenkins Docker镜像构建。此镜像增加了在Jenkins容器内运行Docker CLI的支持，并允许使用声明式管道在Docker中构建作业。捆绑了Blue Ocean。

关于镜像的说明

当https://github.com/Shimmi/docker-jenkins%E4%BB%93%E5%BA%93%E6%9C%89%E4%BB%BB%E4%BD%95%E6%9B%B4%E6%94%B9%E6%8E%A8%E9%80%81%E5%92%8C/%E6%88%96%E5%8E%9F%E5%A7%8BJenkins%E9%95%9C%E5%83%8F%E6%9B%B4%E6%96%B0%E6%97%B6%EF%BC%8C%E6%AD%A4%E9%95%9C%E5%83%8F%E4%BC%9A%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E3%80%82

什么是Pipeline？

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

什么是声明式Pipeline？

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

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

声明式Pipeline引入了postBuild部分，使得在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设计，同时兼容自由风格作业，Blue Ocean为团队中的每个成员减少混乱并提高清晰度。

!https://raw.githubusercontent.com/Shimmi/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%E3%80%82

升级

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

使用docker run

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

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 shimmi/jenkins

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

例如，在Windows上：

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 shimmi/jenkins

资源

• https://github.com/jenkinsci/pipeline-model-definition-plugin/wiki/getting%20started
• Jenkins手册 - Pipeline
• 宣布Blue Ocean测试版、声明式Pipeline和Pipeline编辑器 - Jenkins博客
• Jenkins - Blue Ocean