GitLab .gitlab-ci.yml转Jenkins Pipeline：语法验证及功能一致性确认

原GitLab CI配置 #

before_script:
    - apt-get update -qq
    - apt-get install -qq git zip
test:                              
  environment: test
  script:
    - chmod 400 $SSH_KEY
    - apt-get update -qq
    - apt-get install -qq git zip
    - zip -r xyz.zip $CI_PROJECT_DIR 
    # - ssh -i $SSH_KEY -o stricthostkeychecking=no hello@<hostname> "pwd ; rm -rf xyz xyz.zip"
    - scp -o stricthostkeychecking=no -i $SSH_KEY xyz.zip hello@<hostname>:/home/<linux_user>/
    - ssh -i $SSH_KEY -o stricthostkeychecking=no hello@<hostname> "pwd;rm -rf xyz; unzip xyz.zip -d xyz; chmod 700 -R xyz; rm -rf xyz.zip"
  artifacts:
    paths:
      - xyz.zip
  only:
    changes:
      - abc/**/*
    refs:
        - test

转换后的Jenkins Pipeline（需修正） #

pipeline {
  agent any
  environment {
    TEST = "test"
  }
  stages {
    stage("Test") {
      steps {
        sh "apt-get update -qq"
        sh "apt-get install -qq git zip"
        sh "chmod 400 ${SSH_KEY}"
        sh "apt-get update -qq"
        sh "apt-get install -qq git zip"
        sh "zip -r xyz.zip ${CI_PROJECT_DIR}"
        sh "scp -o stricthostkeychecking=no -i ${SSH_KEY} xyz.zip hello@<hostname>:/home/<linux_user>/"
        sh "ssh -i ${SSH_KEY} -o stricthostkeychecking=no hello@<hostname> 'pwd;rm -rf xyz; unzip xyz.zip -d xyz; chmod 700 -R xyz; rm -rf xyz.zip'"
      }
      post {
        always {
          archiveArtifacts artifacts: 'xyz.zip', onlyIfSuccessful: true
        }
      }
    }
  }
  options {
    skipDefaultCheckout()
  }
  triggers {
    changeset {
      pathFilters("abc/**/*")
    }
    branch 'test'
  }
}

关键问题修正与功能一致性验证 #

• 环境变量标识修正
  原GitLab的environment: test是标记部署环境的元数据，并非定义环境变量，你当前Jenkins里的TEST = "test"完全无用。若需保留环境标识逻辑，可改为仅定义变量用于后续标识：

  environment {
    ENV_NAME = 'test'
  }
  

• 项目目录变量替换
  GitLab的$CI_PROJECT_DIR对应Jenkins的${WORKSPACE}，你当前使用${CI_PROJECT_DIR}会因Jenkins无此默认变量导致zip命令失败，必须替换为：

  sh "zip -r xyz.zip ${WORKSPACE}"
  

• 触发条件逻辑修正
  你启用了skipDefaultCheckout()，这会导致Jenkins不拉取代码仓库，进而无法检测abc/**/*的文件变更（changeset触发器依赖本地代码）。必须移除skipDefaultCheckout()，或在Test阶段开头手动拉取代码：

  steps {
    checkout scm // 手动拉取代码，配合变更检测
    // 后续命令...
  }
  

  同时，Jenkins的分支与变更条件需放在when块中控制阶段执行，而非triggers，正确写法：

  stage("Test") {
    when {
      branch 'test'
      changeset 'abc/**/*'
    }
    // steps...
  }
  triggers {
    pollSCM('H/15 * * * *') // 每15分钟轮询SCM，可按需调整
  }
  

• SSH凭据处理
  原GitLab中$SSH_KEY来自项目凭据，Jenkins中需通过凭据系统配置并注入，建议使用凭据绑定插件：

  environment {
    SSH_KEY = credentials('ssh-private-key-id') // 替换为你的实际凭据ID
  }
  

• Artifacts逻辑一致性
  原GitLab默认仅在job成功时上传artifacts，你配置的archiveArtifacts artifacts: 'xyz.zip', onlyIfSuccessful: true与原逻辑一致，无问题。

• Shell引号问题
  你将SSH命令的双引号改为单引号，由于命令中无Jenkins变量需要展开，此写法安全，功能与原配置一致。

修正后的完整Jenkins Pipeline示例 #

pipeline {
  agent any
  environment {
    SSH_KEY = credentials('ssh-private-key-id') // 替换为实际凭据ID
  }
  stages {
    stage("Test") {
      when {
        branch 'test'
        changeset 'abc/**/*'
      }
      steps {
        // 全局前置脚本对应逻辑
        sh "apt-get update -qq"
        sh "apt-get install -qq git zip"
        // Test job脚本逻辑
        sh "chmod 400 ${SSH_KEY}"
        sh "apt-get update -qq"
        sh "apt-get install -qq git zip"
        sh "zip -r xyz.zip ${WORKSPACE}"
        sh "scp -o stricthostkeychecking=no -i ${SSH_KEY} xyz.zip hello@<hostname>:/home/<linux_user>/"
        sh "ssh -i ${SSH_KEY} -o stricthostkeychecking=no hello@<hostname> 'pwd;rm -rf xyz; unzip xyz.zip -d xyz; chmod 700 -R xyz; rm -rf xyz.zip'"
      }
      post {
        success { // 仅在成功时归档，与原GitLab逻辑一致
          archiveArtifacts artifacts: 'xyz.zip'
        }
      }
    }
  }
  triggers {
    pollSCM('H/15 * * * *') // 每15分钟轮询一次SCM
  }
}

内容的提问来源于stack exchange，提问作者Divyank