前言:本文主要介绍一下Mac上安装Jenkins的流程。
一、安装Jenkins依赖的java环境
安装Jenkins需要依赖java环境,终端输入以下命令
java -version
如果输出为java version "19.0.1"
,则说明有对应的java环境。
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)
如果为下面的输出,则说明没有java环境。
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.
从官网下载需要的JDK版本
http://www.oracle.com/technetwork/java/javase/downloads/
二、通过HomeBrew安装Jenkins
1、检查是否有安装HomeBrew
brew -v
若输出为Homebrew 3.5.9,则说明已安装。
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)
若没有安装,则可以通过以下命令安装。
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Homebrew的安装可以参考:Homebrew工具使用
2、输入以下命令安装Jenkins
brew install jenkins
若为以下输出,则说明安装成功
==> 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`).
也可以通过brew list
命令来查看列表中是否存在jenkins来判断是否安装了Jenkins。
如果安装 Jenkins 过程中出现了以下错误,是因为 openjdk@17 没有安装成功。
==> 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
可以通过brew工具单独安装 openjdk@17。
brew install openjdk@17
3、启动Jenkins
Jenkins安装成功之后,通过以下命令来启动Jenkins
brew services start jenkins
输出为以下,则说明已经启动Jenkins。
Successfully started `jenkins` (label: homebrew.mxcl.jenkins)
以下命令为重新启动
brew services restart jenkins
输出为
Stopping `jenkins`... (might take a while)
==> Successfully stopped `jenkins` (label: homebrew.mxcl.jenkins)
==> Successfully started `jenkins` (label: homebrew.mxcl.jenkins)
三、通过浏览器打开和配置Jenkins
1、浏览器打开Jenkins
Jenkins启动之后,在浏览器输入http://localhost:8080地址来打开Jenkins。会出现以下界面:
(如果打开发现是拒绝访问,请检查.zprofile隐藏文件中的配置,很重要!!!检查是否自动添加了 eval $(/usr/local/Homebrew/bin/brew shellenv) #ckbrew
)
打开上面的红色的文件路径,会获得管理员密码输入即可。同时要把密码备份下来。
open /Users/wxq/.jenkins/secrets/initialAdminPassword
输入密码后,会进入到配置页面,如下:
2、安装插件
点击上图中第一个安装建议的插件,需要比较长的时间来等待安装完成。
有时候会出现安装失败的情况,可以重试重新安装。
3、创建管理员账户
插件安装完后会进入到创建管理员用户的界面:
注册管理员信息后,会进入实例配置,输入默认的端口即可。
然后Jenkins 就安装完成了,如下
打开之后界面如下
以上就完成了Mac端Jenkins的安装。
提示:通过 url 重启和关闭Jenkins
1、重启Jenkins http://localhost:8080/restart
2、关闭Jenkins http://localhost:8080/exit
四、使用IP访问 Jenkins
使用brew安装Jenkins会避免很多其他安装方式产生的用户权限问题,但是会将httpListenAddress默认设置为127.0.0.1,这样我们虽然可以在本地用localhost:8080访问,但是本机和局域网均无法用ip访问。
解决办法为修改两个路径下的plist配置。(mac显示隐藏文件夹快捷键 Command + Shift + .)
~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
/usr/local/opt/jenkins/homebrew.mxcl.jenkins.plist
如果第二路径下没有的话,可以去看以下路径plist配置
/opt/homebrew/opt/jenkins/homebrew.mxcl.jenkins.plist
将上面两个plist中的httpListenAddress后的ip地址,修改为本机IP或者0.0.0.0即可。
上述两个配置文件修改完后,重启Jenkins服务。再不行,则重启电脑。
以上