jenkins

Jenkins Pipeline 与命令行管理

补充说明

Jenkins 是自托管的自动化服务器，用 Jenkinsfile 描述流水线。它插件生态庞大，但版本、权限和插件兼容性需要持续维护。Kubernetes 上的部署方式见 K8s 分支的 jenkins 页。

常用示例

java -jar jenkins-cli.jar -s https://jenkins.example.com -auth user:token list-jobs
java -jar jenkins-cli.jar -s https://jenkins.example.com -auth user:token build app
java -jar jenkins-cli.jar -s https://jenkins.example.com -auth user:token console app
java -jar jenkins-cli.jar -s https://jenkins.example.com -auth user:token who-am-i

声明式 Pipeline：

pipeline {
  agent { label 'linux' }
  options { timeout(time: 30, unit: 'MINUTES') }
  environment {
    APP_ENV = 'staging'
  }
  stages {
    stage('Build') {
      steps {
        sh 'npm ci && npm run build'
      }
    }
    stage('Test') {
      steps {
        sh 'npm test'
      }
      post {
        always { junit 'reports/**/*.xml' }
      }
    }
    stage('Deploy') {
      when { branch 'main' }
      steps {
        withCredentials([string(credentialsId: 'deploy-token', variable: 'TOKEN')]) {
          sh './deploy.sh'
        }
      }
    }
  }
}

易错点与排错

• 声明式（pipeline {}）和脚本式（node {}）语法不同；混用会出现难懂的报错。
• sh 默认在失败时抛错；需要容忍失败时显式 returnStatus 或 catchError。
• withCredentials 才能安全注入密钥；直接 environment 写密码会进日志和配置。
• agent label 不匹配时 job 会一直排队；先看节点标签和在线状态。
• Jenkins 的 Groovy 沙箱会拦截未批准的方法；不要在共享库外随意调用系统 API。
• 插件升级可能改变 Pipeline 步骤行为；升级前在测试实例验证。
• 工作区可能被复用；构建前清理，避免上次产物污染本次结果。
• post 块适合收集报告和清理；但失败后的通知本身也可能失败。
• 并发构建共享节点时注意端口、目录和资源冲突；用 lock 或独立 workspace。

相关命令

• gitlab-ci — GitLab 流水线
• github-actions — GitHub 流水线
• kubectl — 查看 K8s 中的 Jenkins

读完自测

合上页面，先回答，再展开对照。

1. 声明式（pipeline {}）和脚本式（node {}）Pipeline 能否混用？混用会怎样？
2. job 一直排队时，应先检查什么？
3. 在 Pipeline 中安全注入部署令牌应该用什么步骤？直接把密码写进 environment 有什么问题？