基于Docker部署Jenkins：如何将本机配置为Jenkins代理节点？

我之前刚好处理过几乎一模一样的场景！既不想放弃Docker部署Jenkins的便利性，又要用上Mac主机的iOS构建能力，下面是亲测可行的配置步骤：

1. 先给Mac mini主机准备Jenkins代理环境 #

• 安装兼容版Java：Jenkins代理需要Java环境，版本要和你Docker里的Jenkins匹配（比如Jenkins 2.400+对应Java 11/17），直接从Oracle或OpenJDK官网下载安装就行。
• 获取代理启动指令：在Docker里的Jenkins后台，依次进入Manage Jenkins → Manage Nodes and Clouds → New Node：
  • 给节点起个好认的名字（比如mac-mini-ios-builder），选择Permanent Agent
  • 设置远程工作目录（比如/Users/你的用户名/jenkins-agent，提前在Mac上建好这个文件夹）
  • 启动方式选Launch agent via Java Web Start，复制下方的完整启动命令（或者直接下载agent.jar到刚才的工作目录里）

2. 确保Docker Jenkins和Mac主机的网络连通 #

• 启动Jenkins容器时，一定要同时映射代理通信端口50000，完整启动命令大概是：

  docker run -d -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts
  

• 代理启动命令里的jnlpUrl要换成Mac主机的IP（比如http://192.168.xx.xx:8080/computer/mac-mini-ios-builder/slave-agent.jnlp），不能用Docker容器的内部IP，否则Mac主机连不上。
• 检查Mac防火墙：允许Java进程访问8080和50000端口，避免被拦截。

3. 配置Mac代理节点的iOS构建权限 #

• 环境变量配置：在Jenkins节点配置页的Node Properties里，添加环境变量PATH，把Xcode命令行工具路径加进去，比如：

  /Applications/Xcode.app/Contents/Developer/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin
  

• Xcode初始化：手动打开一次Xcode，同意许可协议；或者在Mac终端运行sudo xcodebuild -license accept完成自动授权。
• 钥匙串权限：iOS构建需要签名，给运行代理的用户解锁钥匙串的权限，可以在代理启动脚本里加一行（密码用Jenkins凭证管理存储更安全）：

  security unlock-keychain -p 你的钥匙串密码 ~/Library/Keychains/login.keychain-db
  

4. 流水线里指定iOS构建用Mac代理 #

在Jenkinsfile里通过label指定阶段使用Mac代理，其他阶段继续用Docker代理，示例如下：

pipeline {
    agent none
    stages {
        stage('构建后端') {
            agent { docker { image 'maven:3.8.6' } }
            steps {
                sh 'mvn clean package'
            }
        }
        stage('构建iOS') {
            agent { label 'mac-mini-ios-builder' }
            steps {
                sh 'xcodebuild -workspace YourApp.xcworkspace -scheme YourScheme -configuration Release build'
                // 后续打包、上传等步骤
            }
        }
    }
}

额外优化：让Mac代理开机自启 #

如果希望Mac重启后代理自动连接Jenkins，可以做个LaunchAgent：

1. 在~/Library/LaunchAgents/下创建com.jenkins.agent.plist文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.jenkins.agent</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/java</string>
        <string>-jar</string>
        <string>/Users/你的用户名/jenkins-agent/agent.jar</string>
        <string>-jnlpUrl</string>
        <string>http://你的MacIP:8080/computer/mac-mini-ios-builder/slave-agent.jnlp</string>
        <string>-secret</string>
        <string>你的代理密钥</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

2. 终端运行launchctl load ~/Library/LaunchAgents/com.jenkins.agent.plist启用自启。

内容的提问来源于stack exchange，提问作者Thomas Stubbe