如何通过Jenkins声明式流水线从Git下载单个指定文件？

针对大仓库无需全量克隆的场景，以下几种方法可以快速获取目标extract.yml文件：

方法1：Git稀疏检出（Sparse Checkout） #

利用Git的稀疏检出特性，仅拉取指定文件，保留完整的Git上下文（适合后续需要仓库相关操作的场景）：

pipeline {
    agent any
    stages {
        stage('Fetch target file') {
            steps {
                script {
                    // 初始化本地仓库
                    sh 'git init'
                    // 关联远程仓库（替换为你的实际仓库地址）
                    sh 'git remote add origin https://your-git-repo-url/test-repo.git'
                    // 启用稀疏检出模式
                    sh 'git config core.sparseCheckout true'
                    // 写入需要拉取的文件路径（如果文件在子目录，需写完整路径如"dir/extract.yml"）
                    sh 'echo "extract.yml" >> .git/info/sparse-checkout'
                    // 拉取指定分支的内容（替换为你的目标分支，如main/master）
                    sh 'git pull origin main'
                }
            }
        }
        stage('Read and process YAML') {
            steps {
                script {
                    def yamlContent = readYaml file: 'extract.yml'
                    echo "Loaded YAML content: ${yamlContent}"
                    // 在这里添加你的后续处理逻辑
                }
            }
        }
    }
}

注意：如果是私有仓库，需要在Jenkins中配置Git凭证，拉取时使用带认证的仓库地址（如https://username:token@your-git-repo-url/test-repo.git）。

方法2：Git Archive 拉取单个文件 #

通过Git Archive打包指定文件并解压，无需保留Git仓库目录，更轻量化：

pipeline {
    agent any
    stages {
        stage('Extract target file via archive') {
            steps {
                script {
                    // 从远程仓库指定分支拉取extract.yml并解压到当前目录
                    sh 'git archive --remote=https://your-git-repo-url/test-repo.git main extract.yml | tar -x'
                }
            }
        }
        stage('Process the file') {
            steps {
                script {
                    def content = readYaml file: 'extract.yml'
                    // 后续操作逻辑
                }
            }
        }
    }
}

方法3：直接HTTP下载（适合公开仓库或可获取文件Raw地址的场景） #

如果仓库支持直接访问文件的Raw链接（如GitHub、GitLab的Raw文件地址），可以用curl或wget直接下载：

pipeline {
    agent any
    stages {
        stage('Download file directly') {
            steps {
                // 替换为你的文件实际Raw地址
                sh 'curl -O https://raw.githubusercontent.com/your-username/test-repo/main/extract.yml'
                // 私有仓库需添加认证，例如GitHub个人访问令牌：
                // sh 'curl -H "Authorization: token YOUR_PERSONAL_ACCESS_TOKEN" -O https://raw.githubusercontent.com/your-username/test-repo/main/extract.yml'
            }
        }
        stage('Read YAML data') {
            steps {
                script {
                    def yamlData = readYaml file: 'extract.yml'
                    echo "File content: ${yamlData}"
                }
            }
        }
    }
}

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