Jenkins安裝

概述

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

預安裝

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

系統(tǒng)要求

最小推薦配置：

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

推薦配置小團隊：

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

實驗，分期或生產(chǎn)?

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

獨立還是Servlet?

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

安裝

Unix / Linux

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

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設置為啟動時啟動的守護程序。查看/etc/init.d/jenkins更多詳情。
• 創(chuàng)建一個jenkins用戶來運行這個服務。
• 直接控制臺日志輸出到文件/var/log/jenkins/jenkins.log。如果您正在對Jenkins進行故障排除，請檢查此文件
• 填充/etc/default/jenkins啟動的配置參數(shù)，例如JENKINS_HOME
• 將Jenkins設置為偵聽端口8080.使用瀏覽器訪問此端口以開始配置。

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

OpenIndiana Hipster

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

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

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

pkg install jenkins
svcadm enable jenkins

獨立服務的常見包裝集成將：

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

一旦Jenkins運行，請咨詢log（/var/svc/log/network-http:jenkins.log）來檢索Jenkins初始設置生成的管理員密碼，通常會在那里找到/var/lib/jenkins/home/secrets/initialAdminPassword。然后導航到 localhost：8080以完成Jenkins實例的配置。

要更改服務的屬性，例如JENKINS_HOME Jetty Web服務器使用的環(huán)境變量或端口號，請使用該svccfg實用程序：

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

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

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

pkg info -r '*jenkins*'

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

pkg update jenkins-core-weekly

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

Solaris, OmniOS, SmartOS和其他

一般來說，應該足以安裝Java8和下載的 jenkins.war，并運行它作為一個獨立的進程或應用服務器，比如Apache Tomcat。

一些注意事項使用：

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

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

MACOS

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

• 下載最新的軟件包
• 打開包裝并按照說明進行操作

jenkins也可以使用brew進行安裝：

• 安裝最新版本

brew install jenkins

• 安裝LTS版本

brew install jenkins

Windows

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

• 下載最新的軟件包
• 打開包裝并按照說明進行操作

Docker

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

首先，從Docker存儲庫中取出官方的jenkins圖像。

docker pull jenkins/jenkins

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

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

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

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

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

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

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

41d2b60b0e4cb5bf2025d33b21cb

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

以上每個平臺的安裝說明包括可以找到此日志輸出的默認位置。首次打開Jenkins UI時，必須在“安裝向?qū)А敝休斎氪肆钆?。如果您跳過安裝向?qū)е械挠脩魟?chuàng)建步驟，此令牌也將作為用戶管理員的默認密碼。

初始插件安裝

安裝向?qū)н€將安裝此Jenkins服務器的初始插件。推薦的可用插件是基于最常見的用例。您可以在安裝向?qū)陂g自由添加更多內(nèi)容，然后再根據(jù)需要進行安裝。