温馨提示×

ubuntu jenkins怎样加节点

小樊
39
2026-10-01 09:25:13
栏目: 智能运维

在 Ubuntu 上给 Jenkins 添加节点(Agent / Slave) 一般有 两种方式:
1️⃣ 通过 SSH 添加 Linux 节点(最常用)
2️⃣ 通过 Java Web(JNLP)方式添加节点

下面以 Ubuntu 作为 Jenkins Agent 节点 为例,一步一步说明。


一、准备工作(Agent 节点 Ubuntu)

在 要加入的 Ubuntu 节点 上执行:

1. 创建 Jenkins 用户(推荐)

sudo adduser jenkins

2. 安装 Java

Jenkins Agent 需要 Java:

sudo apt update
sudo apt install openjdk-11-jdk -y

检查:

java -version

3. 配置 SSH(如果是 SSH 节点)

sudo apt install openssh-server -y
sudo systemctl enable ssh
sudo systemctl start ssh

二、Jenkins 主节点配置(Web 界面)

1. 登录 Jenkins

浏览器访问:

http://<jenkins-server>:8080

2. 添加节点

路径:

Manage Jenkins → Manage Nodes and Clouds → New Node
  • Node name:ubuntu-agent-01
  • 选择:Permanent Agent
  • 点击 Create

三、节点详细配置(重点)

方式一:SSH 方式(推荐 ✅)

在节点配置页填写:

配置项 示例
Remote root directory /home/jenkins
Labels ubuntu linux
Launch method Launch agents via SSH
Host 192.168.1.100
Credentials 添加 SSH 用户名 + 私钥
JVM Options 可不填

✅ Credentials 添加方式:

  • Kind: SSH Username with private key
  • Username: jenkins
  • Private Key: 粘贴主控端 id_rsa

点击 Save


方式二:JNLP(Web 启动)

节点配置:

  • Launch method: Launch agent by connecting to the controller
  • 保存后,页面会生成命令:
java -jar agent.jar -url http://jenkins:8080/ \
  -secret xxxxxxxx \
  -name "ubuntu-agent-01"

在 Ubuntu 节点执行:

mkdir ~/jenkins-agent
cd ~/jenkins-agent
wget http://jenkins:8080/jnlpJars/agent.jar
java -jar agent.jar -url http://jenkins:8080/ -secret xxxx -name ubuntu-agent-01

(可配合 systemd 后台运行)


四、验证节点是否成功

回到:

Manage Jenkins → Nodes

状态应为: ✅ Connected


五、常见问题

1. 节点一直离线

  • 防火墙未开放 22 / 8080
  • Java 版本不匹配
  • SSH 密钥权限问题

2. Permission denied

chmod 600 ~/.ssh/authorized_keys

3. 想自动化

可用 Docker Agent 或 Jenkins Helm + K8s


如果你愿意,我可以:

  • 给你 systemd 启动 Agent 的 service 文件
  • 或写 一键脚本
  • 或讲 Jenkins + Docker 动态节点

你现在是 物理机 / 虚拟机 / 云服务器?

0 踩