如何使用极狐GitLab Maven 仓库？

2024-04-02 09:52
文章标签 maven 使用 仓库 gitlab 极狐

本文主要是介绍如何使用极狐GitLab Maven 仓库？，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

本文作者：徐晓伟

GitLab 是一个全球知名的一体化 DevOps 平台，很多人都通过私有化部署 GitLab 来进行源代码托管。极狐GitLab 是 GitLab 在中国的发行版，专门为中国程序员服务。可以一键式部署极狐GitLab。

本文主要讲述了如何使用极狐GitLab 提供的Maven仓库功能。

文档

  1. 软件包库中的 Maven 包

Maven 仓库类型

项目级 Maven 端点


<project><repositories><repository><id>gitlab-maven</id><!-- PROJECT_ID：填写项目ID，查看方式见下方 --><!-- PROJECT_ID：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_PROJECT_ID} 代替 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url></repository></repositories><distributionManagement><repository><id>gitlab-maven</id><!-- PROJECT_ID：填写项目ID，查看方式见下方 --><!-- PROJECT_ID：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_PROJECT_ID} 代替 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url></repository><snapshotRepository><id>gitlab-maven</id><!-- PROJECT_ID：填写项目ID，查看方式见下方 --><!-- PROJECT_ID：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_PROJECT_ID} 代替 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url></snapshotRepository></distributionManagement>
</project>

群组级 Maven 端点


<project><repositories><repository><id>gitlab-maven</id><!-- GROUP_ID：填写群组ID，查看方式见下方 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/groups/GROUP_ID/-/packages/maven</url></repository></repositories><distributionManagement><repository><id>gitlab-maven</id><!-- PROJECT_ID：填写项目ID，查看方式见下方 --><!-- PROJECT_ID：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_PROJECT_ID} 代替 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url></repository><snapshotRepository><id>gitlab-maven</id><!-- PROJECT_ID：填写项目ID，查看方式见下方 --><!-- PROJECT_ID：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_PROJECT_ID} 代替 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url></snapshotRepository></distributionManagement>
</project>

实例级 Maven 端点


<project><repositories><repository><id>gitlab-maven</id><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/packages/maven</url></repository></repositories><distributionManagement><repository><id>gitlab-maven</id><!-- PROJECT_ID：填写项目ID，查看方式见下方 --><!-- PROJECT_ID：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_PROJECT_ID} 代替 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url></repository><snapshotRepository><id>gitlab-maven</id><!-- PROJECT_ID：填写项目ID，查看方式见下方 --><!-- PROJECT_ID：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_PROJECT_ID} 代替 --><!-- https://gitlab.example.com/api/v4：如果仅在 GitLab Runner 中运行时，可使用环境变量 ${CI_API_V4_URL} 代替 --><url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url></snapshotRepository></distributionManagement>
</project>

项目ID​

  1. 截图来源于不同的 gitlab（gitlab 版本） 中的项目，所以项目ID不同
  2. 同一个 gitlab 在不同位置查看到的项目ID是相同的

gitlab-46.png gitlab-47.png gitlab-48.png

群组ID

  1. 截图来源于不同的 gitlab（gitlab 版本） 版本中的项目，所以群组ID不同
  2. 同一个 gitlab 在不同位置查看到的群组ID是相同的

gitlab-49.png gitlab-50.png gitlab-51png

认证方式

在 Maven 中使用个人访问令牌进行身份验证​


<settings><servers><server><id>gitlab-maven</id><configuration><httpHeaders><property><name>Private-Token</name><!-- 创建 gitlab 个人令牌，替换下方的值 --><value>REPLACE_WITH_YOUR_PERSONAL_ACCESS_TOKEN</value></property></httpHeaders></configuration></server></servers>
</settings>

在 Maven 中使用部署令牌进行身份验证​


<settings><servers><server><id>gitlab-maven</id><configuration><httpHeaders><property><name>Deploy-Token</name><!-- 在仓库中创建部署令牌，替换下方的值 --><value>REPLACE_WITH_YOUR_DEPLOY_TOKEN</value></property></httpHeaders></configuration></server></servers>
</settings>

使用 Maven 中的 CI 作业令牌进行身份验证​


<settings><servers><server><id>gitlab-maven</id><configuration><httpHeaders><property><name>Job-Token</name><!-- 此用法仅限于在使用 GitLab Runner 中执行使用 --><!-- 此处取 GitLab Runner 执行时的环境变量，用户无需干预此处的配置 --><value>${CI_JOB_TOKEN}</value></property></httpHeaders></configuration></server></servers>
</settings>

发布 Maven 依赖

  1. 项目：https://gitlab.com/xuxiaowei-com-cn/my-maven-app/-/packages/

  2. 已发布的依赖：https://gitlab.com/xuxiaowei-com-cn/my-maven-app/-/packages/

  3. GitLab Runner 发布日志：https://gitlab.com/xuxiaowei-com-cn/my-maven-app/-/pipelines

  4. 认证方式： 使用 Maven 中的 CI 作业令牌进行身份验证

  5. 使用的配置

    1. setting.xml 配置

      1. setting.xml 配置
      2. setting.xml 配置 永久链

    2. pom.xml 配置

      1. pom.xml 配置
      2. pom.xml 配置 永久链

使用 Maven 依赖

  1. 项目：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app

  2. GitLab Runner 打包日志：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app/-/pipelines

  3. 打包失败：

    1. 失败日志 gitlab-52.png

    2. 失败原因：

      1. 没有设置凭证，无法访问非公开的软件包库
      2. 设置了凭证，但该凭证没有权限访问软件包库

  4. 成功示例：

    1. main 分支：

      1. 代码：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app/-/tree/6a71d280226ebb4aa16b479bc2b2d7a254f23513
      2. 流水线：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app/-/pipelines/1118517218
      3. 作业：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app/-/jobs/5818086715

    2. delete-server 分支：

      1. 代码：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app/-/tree/f493df00dd840f6cc39d89f2adb8e5c44a9ab75e
      2. 流水线：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app/-/pipelines/1118518272
      3. 作业：https://gitlab.com/xuxiaowei-com-cn/use-my-maven-app/-/jobs/5818091141

解决方案1：【允许来自以下项目的 CI 作业令牌访问此项目】

  1. 文档依据（注意：中文版可能会比英文版的文档版本低，参见文档右上角）

    1. 限制您项目的作业令牌访问 - 中文 gitlab-54.png
    2. limit-your-projects-job-token-access - 英文 gitlab-55.png

  2. 如果你的依赖项目不是公开的， 软件包库不是公开的，需要使用 setting.xml 配置 server 标签填写访问凭证

  3. 如果使用的方式是 使用 Maven 中的 CI 作业令牌进行身份验证， 则需要在 被引用的项目（my-maven-app）中设置【允许来自以下项目的 CI 作业令牌访问此项目】，填写 引用项目 （use-my-maven-app） 的路径（不用填写域名），否则将会提示无权限

  4. 设置 【允许来自以下项目的 CI 作业令牌访问此项目】 gitlab-53.png

解决方案2：不设置 setting.xml 的 server

  1. 如果你的依赖项目是公开的， 软件包库是公开的，可以不使用 setting.xml 配置 server，即可访问
  2. 如果你配置了 setting.xml 配置 server，使用方式为 使用 Maven 中的 CI 作业令牌进行身份验证， 参考上一个解决方案

解决方案3：在 Maven 中使用个人访问令牌进行身份验证

解决方案4：在 Maven 中使用部署令牌进行身份验证

gitlab 17.0 会删除上述【允许来自以下项目的 CI 作业令牌访问此项目】的，待 gitlab 17.0 发布后，将会提供新方案

问题

maven 证书验证失败链接")

  1. 常见于自建 gitlab 中
  2. 失败示例 gitlab-45.png
  3. 打包时增加参数
参数解释0说明
-Dmaven.wagon.http.ssl.insecure=true不要验证SSL证书的有效性

号外号外！
极狐GitLab 正在推出DevSecOps 成熟度测评！链接：https://gitlab.cn/devsecops-assessment/ 测评非常全面并提供了可靠建议，即使不付费买产品，对自己想要落地 DevSecOps 的用户具有很高的参考意义！快来动手试试吧！

DevSecOps 成熟度评估.png

这篇关于如何使用极狐GitLab Maven 仓库？的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/869665。

相关文章

Java使用Thumbnailator库实现图片处理与压缩功能

Java使用Thumbnailator库实现图片处理与压缩功能

《Java使用Thumbnailator库实现图片处理与压缩功能》Thumbnailator是高性能Java图像处理库,支持缩放、旋转、水印添加、裁剪及格式转换,提供易用API和性能优化,适合Web应... 目录1. 图片处理库Thumbnailator介绍2. 基本和指定大小图片缩放功能2.1 图片缩放的
阅读更多...
Win10安装Maven与环境变量配置过程

Win10安装Maven与环境变量配置过程

《Win10安装Maven与环境变量配置过程》本文介绍Maven的安装与配置方法,涵盖下载、环境变量设置、本地仓库及镜像配置,指导如何在IDEA中正确配置Maven,适用于Java及其他语言项目的构建... 目录Maven 是什么？一、下载二、安装三、配置环境四、验证测试五、配置本地仓库六、配置国内镜像地址
阅读更多...
Python使用Tenacity一行代码实现自动重试详解

Python使用Tenacity一行代码实现自动重试详解

《Python使用Tenacity一行代码实现自动重试详解》tenacity是一个专为Python设计的通用重试库,它的核心理念就是用简单、清晰的方式,为任何可能失败的操作添加重试能力,下面我们就来看... 目录一切始于一个简单的 API 调用Tenacity 入门：一行代码实现优雅重试精细控制：让重试按我
阅读更多...
MySQL中EXISTS与IN用法使用与对比分析

MySQL中EXISTS与IN用法使用与对比分析

《MySQL中EXISTS与IN用法使用与对比分析》在MySQL中,EXISTS和IN都用于子查询中根据另一个查询的结果来过滤主查询的记录,本文将基于工作原理、效率和应用场景进行全面对比... 目录一、基本用法详解1. IN 运算符2. EXISTS 运算符二、EXISTS 与 IN 的选择策略三、性能对比
阅读更多...
使用Python构建智能BAT文件生成器的完美解决方案

使用Python构建智能BAT文件生成器的完美解决方案

《使用Python构建智能BAT文件生成器的完美解决方案》这篇文章主要为大家详细介绍了如何使用wxPython构建一个智能的BAT文件生成器,它不仅能够为Python脚本生成启动脚本,还提供了完整的文... 目录引言运行效果图项目背景与需求分析核心需求技术选型核心功能实现1. 数据库设计2. 界面布局设计3
阅读更多...
使用IDEA部署Docker应用指南分享

使用IDEA部署Docker应用指南分享

《使用IDEA部署Docker应用指南分享》本文介绍了使用IDEA部署Docker应用的四步流程：创建Dockerfile、配置IDEADocker连接、设置运行调试环境、构建运行镜像,并强调需准备本... 目录一、创建 dockerfile 配置文件二、配置 IDEA 的 Docker 连接三、配置 Do
阅读更多...
Android Paging 分页加载库使用实践

Android Paging 分页加载库使用实践

《AndroidPaging分页加载库使用实践》AndroidPaging库是Jetpack组件的一部分,它提供了一套完整的解决方案来处理大型数据集的分页加载,本文将深入探讨Paging库... 目录前言一、Paging 库概述二、Paging 3 核心组件1. PagingSource2. Pager3.
阅读更多...
python使用try函数详解

python使用try函数详解

《python使用try函数详解》Pythontry语句用于异常处理,支持捕获特定/多种异常、else/final子句确保资源释放,结合with语句自动清理,可自定义异常及嵌套结构,灵活应对错误场景... 目录try 函数的基本语法捕获特定异常捕获多个异常使用 else 子句使用 finally 子句捕获所
阅读更多...
C++11右值引用与Lambda表达式的使用

C++11右值引用与Lambda表达式的使用

《C++11右值引用与Lambda表达式的使用》C++11引入右值引用,实现移动语义提升性能,支持资源转移与完美转发；同时引入Lambda表达式,简化匿名函数定义,通过捕获列表和参数列表灵活处理变量... 目录C++11新特性右值引用和移动语义左值 / 右值常见的左值和右值移动语义移动构造函数移动复制运算符
阅读更多...
Python对接支付宝支付之使用AliPay实现的详细操作指南

Python对接支付宝支付之使用AliPay实现的详细操作指南

《Python对接支付宝支付之使用AliPay实现的详细操作指南》支付宝没有提供PythonSDK,但是强大的github就有提供python-alipay-sdk,封装里很多复杂操作,使用这个我们就... 目录一、引言二、准备工作2.1 支付宝开放平台入驻与应用创建2.2 密钥生成与配置2.3 安装ali
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2