Docker 方式运行 jenkins

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

简介说明

docker 是官方推荐的一种 jenkins 启动方式。

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

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

里面是 weekly releases 的镜像，对于官方推荐的 2.7.2 版本，是需要到 docker 官方仓库里面去找：

• 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 ：

1. 通常用在 docker 单节点下，可以挂载 docker 到 jenkins 容器中，添加如下参数： -v /var/run/docker.sock:/var/run/docker.sock -v $(which docker):/usr/bin/docker
2. 通常用在 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 流程等等。