Scala(Play)项目GitLab私有仓库对接及公共包发布方案咨询

mvn deploy:deploy-file完全可以实现发布需求，对于仅10个包的规模，这也是最简便的方案，不需要额外搭建仓库代理、迁移工具，操作步骤如下：

• 前置准备：生成GitLab个人访问令牌，勾选Package Registry的写入权限，记录好令牌值。
• 先在本地Maven配置文件~/.m2/settings.xml中添加私有仓库的认证信息，避免发布时返回401：

<servers>
  <server>
    <id>gitlab-maven</id>
    <username>你的GitLab登录用户名</username>
    <password>刚才生成的具备写权限的访问令牌</password>
  </server>
</servers>

• 单个依赖包的发布命令参考如下，注意要准确填写依赖的Maven坐标，否则后续拉取会出现坐标不匹配的问题：

mvn deploy:deploy-file \
  -DgroupId=<依赖groupId，比如com.auth0> \
  -DartifactId=<依赖artifactId，比如java-jwt> \
  -Dversion=<依赖版本号，比如4.4.0> \
  -Dpackaging=jar \
  -Dfile=<本地jar包的绝对路径> \
  -DpomFile=<对应jar包的pom文件路径，建议带上，否则传递依赖不会自动解析> \
  -DrepositoryId=gitlab-maven \
  -Durl=https://gitlab.com/api/v4/projects/SOME_PROJECT_ID/packages/maven

• 10个包不需要逐个手动敲命令，可以写个简单的Shell循环脚本，把所有要上传的包坐标、本地路径整理成列表批量执行即可。如果不想手动下载依赖包，可以先执行mvn dependency:get -Dartifact=groupId:artifactId:version把公共依赖拉到本地Maven仓库，直接引用本地仓库路径下的jar和pom文件即可。如果需要上传源码包、文档包，追加-Dsources=<sources包路径>、-Djavadoc=<javadoc包路径>参数就行。

除了第三方sbt插件之外，直接使用sbt原生配置即可完成对接，不需要额外引入插件。Scala Play项目本身基于sbt构建，原生仓库配置完全适配，没有框架兼容问题，具体配置分两种场景：

• 本地开发场景（推荐全局配置，避免凭证误提交到代码库）
  1. 进入本地sbt配置目录~/.sbt/1.0/（路径对应你使用的sbt大版本，比如sbt 0.13就进0.13目录），新建credentials.sbt文件写入认证信息：

  credentials += Credentials(
    "GitLab Maven Registry",
    "gitlab.com",
    "你的GitLab登录用户名",
    "你的GitLab个人访问令牌（需勾选Package Registry读取权限）"
  )
  

  2. 在项目的build.sbt中添加私有仓库解析地址：

  resolvers += "GitLab Private Maven" at "https://gitlab.com/api/v4/projects/SOME_PROJECT_ID/packages/maven"
  

  刷新sbt项目即可正常拉取私有仓库内的依赖。
• CI/CD流水线场景
  不需要生成固定的个人访问令牌，直接使用GitLab CI内置的CI_JOB_TOKEN作为认证凭证即可，避免硬编码敏感信息，配置可以直接写在项目的build.sbt中，优先从环境变量读取凭证：

  sys.env.get("CI_JOB_TOKEN").foreach { token =>
    credentials += Credentials(
      "GitLab Maven Registry",
      "gitlab.com",
      "gitlab-ci-token",
      token
    )
  }
  

补充说明：第三方sbt插件本质是封装了上述原生配置逻辑，用来减少手动配置的成本。如果不想引入额外的第三方插件依赖，原生配置是稳定性、兼容性最好的方案，所有sbt版本、Play版本都能正常支持。

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