ubuntu jenkins怎么添加节点

在 Ubuntu 上给 Jenkins 添加节点（Agent/Slave） 一般有两种常见方式：
1）SSH 方式（最常用）
2）JNLP（Java Web Start）方式

下面以 SSH 方式 为例，一步步说明（适合 Ubuntu 环境）。

一、准备工作（节点机器上）

假设你的 节点机器（Agent） 也是 Ubuntu。

1. 创建 Jenkins 用户（推荐）

sudo adduser jenkins

2. 安装 Java

Jenkins Agent 需要 Java：

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

检查：

java -version

3. 配置 SSH（用于 Jenkins 连接）

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

二、Jenkins 主控端配置

1. 登录 Jenkins

浏览器打开：

http://<jenkins-server>:8080

2. 添加节点

路径：

Manage Jenkins → Manage Nodes and Clouds → New Node

• Node name：例如 ubuntu-agent-01
• 选择：Permanent Agent
• 点击 Create

三、节点配置（重点）

1. 基本配置

• Remote root directory

  /home/jenkins
  

• Labels（可选）

  ubuntu linux
  

• Usage
  Only build jobs with label expressions matching this node

2. Launch method（启动方式）

选择：

Launch agents via SSH

填写：

• Host：节点 IP（如 192.168.1.100）
• Credentials：
  • 点击 Add
  • Kind：SSH Username with private key
  • Username：jenkins
  • Private Key：粘贴主控机的 SSH 私钥

如果是密码登录，也可以选 Username with password

3. 生成 SSH 信任（可选但推荐）

在 Jenkins 主控端：

ssh-keygen
ssh-copy-id jenkins@节点IP

四、启动节点

配置完成后：

• 点击节点
• 点击 Launch agent

如果成功：

• 节点状态显示 Connected
• 日志中无错误

五、测试节点

新建一个 Freestyle 项目：

• Restrict where this project can be run
• 填写：ubuntu-agent-01

构建步骤：

uname -a
hostname

六、常见问题

1. 节点一直 Offline

检查：

• Java 是否安装
• SSH 是否能连通
• 防火墙（22 端口）

2. 权限问题

确保 /home/jenkins 属于 jenkins 用户：

sudo chown -R jenkins:jenkins /home/jenkins

七、JNLP 方式（简述）

如果你不想用 SSH：

• 节点类型选 Launch agent by connecting to the controller
• 节点机器执行：

java -jar agent.jar -url http://jenkins:8080/ -secret xxx -name ubuntu-agent-01

如果你愿意，我可以：

• 给你 一键脚本
• 帮你配置 Docker Jenkins Agent
• 或针对 Kubernetes / 云服务器 场景说明

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