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 <<EOF
handlers=java.util.logging.ConsoleHandler
jenkins.level=FINEST
java.util.logging.ConsoleHandler.level=FINEST
EOF
$ docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS="-Djava.util.logging.config.file=/var/jenkins_home/log.properties" -v `pwd`/data:/var/jenkins_home jenkins
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是怎么工作的..尤其是要弄明白磁盘工作原理..
