编辑“︁Jenkins多仓库管理”︁

{{DISPLAYTITLE:Jenkins多仓库管理}}  
{{Note|本文适用于Jenkins初学者及需要管理多仓库协作的中高级用户。}}  

== 简介 ==  
'''Jenkins多仓库管理'''指在单个Jenkins流水线（Pipeline）中同时操作多个版本控制仓库（如Git、SVN等）的技术。常见于以下场景：  
* 微服务架构中需同时构建多个独立仓库的代码  
* 主项目依赖子模块（Submodule）或第三方库  
* 跨团队协作时需同步触发多个仓库的构建  

通过合理配置，可避免手动切换仓库的繁琐操作，提升CI/CD流程的自动化程度。  

== 核心实现方式 ==  
=== 1. 使用`checkout`步骤多次调用 ===  
在声明式Pipeline中，可通过多次调用`checkout`拉取不同仓库：  

<syntaxhighlight lang="groovy">  
pipeline {  
    agent any  
    stages {  
        stage('Checkout') {  
            steps {  
                // 拉取主仓库  
                checkout([  
                    $class: 'GitSCM',  
                    branches: [[name: 'main']],  
                    extensions: [[$class: 'RelativeTargetDirectory', relativeTargetDir: 'main-repo']],  
                    userRemoteConfigs: [[url: 'https://github.com/user/main-repo.git']]  
                ])  

                // 拉取子模块仓库  
                checkout([  
                    $class: 'GitSCM',  
                    branches: [[name: 'dev']],  
                    extensions: [[$class: 'RelativeTargetDirectory', relativeTargetDir: 'submodule']],  
                    userRemoteConfigs: [[url: 'https://github.com/user/submodule.git']]  
                ])  
            }  
        }  
    }  
}  
</syntaxhighlight>  

{{Tip|`RelativeTargetDirectory`参数指定本地目录名称，避免仓库间冲突}}  

=== 2. 并行拉取优化速度 ===  
使用`parallel`阶段加速多仓库拉取：  

<syntaxhighlight lang="groovy">  
stage('Parallel Checkout') {  
    steps {  
        parallel(  
            "Main Repo": {  
                checkout scm: [$class: 'GitSCM', userRemoteConfigs: [[url: 'https://github.com/user/repo1.git']]]  
            },  
            "Library": {  
                checkout scm: [$class: 'GitSCM', userRemoteConfigs: [[url: 'https://github.com/user/lib.git']]]  
            }  
        )  
    }  
}  
</syntaxhighlight>  

== 高级配置技巧 ==  
=== 动态仓库列表处理 ===  
通过Jenkinsfile参数动态传入仓库列表：  

<syntaxhighlight lang="groovy">  
properties([parameters([  
    string(name: 'REPO_LIST', defaultValue: 'repo1,repo2', description: 'Comma-separated repo URLs')  
])])  

stage('Dynamic Checkout') {  
    steps {  
        script {  
            params.REPO_LIST.split(',').each { repo ->  
                checkout([$class: 'GitSCM', branches: [[name: 'main']],  
                          userRemoteConfigs: [[url: "https://github.com/user/${repo}.git"]]])  
            }  
        }  
    }  
}  
</syntaxhighlight>  

=== 子模块递归处理 ===  
Git子模块的自动化初始化：  

<syntaxhighlight lang="bash">  
# 在Shell步骤中添加  
git submodule update --init --recursive  
</syntaxhighlight>  

== 实际案例 ==  
=== 微服务架构构建 ===  
假设存在以下服务：  
* `user-service`（用户服务）  
* `order-service`（订单服务）  
* `payment-service`（支付服务）  

<mermaid>  
graph LR  
    A[Jenkins Pipeline] --> B[user-service]  
    A --> C[order-service]  
    A --> D[payment-service]  
    C -->|依赖| B  
    D -->|依赖| C  
</mermaid>  

对应Pipeline片段：  

<syntaxhighlight lang="groovy">  
stage('Build Services') {  
    steps {  
        dir('user-service') {  
            checkout([$class: 'GitSCM', branches: [[name: 'v1.0']],  
                      userRemoteConfigs: [[url: 'https://github.com/company/user-service.git']]])  
            sh 'mvn package'  
        }  
        dir('order-service') {  
            checkout([$class: 'GitSCM', branches: [[name: 'v2.1']],  
                      userRemoteConfigs: [[url: 'https://github.com/company/order-service.git']]])  
            sh 'mvn package -Duser-service.version=1.0'  
        }  
    }  
}  
</syntaxhighlight>  

== 常见问题解决 ==  
{| class="wikitable"  
! 问题 !! 解决方案  
|-  
| 仓库权限错误 || 在Jenkins凭据系统中配置SSH密钥或账号密码  
|-  
| 目录冲突 || 使用`RelativeTargetDirectory`或`dir`步骤隔离  
|-  
| 版本不一致 || 通过参数化构建指定分支/tag  
|}  

== 数学建模（可选） ==  
假设有<math>n</math>个仓库，平均检出时间为<math>t</math>，则：  
* 串行检出总时间：<math>T_{\text{serial}} = n \times t</math>  
* 并行检出总时间：<math>T_{\text{parallel}} = t + \epsilon</math>（<math>\epsilon</math>为调度开销）  

== 总结 ==  
Jenkins多仓库管理通过灵活使用：  
* 目录隔离（`dir`）  
* 并行处理（`parallel`）  
* 动态参数（`parameters`）  
可显著提升复杂项目的构建效率。建议结合具体项目结构选择最适合的实现方式。

[[Category:集成部署]]
[[Category:Jenkins]]
[[Category:Jenkins版本控制集成]]