温馨提示×

ubuntu jenkins怎么配节点

小樊
45
2026-10-01 09:10:12
栏目: 智能运维

在 Ubuntu 上配置 Jenkins 节点(Agent/Slave) 一般有两种常见方式:

  1. SSH 方式(推荐,最常用)
  2. JNLP 方式(Java Web Start)

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


一、准备工作(节点机器上)

1. 安装 Java

Jenkins Agent 必须依赖 Java:

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

验证:

java -version

2. 创建 Jenkins 用户(推荐)

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

二、Jenkins 主控端配置节点(Web UI)

方式一:SSH 节点(最推荐)

1. 打开 Jenkins

Manage Jenkins → Manage Nodes and Clouds → New Node

2. 填写节点信息

  • Node name: ubuntu-agent
  • Type: Permanent Agent
  • Remote root directory: /home/jenkins
  • Labels: ubuntu
  • Usage: Use this node as much as possible

3. Launch method

选择:

Launch agents via SSH

配置:

  • Host: 节点IP
  • Credentials:
    • 用户名:jenkins
    • 密码 或 SSH 私钥
  • Host Key Verification: Non verifying

保存后 Jenkins 会自动连接。


方式二:JNLP 节点(不推荐,但适用无 SSH)

1. 新建节点

  • Launch method 选择:
Launch agent by connecting it to the controller

2. 节点机器执行

在 Ubuntu 节点上:

mkdir ~/jenkins-agent
cd ~/jenkins-agent

下载 agent.jar(Jenkins 页面会提供):

wget http://<jenkins-ip>:8080/jnlpJars/agent.jar

运行:

java -jar agent.jar \
  -url http://<jenkins-ip>:8080/ \
  -secret <secret> \
  -name ubuntu-agent

✅ 节点上线


三、验证节点是否可用

在 Jenkins 中:

Manage Jenkins → Nodes

状态为 Connected ✅

测试 Pipeline:

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

四、常见问题

1. 节点连不上

  • 防火墙:8080 / 22
  • Java 版本太低
  • SSH 用户权限不足

2. 推荐生产做法

✅ SSH + 普通用户
✅ 固定 Label
❌ 不要用 root


如果你愿意,我可以:

  • 给你 Docker 方式 Jenkins Agent
  • 或 Kubernetes Jenkins Agent
  • 或 systemd 守护 JNLP Agent

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

0 踩