Ubuntu Jenkins配置中如何使用插件

Ubuntu 上 Jenkins 插件的安装与使用

一 安装前准备

• 确保 Jenkins 已运行并可访问：默认访问地址为 http://服务器IP:8080。
• 准备好管理员权限与网络：在线安装需能访问外网；离线环境请提前下载插件 .hpi 文件。
• 注意版本兼容：插件的版本需与当前 Jenkins 版本匹配，避免不兼容导致异常。

二 安装方式

• 在线安装（推荐）
  • 进入 Manage Jenkins → Manage Plugins → Available，搜索所需插件（如 Git、NodeJS、Maven Integration）。
  • 勾选插件，选择 Install without restart 或 Install and restart 完成安装。
• 离线安装（无法访问互联网时）
  • 从官方站点下载插件 .hpi 文件，进入 Manage Plugins → Advanced → Upload Plugin 上传并安装，安装后按提示重启。
• 命令行安装（CLI）
  • 下载 jenkins-cli.jar，执行：java -jar jenkins-cli.jar -s http://JENKINS_URL/ install-plugin 插件名（可加 -restart 重启）。
• 手动放置插件文件
  • 将 .hpi 放入 /var/lib/jenkins/plugins/，然后重启 Jenkins：sudo systemctl restart jenkins。

三 常用插件与配置位置

四 在任务中使用插件

• Freestyle 任务
  • 源码管理选择 Git 并配置仓库与凭据；构建环境按需启用 NodeJS；构建步骤执行 npm/mvn 等命令；构建后操作可用 Publish Over SSH 发布产物。
• Pipeline 任务
  • 在 Pipeline 脚本中使用插件提供的步骤（如 nodejs、sshPublisher 等），示例：

    pipeline {
      agent any
      tools { nodejs 'NodeJS-18' } // 需在全局工具配置中预先定义
      stages {
        stage('Build') {
          steps {
            sh 'npm install && npm run build'
          }
        }
        stage('Deploy') {
          steps {
            sshPublisher(publishers: [sshPublisherDesc(
              configName: 'prod-ssh',
              transfers: [sshTransfer(
                sourceFiles: 'dist/**',
                removePrefix: 'dist',
                remoteDirectory: '/var/www/app'
              )]
            )])
          }
        }
      }
    }
    

• Webhooks 触发
  • 在 Gitee/GitHub 项目设置里添加 Webhook 指向 JENKINS_URL/github-webhook/（或 Gitee 对应路径），并在任务中勾选相应的触发器。

五 维护与最佳实践

• 更新与卸载
  • 在 Manage Plugins → Updates 执行更新；在 Installed 标签页卸载不再使用的插件，必要时重启。
• 兼容性检查
  • 升级 Jenkins 或插件前先在测试环境验证，确保插件与 Jenkins 版本兼容，避免生产事故。
• 安全与来源
  • 仅从官方渠道下载 .hpi，避免不受信任来源；定期更新以获取安全修复。
• 重启方式
  • 可在 Web 界面执行 /restart 或 /reload，或执行：sudo systemctl restart jenkins。