Jenkins Pipeline拉取GitHub最新Release Tag及认证问题求助

1. 自动获取最新GitHub Release Tag #

无需硬编码tag名称，可通过shell脚本直接从远程仓库拉取最新Release Tag：

script {
    // 拉取所有远程tag并按版本号排序，提取最新的一个
    latestTag = sh(
        script: 'git ls-remote --tags --sort="v:refname" git@github.com:reponae.git | tail -n1 | cut -d/ -f3',
        returnStdout: true
    ).trim()
    echo "最新Release Tag: ${latestTag}"
}

2. 解决Git认证问题 #

避免硬编码凭据ID #

在Jenkins全局凭据中配置好GitHub的SSH密钥（对应git@github.com地址）或个人访问令牌（PAT，对应HTTPS地址），然后在Pipeline中引用已配置的凭据ID：

• 若用SSH地址：确保凭据ID与Jenkins中配置的一致（比如github-ssh-creds）
• 若用HTTPS地址：URL改为https://github.com/reponae.git，凭据选择用户名+PAT类型

优化Checkout步骤 #

将获取到的latestTag变量传入checkout的分支参数，拉取对应tag代码：

stage('Checkout Latest Tag') {
    steps {
        script {
            latestTag = sh(
                script: 'git ls-remote --tags --sort="v:refname" git@github.com:reponae.git | tail -n1 | cut -d/ -f3',
                returnStdout: true
            ).trim()
        }
        checkout([
            $class: 'GitSCM',
            branches: [[name: "refs/tags/${latestTag}"]], // 引用tag的完整路径
            userRemoteConfigs: [[
                url: 'git@github.com:reponae.git',
                credentialsId: 'github-ssh-creds' // 替换为你的Jenkins凭据ID
            ]]
        ])
    }
}

3. 完整修正后的Jenkinsfile #

修复原文件的语法错误（如sh 'CI=false npm run build'缺失闭合引号），并整合上述步骤：

pipeline {
    agent {
        docker {
            label 'linux-builder'
            image 'node:14'
            args '-p 3000:3000 -u root'
        }
    }
    stages {
        stage('Checkout Latest Tag') {
            steps {
                script {
                    latestTag = sh(
                        script: 'git ls-remote --tags --sort="v:refname" git@github.com:reponae.git | tail -n1 | cut -d/ -f3',
                        returnStdout: true
                    ).trim()
                    echo "正在拉取最新Tag: ${latestTag}"
                }
                checkout([
                    $class: 'GitSCM',
                    branches: [[name: "refs/tags/${latestTag}"]],
                    userRemoteConfigs: [[
                        url: 'git@github.com:reponae.git',
                        credentialsId: 'github-ssh-creds' // 替换为你的凭据ID
                    ]]
                ])
            }
        }
        stage('Build') {
            steps {
                sh 'apt update && apt install rsync -y'
                sh 'cat /etc/os-release'
                sh 'node -v'
                sh 'npm -v'
                sh 'npm install'
                sh 'CI=false npm run build' // 修复引号缺失问题
            }
        }
        stage('Deploy') {
            steps {
                // 示例：用rsync传输构建目录到远程服务器
                sh '''
                    rsync -avz --delete ./build/ user@remote-server:/path/to/deploy/
                '''
            }
        }
    }
}

额外注意事项 #

• 确保Jenkins代理节点可访问GitHub，SSH凭据的公钥已添加至GitHub账号，PAT需拥有repo权限
• 若tag命名带前缀（如v1.0.0），上述git命令会自动识别，无需额外修改

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