macOS 安装/配置 Jenkins 小记

前阵子忙疯了，最近得空，来更新一下自己的博客 - 记一次 macOS 安装/配置 Jenkins 的过程，方便以后使用。

由于 macOS 新系统 Mojave 字体实在让人看着眼疼，昨天重新装回了 macOS High Sierra，并且机智的用 ThinBackup 备份了自己的项目配置，避免麻烦，配置上面的东西还是挺多的。

安装 JDK

去官网下载 JDK 安装就行，太简单，略。

安装 Jenkins

建议用 Homebrew 安装，方便配置环境，方便启动与关闭。

1
brew install jenkins

安装完成之后会默认启动，直接打开浏览器进入 http://localhost:8080，这时会让你输入初始密码，密码已经在终端显示出来，直接粘过来就行。接下来选择插件，由于我的配置已经在恢复文件中，所以这一步什么都不需要装，直接下一步，创建管理员账号，随便填，保存进入 Jenkins。

恢复配置

  1. 安装 ThinBackup 插件。
  2. 设置 Backup directory。
  3. 将备份文件夹放入第二步设置的路径。
  4. 进入 Restore 页面，勾选 Restore next build number file (if found in backup) 和 Restore plugins 两个选项。
  5. 点击 Restore。开始恢复。
  6. 备份完成后，终端关闭 Jenkins 并运行如下命令启动 Jenkins。
1

java -jar /usr/local/Cellar/jenkins/2.159/libexec/jenkins.war --httpPort=8080

2.159 为安装的 Jenkins 版本号，根据具体情况更改。

进行打包之前，请确认 Xcode 已经登录开发者账号并且相关证书齐全。

遇到的问题

1、执行 xcodebuild 命令报错：

xcode-select: error: tool ‘xcodebuild’ requires Xcode, but active developer directory

/Library/Developer/CommandLineTools

is a command line tools instance

原因如下：

This problem happens when xcode-select developer directory was pointing to

/Library/Developer/CommandLineTools

when a full regular Xcode was required (happens when CommandLineTools are installed after Xcode)

这里我们需要手动指定 Xcode，运行如下命令：

1
xcode-select -s /Applications/Xcode.app/Contents/Developer

2、.jenkins 文件夹下没有工作空间目录

在进行编译的时候，Jenkins 会首先去 git 上拉取最新的代码，并将代码保存到工作空间（workspace）文件夹中，但是项目安装并且恢复完毕后，并没有自动新建 workspace 文件夹，这里我们只需要手动的新建一个 workspace 文件夹即可。目录结构为 ~/.jenkins/workspace。