如何在Mac上配置Jenkins Agent？

Mac配置Jenkins Agent

环境准备

在开始配置Jenkins Agent之前，需要确保主节点（Master）和从节点（Agent）的Mac环境已经准备好，具体步骤如下：

1、安装Homebrew

Homebrew是Mac上常用的包管理工具，可以通过以下命令安装Homebrew：

“`bash

/bin/bash c "$(curl fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

“`

安装完成后，通过运行brew doctor检查是否有任何问题需要解决。

2、安装Java Development Kit (JDK)

Jenkins需要Java运行环境，建议安装OpenJDK，使用以下命令安装：

“`bash

brew install openjdk@17

“`

安装完成后，通过运行java version确认JDK是否安装成功。

3、安装Xcode及相关命令行工具

Xcode的命令行工具对于编译iOS项目是必需的，通过以下命令安装：

“`bash

xcodeselect install

“`

4、配置环境变量

配置Java和Gradle的环境变量，编辑~/.bash_profile或~/.zshrc文件，添加以下内容：

“`bash

export JAVA_HOME=/usr/local/opt/openjdk@17

export PATH=$PATH:$JAVA_HOME/bin

export GRADLE_HOME=/usr/local/opt/gradle/libexec

export PATH=$PATH:$GRADLE_HOME/bin

“`

保存并关闭文件后，运行source ~/.bash_profile或source ~/.zshrc使更改生效。

5、安装Jenkins主节点

使用Homebrew安装Jenkins LTS版本：

“`bash

brew install jenkinslts

“`

启动Jenkins服务：

“`bash

brew services start jenkinslts

“`

配置Jenkins主节点

1、访问Jenkins Web界面

打开浏览器，访问http://localhost:8080，使用初始管理员账号和密码登录Jenkins，初始密码可通过Jenkins的日志文件找到，路径为/Users/Shared/Jenkins/secrets/initialAdminPassword。

2、安装必要的插件

进入“Manage Jenkins” > “Manage Plugins”，在“Available”标签页中搜索并安装以下插件：

Git plugin

GitHub plugin

Pipeline plugin

SSH Slaves plugin

NodeJS plugin

安装完成后，重启Jenkins以应用更改。

3、创建凭据

进入“Manage Jenkins” > “Credentials” > “System”，点击“Add Credentials”，选择“Secret text”，添加一个用于访问代码仓库的凭据，GitHub的个人访问令牌。

配置Jenkins从节点

1、安装Jenkins Agent

在从节点Mac上，同样使用Homebrew安装Jenkins Agent：

“`bash

brew install jenkinsslave

“`

2、配置Jenkins Agent

在从节点上，创建一个名为jenkinsslave的目录，用于存放Jenkins Agent的相关文件：

“`bash

mkdir /Users/<yourusername>/jenkinsslave

cd /Users/<yourusername>/jenkinsslave

“`

将Jenkins Agent的jar包复制到该目录：

“`bash

cp /usr/local/Cellar/jenkinsslave/<version>/libexec/slave.jar .

“`

下载并安装Java Development Kit (JDK)：

“`bash

brew install openjdk@17

“`

配置环境变量，编辑~/.bash_profile或~/.zshrc文件，添加以下内容：

“`bash

export JAVA_HOME=/usr/local/opt/openjdk@17

export PATH=$PATH:$JAVA_HOME/bin

“`

保存并关闭文件后，运行source ~/.bash_profile或source ~/.zshrc使更改生效。

3、启动Jenkins Agent

使用以下命令启动Jenkins Agent：

“`bash

java jar slave.jar jnlpUrl http://<masterip>:8080/computer/<agentname>/slaveagent.jnlp secret <secrettoken> workDir /Users/<yourusername>/jenkinsslave/workspace

“`

其中<masterip>为主节点的IP地址，<agentname>为从节点的名称，<secrettoken>为主节点生成的秘钥。

常见问题及解决方案

1、Q1: Jenkins Agent无法连接到主节点？

A1: 确保Jenkins Agent的jnlpUrl和秘密令牌正确无误，检查防火墙设置，确保端口8080未被阻止，如果问题依旧，尝试重启主节点和从节点上的Jenkins服务。

2、Q2: Jenkins构建过程中出现权限不足问题？

A2: 确保从节点上的目录和文件具有适当的读写权限，可以使用以下命令修改权限：

“`bash

chmod R 755 /Users/<yourusername>/jenkinsslave

“`

确保Jenkins用户对相关目录具有操作权限。

通过上述步骤，可以在Mac上成功配置Jenkins及其从节点，实现自动化构建和持续集成任务。