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，查看任务执行日志。若日志中显示上述命令的输出结果，则说明代理节点配置成功，能正常接收并执行主节点分配的任务。

0 赞

0 踩