Docker 方式运行 jenkins

yzwj2004

　　原文地址：https://testerhome.com/topics/5798

简介说明
　　docker 是官方推荐的一种 jenkins 启动方式。

　　打开 jenkins 的官网，点击进入的是：

• https://hub.docker.com/r/jenkinsci/jenkins/
  

　　里面是 weekly>

• https://hub.docker.com/r/library/jenkins/
  

　　可以读一读底下的 Full Description ，有一些怎么使用 jenkins 镜像的说明

开始使用
　　拉取镜像
　　
docker pull jenkins:2.7.2
　　通用的启动方式,用 -p 参数指定暴露的端口,用 -v 参数挂载 jenkins_home
　　
docker run -p 8080:8080 -p 50000:50000 -v /your/home:/var/jenkins_home jenkins:2.7.2

• 8080 端口是访问 jenkins 网页的端口，如果你想在 80 端口访问，就改成 -p 80:8080
  
• 50000 端口与 slave 有关，参考 jnlp-slave 这个镜像，里面使用的 port。
  
• -v 参数挂载了宿主机一个指定目录到 /var/jenkins_home ，相当于设置了自定义的 JENKINS_HOME
  

jenkins 容器中添加 git, maven 等组件
　　一般我们使用jenkins的时候，需要用到 git, jdk, maven 等等的组件，在使用 docker-jenkins 的时候，可以用 -v 参数挂载到 /usr/bin 目录中，并不需要再在镜像中进行安装，也不需要基于jenkins镜像重新写dockerfile，保持镜像干净。

jenkins 容器中的公钥私钥
　　很常用的 jenkins 构建操作有：在 Execute shell 步骤中用 ssh 的方式远程登录上其他服务器，服务器上面的执行 shell 脚本。 ssh 方式需要用到的 public key 和 private key 也是可以用 -v 参数挂载到 /var/jenkins_home/.ssh 目录中。注意，这里不挂载到容器的 /root/.ssh 目录，因为整个 jenkins 容器是以 jenkins 用户来运行的。

在 jenkins 容器中调用 docker
　　有两种方式来调用 docker ：

• 通常用在 docker 单节点下，可以挂载 docker 到 jenkins 容器中，添加如下参数：
  -v /var/run/docker.sock:/var/run/docker.sock -v $(which docker):/usr/bin/docker
  
• 通常用在 docker 集群中，可以使用 jenkins 的 docker 插件，连接到 Docker server REST API（http://master-ip:2375）：
  
  
  
  • Docker plugin
    
  • Docker Commons Plugin
    
  • docker-build-step
    
  
  

简单的方式启动 Docker server REST API
　　在安装容器管理工具 shipyard 的文档中，发现可以用 shipyard/docker-proxy 这个镜像来暴露 2375 端口, 得到一个 Docker server REST API
　　

docker run \　　
-ti \
　　
-d \
　　
-p 2375:2375 \
　　
--hostname=$HOSTNAME \
　　
--restart=always \
　　
--name shipyard-proxy \
　　
-v /var/run/docker.sock:/var/run/docker.sock \
　　
-e PORT=2375 \
　　
shipyard/docker-proxy:latest
　　

　　

　　将 http://master-ip:2375 填入 jenkins 系统设置中的 Docker URL 就可以了（master-ip 是 docker server 的 ip）。


一个 jenkins 示例
　　我启动的 jenkins 里面包含 git, docker, 一份宿主机的公钥密钥, 自定义 JENKINS_HOME, 使用的启动命令如下：
　　

docker run \　　
-d -p 8080:8080 -p 50000:50000 \
　　
-v /home/docker/jenkins_home/:/var/jenkins_home \
　　
-v /var/run/docker.sock:/var/run/docker.sock \
　　
-v $(which docker):/usr/bin/docker \
　　
-v $(which git):/usr/bin/git \
　　
-v ~/.ssh:/var/jenkins_home/.ssh \
　　
--name=jenkins jenkins:2.7.2
　　

　　

　　在 jenkins 设置任务来测试挂载的 git, docker, 以及公钥密钥是否正常

• git clone 用来测试 git 和 密钥是否生效
  
• docker run hello-world 用来测试在宿主机运行的 docker 容器
  

　　构建任务的 Console Output：


　　git 使用密钥正常克隆了代码，docker 正常启动了容器

期待更多
　　以后再总结下 docker 方式的 jenkins slave，以及 jenkins 的 docker 插件，jenkins 的 Docker CI 流程等等。