Jenkins

Jenkins in Docker 官方文檔 簡單翻譯，水平有限 見諒

2017年07月18日22:23:47

如何使用這個鏡像

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

? Jenkins所有需要的數(shù)據(jù)都會存儲在容器內(nèi)部的/var/jenkins_home/目錄下，其中包括插件和配置信息。你也許會希望將這些配置信息持久化存儲在硬盤上（推薦這樣做）。

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

這將會存儲Jenkins數(shù)據(jù)在你的主機的your/home 目錄下。確保這個目錄是容器中Jenkins用戶能夠連通的，或者在docker run命令中使用-u some_other_user的啟動項。

你同樣可以使用容器內(nèi)部的磁盤來存儲這些數(shù)據(jù)。

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

這個名為myjenkins的容器有它自己的目錄（請確保Docker容器存在此磁盤并將它找出）。

備份你的數(shù)據(jù)

? 如果你已經(jīng)掛載了容器的/var/jenkins_home目錄的話，那么你可以在任何時候都很輕易的備份此文件目錄（掛載了/var/jenkins_home的外部主機文件目錄，也就是上文的your/home）。

? 這是我們高度推薦的備份方法，對待你的Jenkins_home目錄就像你的數(shù)據(jù)庫那樣—在Docker中你一般也會希望將數(shù)據(jù)庫掛載到磁盤上吧..

? 另外，如果你的目錄在容器之中，你同樣可以使用命令

$ docker cp $ID:/var/jenkins_home

來取出數(shù)據(jù)，或者一切其他的選項來發(fā)現(xiàn)磁盤數(shù)據(jù)在哪兒。note：在一些操作系統(tǒng)上的符號鏈接可能會轉(zhuǎn)譯（這個可能導(dǎo)致拒絕Jenkins）

? 需要更多關(guān)于Docker文檔的章節(jié)請訪問 Managing data in containers

設(shè)置執(zhí)行者的數(shù)量

? 你可以通過使用groovy腳本來設(shè)置Jenkins的master用戶執(zhí)行者的數(shù)量。雖然默認只有兩個執(zhí)行者，但是你可以繼承這個景象并且改變它的數(shù)量為你所希望的數(shù)量：

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

歸屬一些從節(jié)點

? 你雖然可以從主節(jié)點master進行執(zhí)行構(gòu)建命令，但是如果你也希望歸屬一些從節(jié)點的話：首先，請確保掛載了50000端口-p 50000:50000，這將在當(dāng)你需要連接從節(jié)點時候被使用到。

傳遞一些JVM參數(shù)

? 你可能需要定制JVM來運行Jenkins，典型的如傳遞系統(tǒng)參數(shù)或改為堆內(nèi)存設(shè)置。使用JAVA_OPTS環(huán)境變量來實現(xiàn)這個目標:

$ 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工具安裝者將安裝作為構(gòu)建的一個部分，同樣的，你可以創(chuàng)建你自己的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內(nèi)容，作為你所希望的安裝目標，它看起來可能是這樣的：

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

? 當(dāng)Jenkins的容器啟動時，它將會核查JENKINS_HOME在它提及的內(nèi)容中，并在在有必要的時候拷貝他們。它不會覆蓋這些文件，所以當(dāng)你要為了UI更新一些插件的話，他們不會在下一次恢復(fù)成原來的樣子。

更新

所有被Jenkins依賴的數(shù)據(jù)都放在容器內(nèi)的/var/jenkins_home目錄下，所以你如何升級，取決于你如何管理在/var/jenkins_home目錄下的這些數(shù)據(jù)。一般來說，你需要將它們拷貝出來，然后重新執(zhí)行docker pull來下載這個鏡像，這樣你就可以擁有最新版的Jenkins了。然后你就可以通過-v來重新掛載至/var/jenkins_home/目錄下，一切都會像你離開的那樣完好如初。

當(dāng)然最重要的，請確保你自己是明白docker是怎么工作的..尤其是要弄明白磁盤工作原理..