debian jenkins如何加节点

在 Debian 上搭建的 Jenkins 中添加节点（Agent / Slave），常见有 SSH 方式 和 JNLP（Java Web Start）方式。下面以最常用、最稳定的 SSH 节点为例，详细说明步骤。

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

假设：

• Jenkins 主节点：192.168.1.10
• 新节点（Debian）：192.168.1.20

1. 安装 Java

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

检查：

java -version

2. 创建 Jenkins 用户（推荐）

sudo useradd -m -s /bin/bash jenkins
sudo passwd jenkins

3. 配置 SSH（主节点可无密码登录）

在 Jenkins 主节点执行：

ssh-keygen
ssh-copy-id jenkins@192.168.1.20

二、Jenkins 后台添加节点（SSH 方式）

1. 打开节点管理

Jenkins → Manage Jenkins → Nodes → New Node

2. 配置节点

• Node name：debian-agent-01
• 选择：Permanent Agent
• 点击 Create

3. 节点参数说明

如果没有 SSH 凭据：

• 添加：Credentials → System → Global
• 类型：SSH Username with private key

三、启动节点

保存后：

• Jenkins 会自动通过 SSH 连接
• 节点状态变为 ✅ Online

四、JNLP 方式（备选）

适用于：

• 节点在防火墙后
• 无法 SSH

步骤简述：

1. 节点安装 Java
2. Jenkins 创建节点（Launch method 选 Launch agent by connecting to controller）
3. 节点执行：

curl -sO http://jenkins:8080/jnlpJars/agent.jar
java -jar agent.jar -jnlpUrl http://jenkins:8080/computer/debian-agent-01/slave-agent.jnlp -secret xxxx

五、常见问题

1. 节点一直 Offline

• Java 版本不匹配
• SSH 无法连接
• /home/jenkins 权限不对

2. 推荐做法

• 使用 SSH + 固定用户
• 给节点打 Label
• Pipeline 中指定：

agent {
  label 'debian'
}

如果你愿意，我可以：

• 给你 完整 Jenkinsfile 示例
• 或帮你配 Docker 节点
• 或解决你当前具体的报错信息

直接说你现在是哪一步卡住了即可。