
前言:本文主要介紹一下Mac上安裝Jenkins的流程。
一、安裝Jenkins依賴(lài)的java環(huán)境
安裝Jenkins需要依賴(lài)java環(huán)境,終端輸入以下命令
java -version
如果輸出為java version "19.0.1",則說(shuō)明有對(duì)應(yīng)的java環(huán)境。
java version "19.0.1" 2022-10-18
Java(TM) SE Runtime Environment (build 19.0.1+10-21)
Java HotSpot(TM) 64-Bit Server VM (build 19.0.1+10-21, mixed mode, sharing)
如果為下面的輸出,則說(shuō)明沒(méi)有java環(huán)境。
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.
從官網(wǎng)下載需要的JDK版本
http://www.oracle.com/technetwork/java/javase/downloads/
二、通過(guò)HomeBrew安裝Jenkins
1、檢查是否有安裝HomeBrew
brew -v
若輸出為Homebrew 3.5.9,則說(shuō)明已安裝。
Homebrew 3.5.9
Homebrew/homebrew-core (git revision 96a45c178c0; last commit 2022-08-21)
Homebrew/homebrew-cask (git revision b7307f063b; last commit 2022-08-21)
若沒(méi)有安裝,則可以通過(guò)以下命令安裝。
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Homebrew的安裝可以參考:Homebrew工具使用
2、輸入以下命令安裝Jenkins
brew install jenkins
若為以下輸出,則說(shuō)明安裝成功
==> Downloading https://mirrors.ustc.edu.cn/homebrew-bottles/bottles/jenkins-2.364.all.bottle.tar.gz
curl: (22) The requested URL returned error: 404
Warning: Bottle missing, falling back to the default domain...
==> Downloading https://ghcr.io/v2/homebrew/core/jenkins/manifests/2.364
Already downloaded: /Users/wxq/Library/Caches/Homebrew/downloads/b07e80308ed019d461a0e8ce51ed6a6518a907455579fe947eb7ad9e40ad4a42--jenkins-2.364.bottle_manifest.json
==> Downloading https://ghcr.io/v2/homebrew/core/jenkins/blobs/sha256:2acfa0f97794be58932efeae79e09e5e438575d5cd4c777beab3c3e922084a3c
Already downloaded: /Users/wxq/Library/Caches/Homebrew/downloads/81e5ff41ea598236424cc5785df0f7bdd10ccb6b7ec9404a9f9c490c304f9530--jenkins--2.364.all.bottle.tar.gz
==> Pouring jenkins--2.364.all.bottle.tar.gz
==> Caveats
Note: When using launchctl the port will be 8080.
To restart jenkins after an upgrade:
brew services restart jenkins
Or, if you don't want/need a background service you can just run:
/usr/local/opt/jenkins/bin/jenkins --httpListenAddress=127.0.0.1 --httpPort=8080
==> Summary
?? /usr/local/Cellar/jenkins/2.364: 8 files, 92.4MB
==> Running `brew cleanup jenkins`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).
也可以通過(guò)brew list命令來(lái)查看列表中是否存在jenkins來(lái)判斷是否安裝了Jenkins。
如果安裝 Jenkins 過(guò)程中出現(xiàn)了以下錯(cuò)誤,是因?yàn)?openjdk@17 沒(méi)有安裝成功。
==> Installing dependencies for jenkins: openjdk@17
==> Installing jenkins dependency: openjdk@17
==> Pouring openjdk@17-17.0.4.monterey.bottle.tar.gz
Error: No such file or directory @ rb_sysopen - /Users/wxq/Library/Caches/Homebrew/downloads/7efb23ec153e02be76dbc5768a3ef3aff8c4fdd1bf73a854f7274f77c6844a33--openjdk@17-17.0.4.monterey.bottle.tar.gz
可以通過(guò)brew工具單獨(dú)安裝 openjdk@17。
brew install openjdk@17
3、啟動(dòng)Jenkins
Jenkins安裝成功之后,通過(guò)以下命令來(lái)啟動(dòng)Jenkins
brew services start jenkins
輸出為以下,則說(shuō)明已經(jīng)啟動(dòng)Jenkins。
Successfully started `jenkins` (label: homebrew.mxcl.jenkins)
以下命令為重新啟動(dòng)
brew services restart jenkins
輸出為
Stopping `jenkins`... (might take a while)
==> Successfully stopped `jenkins` (label: homebrew.mxcl.jenkins)
==> Successfully started `jenkins` (label: homebrew.mxcl.jenkins)
三、通過(guò)瀏覽器打開(kāi)和配置Jenkins
1、瀏覽器打開(kāi)Jenkins
Jenkins啟動(dòng)之后,在瀏覽器輸入http://localhost:8080地址來(lái)打開(kāi)Jenkins。會(huì)出現(xiàn)以下界面:
(如果打開(kāi)發(fā)現(xiàn)是拒絕訪問(wèn),請(qǐng)檢查.zprofile隱藏文件中的配置,很重要?。?!檢查是否自動(dòng)添加了 eval $(/usr/local/Homebrew/bin/brew shellenv) #ckbrew)

打開(kāi)上面的紅色的文件路徑,會(huì)獲得管理員密碼輸入即可。同時(shí)要把密碼備份下來(lái)。
open /Users/wxq/.jenkins/secrets/initialAdminPassword
輸入密碼后,會(huì)進(jìn)入到配置頁(yè)面,如下:

2、安裝插件
點(diǎn)擊上圖中第一個(gè)安裝建議的插件,需要比較長(zhǎng)的時(shí)間來(lái)等待安裝完成。

有時(shí)候會(huì)出現(xiàn)安裝失敗的情況,可以重試重新安裝。

3、創(chuàng)建管理員賬戶(hù)
插件安裝完后會(huì)進(jìn)入到創(chuàng)建管理員用戶(hù)的界面:

注冊(cè)管理員信息后,會(huì)進(jìn)入實(shí)例配置,輸入默認(rèn)的端口即可。

然后Jenkins 就安裝完成了,如下

打開(kāi)之后界面如下

以上就完成了Mac端Jenkins的安裝。
提示:通過(guò) url 重啟和關(guān)閉Jenkins
1、重啟Jenkins http://localhost:8080/restart
2、關(guān)閉Jenkins http://localhost:8080/exit
四、使用IP訪問(wèn) Jenkins
使用brew安裝Jenkins會(huì)避免很多其他安裝方式產(chǎn)生的用戶(hù)權(quán)限問(wèn)題,但是會(huì)將httpListenAddress默認(rèn)設(shè)置為127.0.0.1,這樣我們雖然可以在本地用localhost:8080訪問(wèn),但是本機(jī)和局域網(wǎng)均無(wú)法用ip訪問(wèn)。
解決辦法為修改兩個(gè)路徑下的plist配置。(mac顯示隱藏文件夾快捷鍵 Command + Shift + .)
~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
/usr/local/opt/jenkins/homebrew.mxcl.jenkins.plist
如果第二路徑下沒(méi)有的話,可以去看以下路徑plist配置
/opt/homebrew/opt/jenkins/homebrew.mxcl.jenkins.plist
將上面兩個(gè)plist中的httpListenAddress后的ip地址,修改為本機(jī)IP或者0.0.0.0即可。
上述兩個(gè)配置文件修改完后,重啟Jenkins服務(wù)。再不行,則重啟電腦。

以上