Jenkins in Docker

Jenkins in Docker_第1张图片
Jenkins

Jenkins in Docker 官方文档 简单翻译,水平有限 见谅

2017年07月18日22:23:47

如何使用这个镜像

$ docker run -p 8080:8080 -p 50000:50000 jenkins

​ Jenkins所有需要的数据都会存储在容器内部的/var/jenkins_home/目录下,其中包括插件和配置信息。你也许会希望将这些配置信息持久化存储在硬盘上(推荐这样做)。

$ docker run -p 8080:8080 -p 50000:50000 -v /your/home:/var/jenkins_home jenkins

这将会存储Jenkins数据在你的主机的your/home 目录下。确保这个目录是容器中Jenkins用户能够连通的,或者在docker run命令中使用-u some_other_user的启动项。

你同样可以使用容器内部的磁盘来存储这些数据。

$ docker run --name myjenkins -p 8080:8080 -p 50000:50000 -v /var/jenkins_home jenkins

这个名为myjenkins的容器有它自己的目录(请确保Docker容器存在此磁盘并将它找出)。

备份你的数据

​ 如果你已经挂载了容器的/var/jenkins_home目录的话,那么你可以在任何时候都很轻易的备份此文件目录(挂载了/var/jenkins_home的外部主机文件目录,也就是上文的your/home)。

​ 这是我们高度推荐的备份方法,对待你的Jenkins_home目录就像你的数据库那样—在Docker中你一般也会希望将数据库挂载到磁盘上吧..

​ 另外,如果你的目录在容器之中,你同样可以使用命令

$ docker cp $ID:/var/jenkins_home

来取出数据,或者一切其他的选项来发现磁盘数据在哪儿。note:在一些操作系统上的符号链接可能会转译(这个可能导致拒绝Jenkins)

​ 需要更多关于Docker文档的章节请访问 Managing data in containers

设置执行者的数量

​ 你可以通过使用groovy脚本来设置Jenkins的master用户执行者的数量。虽然默认只有两个执行者,但是你可以继承这个景象并且改变它的数量为你所希望的数量:

executors.groovy

import jenkins.model.*
Jenkins.instance.setNumExecutors(5)
and Dockerfile

FROM jenkins
COPY executors.groovy /usr/share/jenkins/ref/init.groovy.d/executors.groovy

归属一些从节点

​ 你虽然可以从主节点master进行执行构建命令,但是如果你也希望归属一些从节点的话:首先,请确保挂载了50000端口-p 50000:50000,这将在当你需要连接从节点时候被使用到。

传递一些JVM参数

​ 你可能需要定制JVM来运行Jenkins,典型的如传递系统参数或改为堆内存设置。使用JAVA_OPTS环境变量来实现这个目标:

$ docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS=-Dhudson.footerURL=http://mycompany.com jenkins

配置日志

Jenkins的日志将通过一个properties文件和java.util.logging.config.fileJava文件来配置。

例如:

$ mkdir data
$ cat > data/log.properties <

Passing Jenkins launcher parameters

Arguments you pass to docker running the jenkins image are passed to jenkins launcher, so you can run for example :

$ docker run jenkins --version

This will dump Jenkins version, just like when you run jenkins as an executable war.

You also can define jenkins arguments as JENKINS_OPTS. This is useful to define a set of arguments to pass to jenkins launcher as you define a derived jenkins image based on the official one with some customized settings. The following sample Dockerfile uses this option to force use of HTTPS with a certificate included in the image

FROM jenkins:1.565.3

COPY https.pem /var/lib/jenkins/cert
COPY https.key /var/lib/jenkins/pk
ENV JENKINS_OPTS --httpPort=-1 --httpsPort=8083 --httpsCertificate=/var/lib/jenkins/cert --httpsPrivateKey=/var/lib/jenkins/pk
EXPOSE 8083

You can also change the default slave agent port for jenkins by defining JENKINS_SLAVE_AGENT_PORT in a sample Dockerfile.

FROM jenkins:1.565.3
ENV JENKINS_SLAVE_AGENT_PORT 50001

or as a parameter to docker,

$ docker run --name myjenkins -p 8080:8080 -p 50001:50001 --env JENKINS_SLAVE_AGENT_PORT=50001 jenkins

安装更多的工具

你可以作为root用户启动容器并且通过apt-get来安装软件,Jenkins工具安装者将安装作为构建的一个部分,同样的,你可以创建你自己的Dockerfile,例如:

FROM jenkins
# if we want to install via apt
USER root
RUN apt-get update && apt-get install -y ruby make more-thing-here
USER jenkins # drop back to the regular jenkins user - good practice

​ 在这个初始的镜像,你可以定制你自己的Jenkins实例通过脚本或者一些可添加的插件。为了这个目标,请使用/usr/share/jenkins/ref作为定义你默认JENKINS_HOME内容,作为你所希望的安装目标,它看起来可能是这样的:

FROM jenkins
COPY plugins.txt /usr/share/jenkins/ref/
COPY custom.groovy /usr/share/jenkins/ref/init.groovy.d/custom.groovy
RUN /usr/local/bin/plugins.sh /usr/share/jenkins/ref/plugins.txt

​ 当Jenkins的容器启动时,它将会核查JENKINS_HOME在它提及的内容中,并在在有必要的时候拷贝他们。它不会覆盖这些文件,所以当你要为了UI更新一些插件的话,他们不会在下一次恢复成原来的样子。

更新

所有被Jenkins依赖的数据都放在容器内的/var/jenkins_home目录下,所以你如何升级,取决于你如何管理在/var/jenkins_home目录下的这些数据。一般来说,你需要将它们拷贝出来,然后重新执行docker pull来下载这个镜像,这样你就可以拥有最新版的Jenkins了。然后你就可以通过-v来重新挂载至/var/jenkins_home/目录下,一切都会像你离开的那样完好如初。

当然最重要的,请确保你自己是明白docker是怎么工作的..尤其是要弄明白磁盘工作原理..

你可能感兴趣的:(Jenkins in Docker)