温馨提示×

ubuntu jenkins怎样添加节点

小樊
43
2026-10-13 02:36:44
栏目: 智能运维

在 Ubuntu 上给 Jenkins 添加节点(Agent / Slave) 通常有两种常见方式:


一、准备工作(所有方式通用)

在 Jenkins 主节点(Master) 上:

  1. 安装并启动 Jenkins
sudo systemctl status jenkins
  1. 确保节点机器(Agent)可以:
  • 与 Jenkins Master 网络互通
  • 已安装 Java(JDK 8 或 11)
java -version

二、方式一:通过 Web UI 添加节点(推荐新手)

1. 打开 Jenkins

http://<jenkins-ip>:8080

2. 进入节点管理

Manage Jenkins → Manage Nodes and Clouds → New Node

3. 配置节点

  • Node name:如 ubuntu-agent
  • 选择:Permanent Agent
  • 点击 OK

4. 节点参数说明

参数 说明
Remote root directory Agent 工作目录,如 /home/jenkins
Labels 标签,如 linux ubuntu
Launch method 选 Launch agents via SSH
Host Agent IP
Credentials 添加 SSH 用户名 + 私钥
Java path /usr/bin/java

5. 保存并启动

  • 点击节点 → Launch agent
  • 状态变 Online 即成功

三、方式二:手动启动 Agent(无 SSH)

在 Jenkins Web 页面

New Node → Permanent Agent
Launch method → Launch agent by connecting it to the master

记下:

  • Jenkins URL
  • Secret / Agent name

在 Ubuntu Agent 上

mkdir ~/jenkins-agent
cd ~/jenkins-agent

下载 agent.jar:

wget http://<jenkins-ip>:8080/jnlpJars/agent.jar

启动:

java -jar agent.jar \
  -url http://<jenkins-ip>:8080/ \
  -secret <your-secret> \
  -name "ubuntu-agent" \
  -workDir "/home/jenkins"

✅ 节点上线


四、设为系统服务(推荐)

sudo nano /etc/systemd/system/jenkins-agent.service
[Unit]
Description=Jenkins Agent

[Service]
ExecStart=/usr/bin/java -jar /home/jenkins/agent.jar -url http://<jenkins-ip>:8080/ -secret <secret> -name ubuntu-agent -workDir /home/jenkins
Restart=always
User=jenkins

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable jenkins-agent
sudo systemctl start jenkins-agent

五、常见问题

❌ 节点无法连接

  • 防火墙:8080 / 22
  • Java 版本不匹配

❌ Permission denied

  • Agent 目录权限
sudo chown -R jenkins:jenkins /home/jenkins

如果你愿意,可以告诉我:

  • Jenkins 版本
  • 是否使用 Docker
  • Master 和 Agent 是否同一台机器

我可以给你更精确的配置示例。

0 踩