debian jenkins如何配节点

在 Debian 上配置 Jenkins 节点（Agent/Slave）一般分为 Jenkins 主节点（Master）配置 和 Debian 从节点（Agent）准备 两部分。下面按最常见、稳定的方式（SSH 方式）说明。

一、准备工作（Debian 从节点）

1. 安装 Java（必须）

Jenkins Agent 需要 Java 运行环境：

sudo apt update
sudo apt install openjdk-17-jdk -y
# 或 openjdk-11-jdk

验证：

java -version

2. 创建 Jenkins 专用用户（推荐）

sudo adduser jenkins

设置密码或配置 SSH Key（下面用 SSH Key 更稳妥）。

3. 配置 SSH 登录（Master → Agent）

在 Jenkins Master 上生成密钥（如果还没有）：

ssh-keygen

把公钥拷贝到 Agent：

ssh-copy-id jenkins@agent-ip

测试：

ssh jenkins@agent-ip

二、Jenkins Master 配置节点

1. 打开节点管理页面

Jenkins → Manage Jenkins → Nodes → New Node

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

2. 节点配置（关键项）

示例：

Remote root directory: /home/jenkins/agent
Labels: debian
Launch method: Launch agents via SSH
Host: 192.168.1.100
Credentials: jenkins (SSH Username with private key)

保存。

3. 启动节点

点击节点 → Launch agent

状态变为：

Agent successfully connected

三、验证节点是否可用

新建一个 Pipeline 测试：

pipeline {
    agent {
        label 'debian'
    }
    stages {
        stage('Test') {
            steps {
                sh 'uname -a'
            }
        }
    }
}

能成功执行即说明节点配置完成。

四、常见问题

1. 节点连不上

• 防火墙：22 端口是否开放
• SSH 是否允许密码/Key 登录
• Java 是否安装

2. 权限问题

确保：

sudo chown -R jenkins:jenkins /home/jenkins/agent

3. 使用 Web SSH（不推荐生产）

仅适合内网测试。

五、其他方式（可选）

• JNLP（ inbound agent）：Agent 主动连接 Master
• Docker Agent：Master 动态创建 Debian 容器
• Kubernetes Agent：大规模部署

如果你需要 JNLP 方式 或 Docker 动态节点，我可以继续补充。