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.file
Java文件来配置。
例如:
$ 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是怎么工作的..尤其是要弄明白磁盘工作原理..