Debian环境下如何配置Jenkins代理

1. 环境准备：安装Java环境
在Debian系统的所有节点（主节点+代理节点）上，需先安装Jenkins依赖的Java运行环境（推荐OpenJDK 11）。执行以下命令：

sudo apt update
sudo apt install openjdk-11-jdk
# 验证Java安装是否成功
java -version

确保输出显示Java版本为11或更高，否则Jenkins无法正常运行。

2. 配置Jenkins主节点
在主节点上完成Jenkins基础安装与环境配置：

• 添加Jenkins官方APT源：

  wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
  sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ >
       /etc/apt/sources.list.d/jenkins.list'
  sudo apt update
  

• 安装Jenkins：

  sudo apt install jenkins
  

• 启动Jenkins服务：

  sudo systemctl enable jenkins  # 设置开机自启
  sudo systemctl start jenkins   # 立即启动服务
  

• 完成初始设置：
  打开浏览器访问http://< 主节点IP> :8080，输入/var/lib/jenkins/secrets/initialAdminPassword文件中的初始密码，完成管理员账号创建及插件安装（默认推荐插件即可）。

3. 在主节点上创建Jenkins代理节点

• 进入代理管理页面：
  登录Jenkins主界面，点击顶部导航栏Manage Jenkins→Manage Nodes and Clouds→New Node。
• 配置代理基础信息：
  输入代理节点名称（如debian-agent-01），选择Permanent Agent（永久代理，适合长期稳定运行的节点），点击OK。
• 设置节点属性：
  • Remote root directory：指定代理节点上的工作目录（如/home/jenkins/agent），用于存放构建临时文件与产物，需确保该目录存在且有读写权限。
  • Labels：添加标签（如debian、docker），方便后续任务通过标签匹配代理节点（例如任务配置中指定Restrict where this project can be run为debian，则仅debian标签的代理会执行该任务）。
• 选择启动方法（推荐SSH方式，安全性更高）：
  在Launch method下拉框中选择Launch agent via SSH，点击Add SSH Server，填写以下信息：
  • Host：代理节点的IP地址或域名；
  • Credentials：点击Add，选择SSH Username with private key，输入代理节点的用户名（如jenkins），并粘贴私钥内容（私钥需提前在代理节点上生成，如ssh-keygen -t rsa -b 4096，公钥需添加到主节点的~/.ssh/authorized_keys中）；
  • 点击Test Connection，若显示Success则表示连接正常。
• 保存配置：
  点击Save，主节点会将代理节点信息同步至数据库，等待代理节点上线。

4. 在代理节点上安装并启动Jenkins代理服务

• 安装Java环境（若未安装）：
  执行与主节点相同的Java安装命令，确保版本一致。
• 启动SSH服务（若未启用）：

  sudo systemctl enable ssh
  sudo systemctl start ssh
  

• 启动Jenkins代理：
  有两种方式可选：
  • 方式一：通过Jenkins主界面启动（适合手动测试）：
    在主节点的代理管理页面，选中刚创建的代理节点，点击Launch agent，会自动下载agent.jar文件。在代理节点上执行以下命令（替换< 主节点IP> 为实际IP）：

    java -jar agent.jar -jnlpUrl http://<
        主节点IP>
        :8080/computer/<
        代理节点名称>
        /slave-agent.jnlp -secret <
        代理节点Secret>
         -workDir "/home/jenkins/agent"
    

    （< 代理节点Secret> 可在主节点代理管理页面的Credentials中查看）
  • 方式二：通过系统服务启动（适合长期运行）：
    在代理节点上创建systemd服务文件：

    sudo nano /etc/systemd/system/jenkins-agent.service
    

    写入以下内容（替换< 主节点IP> 、< 代理节点名称> 、< Secret> 、< 工作目录> 为实际值）：

    [Unit]
    Description=Jenkins Agent
    After=network.target
    
    [Service]
    User=jenkins
    Group=jenkins
    ExecStart=/usr/bin/java -jar /home/jenkins/agent.jar -jnlpUrl http://<
        主节点IP>
        :8080/computer/<
        代理节点名称>
        /slave-agent.jnlp -secret <
        Secret>
         -workDir "/home/jenkins/agent"
    Restart=always
    
    [Install]
    WantedBy=multi-user.target
    

    保存后启动服务：

    sudo systemctl daemon-reload
    sudo systemctl start jenkins-agent
    sudo systemctl enable jenkins-agent  # 设置开机自启
    

• 验证代理状态：
  在主节点的代理管理页面，查看代理节点的状态是否变为Online（在线），若为Idle（空闲）则表示代理已就绪。

5. 测试代理节点功能

• 创建测试任务：
  在Jenkins主界面点击New Item，输入任务名称（如test-debian-agent），选择Freestyle project，点击OK。
• 限制任务运行节点：
  在任务配置页面，找到Restrict where this project can be run选项，勾选该选项，输入代理节点的标签（如debian），点击Save。
• 添加构建步骤：
  在Build section点击Add build step→Execute shell，输入以下命令（测试代理节点的环境）：

  echo "Hello from Debian Agent!"
  uname -a
  java -version
  

• 运行任务：
  点击Build Now，查看任务执行日志。若日志中显示上述命令的输出结果，则说明代理节点配置成功，能正常接收并执行主节点分配的任务。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！