閱讀(51.8k) 書簽贊(7) 我要糾錯(cuò)

Jenkins安裝

2018-08-23 10:26 更新

概述

本節(jié)是入門指南的一部分。它提供了許多平臺(tái)上基本的Jenkins配置的說明。但不涵蓋安裝Jenkins的全部注意事項(xiàng)或選項(xiàng)。

預(yù)安裝

這些僅僅是入門，有關(guān)因素的全面討論，請(qǐng)參見硬件建議討論。

系統(tǒng)要求

最小推薦配置：

Java 8（JRE或JDK）
256MB可用內(nèi)存
1GB +可用磁盤空間

推薦配置小團(tuán)隊(duì)：

Java 8
1GB +免費(fèi)內(nèi)存
50GB +可用磁盤空間

實(shí)驗(yàn)，分期或生產(chǎn)?

根據(jù)您的預(yù)期用例，Jenkins的配置將會(huì)有很大的不同。本節(jié)專門針對(duì)初步使用和實(shí)驗(yàn)。

獨(dú)立還是Servlet?

Jenkins可以使用自己的內(nèi)置Web服務(wù)器（Jetty）在自己的進(jìn)程中獨(dú)立運(yùn)行。它也可以作為現(xiàn)有框架中的一個(gè)servlet運(yùn)行，如Tomcat或Glassfish應(yīng)用程序服務(wù)器。本節(jié)專門針對(duì)獨(dú)立的安裝和執(zhí)行。

安裝

Unix / Linux

在基于Debian的發(fā)行版，如Ubuntu，您可以通過安裝Jenkins apt。最近的版本在一個(gè)apt存儲(chǔ)庫(kù)中可用。舊的但穩(wěn)定的LTS版本在這個(gè)apt存儲(chǔ)庫(kù)。

wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt-get update
sudo apt-get install jenkins

此包安裝將：

將Jenkins設(shè)置為啟動(dòng)時(shí)啟動(dòng)的守護(hù)程序。查看/etc/init.d/jenkins更多詳情。
創(chuàng)建一個(gè)jenkins用戶來運(yùn)行這個(gè)服務(wù)。
直接控制臺(tái)日志輸出到文件/var/log/jenkins/jenkins.log。如果您正在對(duì)Jenkins進(jìn)行故障排除，請(qǐng)檢查此文件
填充/etc/default/jenkins啟動(dòng)的配置參數(shù)，例如JENKINS_HOME
將Jenkins設(shè)置為偵聽端口8080.使用瀏覽器訪問此端口以開始配置。

如果你的/etc/init.d/jenkins文件無法啟動(dòng)Jenkins，編輯/etc/default/jenkins，以取代線 ----HTTP_PORT=8080----用----HTTP_PORT=8081---- 在這里，“8081”被選為但你可以把可用的其他端口

OpenIndiana Hipster

在運(yùn)行OpenIndiana Hipster的系統(tǒng)中， Jenkins可以使用圖像打包系統(tǒng)（IPS）安裝在本地或全局區(qū)域中。

免責(zé)聲明：該平臺(tái)尚未由Jenkins團(tuán)隊(duì)正式支持，您自己承擔(dān)風(fēng)險(xiǎn)。OpenIndiana Hipster團(tuán)隊(duì)維護(hù)本節(jié)中描述的包裝和整合，將通用工具捆綁jenkins.war 在該操作環(huán)境中。

對(duì)于將每周最新打包的版本作為獨(dú)立（Jetty）服務(wù)器運(yùn)行的常見情況，只需執(zhí)行：

pkg install jenkins
svcadm enable jenkins

獨(dú)立服務(wù)的常見包裝集成將：

創(chuàng)建一個(gè)jenkins用戶來運(yùn)行服務(wù)并擁有目錄結(jié)構(gòu)/var/lib/jenkins。
拉OpenJDK8等執(zhí)行Jenkins所需的jenkins-core-weekly軟件包，包括最新的軟件包jenkins.war。長(zhǎng)期支持（LTS）Jenkins發(fā)行版目前不支持基于OpenZFS的系統(tǒng)，因此目前不提供打包。
將Jenkins設(shè)置為SMF服務(wù)實(shí)例（svc:/network/http:jenkins），然后可以使用svcadm上面顯示的命令啟用Jenkins 。
設(shè)置Jenkins在8080端口上聽。
配置由SMF管理的日志輸出/var/svc/log/network-http:jenkins.log。

一旦Jenkins運(yùn)行，請(qǐng)咨詢log（/var/svc/log/network-http:jenkins.log）來檢索Jenkins初始設(shè)置生成的管理員密碼，通常會(huì)在那里找到/var/lib/jenkins/home/secrets/initialAdminPassword。然后導(dǎo)航到 localhost：8080以完成Jenkins實(shí)例的配置。

要更改服務(wù)的屬性，例如JENKINS_HOME Jetty Web服務(wù)器使用的環(huán)境變量或端口號(hào)，請(qǐng)使用該svccfg實(shí)用程序：

svccfg -s svc:/network/http:jenkins editprop
svcadm refresh svc:/network/http:jenkins

您還可以參考/lib/svc/manifest/network/jenkins-standalone.xml有關(guān)SMF服務(wù)的當(dāng)前支持的可調(diào)參數(shù)的更多詳細(xì)信息和注釋。請(qǐng)注意，jenkins由包裝創(chuàng)建的用戶帳戶是特權(quán)的，允許綁定到1024以下的端口號(hào)。

可以查詢給定版本的OpenIndiana的Jenkins相關(guān)軟件包的當(dāng)前狀態(tài)：

pkg info -r '*jenkins*'

可以通過更新整個(gè)操作環(huán)境pkg update，或?qū)ｉT為Jenkins核心軟件執(zhí)行升級(jí)，方法如下：

pkg update jenkins-core-weekly

更新軟件包的過程將重新啟動(dòng)當(dāng)前運(yùn)行的Jenkins進(jìn)程。如果需要，請(qǐng)確保在更新之前準(zhǔn)備關(guān)閉并完成所有正在運(yùn)行的程序。

Solaris, OmniOS, SmartOS和其他

一般來說，應(yīng)該足以安裝Java8和下載的 jenkins.war，并運(yùn)行它作為一個(gè)獨(dú)立的進(jìn)程或應(yīng)用服務(wù)器，比如Apache Tomcat。

一些注意事項(xiàng)使用：

Headless JVM和字體：對(duì)于OpenJDK構(gòu)建在最小化的腳本系統(tǒng)上，運(yùn)行Headless JVM可能會(huì)出現(xiàn)問題，因?yàn)镴enkins需要一些字體來渲染某些頁面。
ZFS相關(guān)的JVM崩潰：當(dāng)Jenkins在被檢測(cè)到的系統(tǒng)上運(yùn)行時(shí)SunOS，它會(huì)嘗試使用捆綁的加載集成高級(jí)ZFS功能libzfs.jar，將來自Java的調(diào)用映射到libzfs.so主機(jī)操作系統(tǒng)提供的本地例程。不幸的是，該庫(kù)是為了在操作系統(tǒng)中構(gòu)建和捆綁的二進(jìn)制實(shí)用程序，同時(shí)與它一起制作，并不是作為一個(gè)穩(wěn)定界面顯示給消費(fèi)者的。作為Solaris遺留的分支，包括ZFS以及隨后的OpenZFS計(jì)劃的發(fā)展，許多不同的二進(jìn)制功能簽名由不同的主機(jī)操作系統(tǒng)提供 - 當(dāng)Jenkins libzfs.jar調(diào)用錯(cuò)誤的簽名時(shí)，整個(gè)JVM進(jìn)程崩潰。jenkins.war自從每周發(fā)布2.55（至今尚未在任何LTS中）以來，提出并整合了一個(gè)解決方案。使管理員能夠配置哪些功能簽名應(yīng)該用于已知具有不同變體的每個(gè)功能，將其應(yīng)用于其應(yīng)用程序服務(wù)器初始化選項(xiàng)，然后運(yùn)行和更新通用而不需要進(jìn)一步的解決方法。有關(guān)更多詳細(xì)信息，請(qǐng)參閱 libzfs4j Git存儲(chǔ)庫(kù)，包括嘗試使用腳本并“鎖定”您特定分發(fā)所需的配置（特別是如果您的內(nèi)核更新帶來新的不兼容libzfs.so）。

另請(qǐng)注意，OpenZFS計(jì)劃的分支可能會(huì)在各種BSD，Linux和macOS發(fā)行版上提供ZFS。一旦Jenkins支持檢測(cè)ZFS功能，而不是依賴于SunOS檢查，則應(yīng)考慮上述與Jenkins集成ZFS的注意事項(xiàng)。

MACOS

要從網(wǎng)站安裝，使用一個(gè)包：

下載最新的軟件包
打開包裝并按照說明進(jìn)行操作

jenkins也可以使用brew進(jìn)行安裝：

安裝最新版本

brew install jenkins

安裝LTS版本

brew install jenkins

Windows

要從網(wǎng)站安裝，請(qǐng)使用安裝程序：

下載最新的軟件包
打開包裝并按照說明進(jìn)行操作

Docker

您必須在您的機(jī)器上正確安裝Docker。有關(guān)詳細(xì)信息，請(qǐng)參閱Docker安裝指南。

首先，從Docker存儲(chǔ)庫(kù)中取出官方的jenkins圖像。

docker pull jenkins/jenkins

接下來，使用此映像運(yùn)行容器并將數(shù)據(jù)目錄從容器映射到主機(jī); 例如在下面的示例中/var/jenkins_home，容器jenkins/從主機(jī)上的當(dāng)前路徑映射到目錄。jenkins8080接口也顯示在主機(jī)49001。

docker run -d -p 49001:8080 -v $PWD/jenkins:/var/jenkins_home -t jenkins/jenkins

安裝后(安裝向?qū)?

為Jenkins創(chuàng)建管理員用戶和密碼

Jenkins最初配置為在首次啟動(dòng)時(shí)安全。無需使用用戶名和密碼即可訪問Jenkins，并且開放端口有限。在Jenkins的初始運(yùn)行期間，生成安全令牌并將其打印在控制臺(tái)日志中：

************************************************** ***********

需要Jenkins初始設(shè)置。需要安全令牌才能繼續(xù)。
請(qǐng)使用以下安全令牌繼續(xù)安裝：

41d2b60b0e4cb5bf2025d33b21cb

************************************************** ***********