怎样配置jenkins节点

在 Jenkins 中，“配置节点（Node / Agent）”通常指添加并配置 Slave（从节点）或 Agent 节点，让构建任务分布到不同机器上执行。下面按常见做法 + 推荐方式说明。

一、前置准备

1. 节点机器要求

• 可访问 Jenkins 主节点（网络通畅）
• 安装：
  • JDK（推荐 JDK 8 / 11 / 17，和 Master 兼容）
  • 构建所需工具（如 Git、Maven、Node 等）
• 如果是 Linux，建议创建专用用户（如 jenkins）

二、在 Jenkins 上添加节点

路径

Jenkins → Manage Jenkins → Manage Nodes and Clouds → New Node

基本配置

• Node name：如 agent-linux-01
• Permanent Agent（固定节点）
• 点击 Create

三、节点详细配置（关键项）

1. Remote root directory

• 节点上的工作目录
  示例：

  /home/jenkins/agent
  

  （目录必须存在且 Jenkins 用户有写权限）

2. Labels（标签）

• 用于任务选择节点
  示例：

  linux docker build
  

3. Usage

• Use this node as much as possible（默认）
• 或 Only build jobs with label expressions

4. Launch method（启动方式）✅重点

✅ 推荐方式 1：SSH（最常用）

Launch agents via SSH

配置：

• Host：节点 IP
• Credentials：SSH 用户名 + 私钥
• Java path：/usr/bin/java

✅ 优点：简单、稳定、无需手动启动

✅ 推荐方式 2：Inbound Agent（Jenkins 2.x 推荐）

Launch agent by connecting it to the controller

步骤：

1. Jenkins 生成 Secret
2. 在节点执行：

java -jar agent.jar \
  -url http://jenkins.example.com/ \
  -secret xxxxxx \
  -name agent-linux-01 \
  -workDir /home/jenkins/agent

✅ 适合：

• 云服务器
• 防火墙严格环境

5. Availability

• Keep this agent online as much as possible

四、验证节点是否可用

1. 节点状态显示 ✅ Online
2. 新建测试 Job：
   • Restrict where project can be run：linux
3. 构建并执行：

hostname
whoami

五、常见问题排查

❌ 节点一直 Offline

• SSH 不通 / 端口未开放
• Java 路径错误
• 工作目录无权限

❌ agent.jar 启动失败

• JDK 版本不兼容
• Secret 错误
• URL 无法访问

六、示例：Linux 节点完整流程（SSH）

# 节点机器
useradd jenkins
mkdir -p /home/jenkins/agent
chown -R jenkins:jenkins /home/jenkins

Jenkins：

• New Node
• Launch via SSH
• Java path：/usr/bin/java
• Label：linux

如果你告诉我：

• Jenkins 版本
• 操作系统（Linux / Windows）
• 使用场景（Docker / K8s / 物理机）

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