GitLab同组多项目Maven依赖CI/CD部署问题及本地仓库访问方案咨询

一、避免硬编码项目ID，解决server/client无法拉取api依赖的问题 #

针对同组内项目依赖但项目ID不同的问题，有两个优雅的解决方案，不用硬编码任何项目ID：

方案1：使用GitLab组级Maven仓库（推荐） #

GitLab允许将Maven包发布到组级仓库，同组内所有项目都可以直接访问这个仓库里的包，完全不需要关心单个项目的ID：

1. 修改some_group/api的pom.xml中的distributionManagement，指向组级仓库URL：

   <distributionManagement>
     <repository>
       <id>gitlab-maven</id>
       <url>https://your-gitlab-domain/api/v4/groups/some_group/-/packages/maven</url>
     </repository>
     <snapshotRepository>
       <id>gitlab-maven</id>
       <url>https://your-gitlab-domain/api/v4/groups/some_group/-/packages/maven</url>
     </snapshotRepository>
   </distributionManagement>
   

2. 在server和client的pom.xml中，添加组级仓库作为依赖源：

   <repositories>
     <repository>
       <id>gitlab-maven</id>
       <url>https://your-gitlab-domain/api/v4/groups/some_group/-/packages/maven</url>
       <releases>
         <enabled>true</enabled>
       </releases>
       <snapshots>
         <enabled>true</enabled>
       </snapshots>
     </repository>
   </repositories>
   

3. CI部署时，直接使用GitLab提供的CI_JOB_TOKEN即可，同组项目的CI任务默认有权限访问组级仓库，无需额外配置。

方案2：用Maven属性占位符+CI变量注入 #

如果偏好使用项目级仓库，可以通过占位符+CI变量传递项目ID，避免硬编码：

1. 在api的pom.xml中，用占位符代替固定项目ID：

   <distributionManagement>
     <repository>
       <id>gitlab-maven</id>
       <url>https://your-gitlab-domain/api/v4/projects/${api.project.id}/packages/maven</url>
     </repository>
   </distributionManagement>
   

2. 在api的CI部署脚本中，注入当前项目ID：

   mvn deploy -Dapi.project.id=${CI_PROJECT_ID}
   

3. 在GitLab组的CI/CD变量中添加API_PROJECT_ID，值为some_group/api的项目ID（只需要配置一次）。
4. 在server和client的pom.xml中，同样用占位符配置依赖仓库：

   <repositories>
     <repository>
       <id>gitlab-maven</id>
       <url>https://your-gitlab-domain/api/v4/projects/${api.project.id}/packages/maven</url>
     </repository>
   </repositories>
   

5. 在server和client的CI构建脚本中，注入组变量里的API项目ID：

   mvn install -Dapi.project.id=${API_PROJECT_ID}
   

二、本地访问GitLab Registry（Maven仓库）的方法 #

要在本地拉取GitLab仓库里的Maven包，需要配置本地Maven的settings.xml：

1. 创建/修改本地Maven配置文件：
   打开~/.m2/settings.xml（如果没有就新建），添加以下内容：

   <settings>
     <!-- 配置GitLab认证信息 -->
     <servers>
       <server>
         <id>gitlab-maven</id>
         <!-- 你的GitLab用户名 -->
         <username>your-gitlab-username</username>
         <!-- 个人访问令牌：需要有read_api和read_repository权限 -->
         <password>your-personal-access-token</password>
       </server>
     </servers>
   
     <!-- 配置GitLab Maven仓库作为依赖源 -->
     <profiles>
       <profile>
         <id>gitlab</id>
         <repositories>
           <repository>
             <id>gitlab-maven</id>
             <!-- 用组级仓库URL，或者对应api项目的项目级URL -->
             <url>https://your-gitlab-domain/api/v4/groups/some_group/-/packages/maven</url>
             <releases>
               <enabled>true</enabled>
             </releases>
             <snapshots>
               <enabled>true</enabled>
             </snapshots>
           </repository>
         </repositories>
       </profile>
     </profiles>
   
     <!-- 激活GitLab配置 -->
     <activeProfiles>
       <activeProfile>gitlab</activeProfile>
     </activeProfiles>
   </settings>
   

2. 本地拉取依赖：
   配置完成后，进入server或client项目根目录，直接运行：

   mvn clean install
   

   Maven会自动通过你配置的认证信息，从GitLab仓库拉取api的依赖包。

提示：个人访问令牌可以在GitLab的「用户设置」→「访问令牌」里生成，记得勾选所需权限后保存，令牌只显示一次，要妥善保管。

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