手摸手教你玩 Jenkins，一次搞懂 CI/CD！（第三章：发布之nodeAgent）

Jenkins

发布日期: 2026-07-13

文章字数: 1.4k

阅读时长: 5 分钟

阅读次数:

Jenkins 相关的教程，我已经出了两期了。

第一章，我讲到了通过 docker 快速部署 Jenkins 以及安装 Jenkins 的必要插件。

第二章，我讲到了通过 sshPublisher 去目标服务器上发布项目。

今天，我来讲讲如何通过代理节点去目标服务器上发布项目。其实这里实现的效果和第二章中实现的效果是一样的，都是去目标服务器上执行发布项目的脚本，进行项目的编译和发布。

个人觉得，二选一，掌握一种方式就好了。

下面，我默认你已经看过了上面我写的两篇文章，因此，一些相同的部分，我就不再赘述。

添加节点

来到系统管理页面，点击「节点和云管理」

默认已经有了一个节点，我们点击「New Node」添加新的节点

填写节点名称

填写节点的详细信息

是不是看到这里的 Credentials 有一种莫名的亲切感？是的，这就是在第二章节中，在凭据管理页面死活找不到的添加凭据的地方。

添加新的凭据

这里需要添加的是目标服务器上，用于 ssh 登录的用户 jenkinsjob 的账号和密码

选择刚刚新添加的凭据

填写完了之后就直接点击保存。

查看节点

回到节点列表，我们可以看到刚刚我们添加的节点已经添加成功了。

我们点击刚刚新添加的节点，进入节点详情，然后点击右上角的「上线节点」，看节点是否能够上线成功

上线节点

一般情况下而言，可能多半就会报如下类似的错误：

bash: line 1: java: command not found
Agent JVM has terminated. Exit code=127

原因是：Jenkins Agent 必须要能运行 Java，但你的服务器上没有 java 命令。

当 Jenkins 通过 SSH 连接 Agent 时，它会自动执行：

java -jar remoting.jar

也就是让 Agent 使用 Java 运行 Jenkins 的 remoting 进程。如果服务器上没有 Java，Agent 永远无法上线。

那么，如何解决这个问题呢？

直接在目标服务器上安装 java 环境就好了。

这里假设目标服务器为 ubuntu 系统：

安装 java 环境

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

验证安装

java -version

# 类似以下输出即可
#openjdk version "17.0.16" 2025-07-15
#OpenJDK Runtime Environment (build 17.0.16+8-Ubuntu-0ubuntu124.04.1)
#OpenJDK 64-Bit Server VM (build 17.0.16+8-Ubuntu-0ubuntu124.04.1, mixed mode, sharing)

javac -version
# 类似以下输出即可
#javac 17.0.16

然后我们重新上线节点，可以发现节点能够正常上线了。

并且我们在目标服务器上通过 jenkinsjob 账号登录之后，我们可以看到当时设置的远程目录下会存在

编写 jenkinsfile

这里还是老规矩，直接贴上我写好的 jenkinsfile 文件内容供各位看官老爷们参考

#!/usr/bin/env groovy Jenkinsfile

pipeline {
    agent { label 'node_ssh_jenkinsjob' }

    options {
        ansiColor('xterm')
    }

    parameters {
        booleanParam(
            name: 'Select_demo_project',
            description: '可以自己填写一下备注，需要注意 name 字段中，最好不要出现横杠 -'
        )

        gitParameter(
            name: 'Git_Branch_demo_project',
            branch: '',
            branchFilter: 'demo_project/(.*)',
            defaultValue: 'master',
            quickFilterEnabled: true,
            selectedValue: 'NONE',
            sortMode: 'NONE',
            tagFilter: '*',
            type: 'PT_BRANCH_TAG',
            useRepository: 'demo-project',
            description: '需要注意 gitParameter.name 字段中，最好不要出现横杠 -'
        )
    }

    stages {

        stage('Step1：初始化，确认参数') {
            steps {
                catchError(buildResult: 'SUCCESS', stageResult: 'FAILURE') {
                    checkout([
                        $class: 'GitSCM',
                        branches: [[name: '*/master']],
                        extensions: [],
                        userRemoteConfigs: [[
                            credentialsId: '86b1ba1c-db25-47b2-b50e-e58516641574',
                            name: 'demo-project',
                            url: 'http://127.0.0.1:8099/demo/demo-project.git'
                        ]]
                    ])
                }
            }
        }

        stage('Step2：发布服务') {
            steps {
                script {
                    if (Select_demo_project == 'true') {
                        echo "----------------构建参数--------------------"
                        echo "git分支：${Git_Branch_demo_project} ---> Select_demo_project:${Select_demo_project}"
                        sh 'cd /home/jenkinsjob/deploy_sample && sudo ./deploy.sh'
                    }
                }
            }
        }

    }


}