Gitlab Package Registry 使用

一、介绍

Package Registry 是一个包管理工具,相当于私有的maven仓库,是Gitlab的新功能,这样你就不用额外的搭建maven仓库了。

二、环境配置

1.Java 11.0.5+

2.Maven 3.6+

3.配置maven的setings.xml

1> 配置一下personal access token

<settings>
  <servers>
    <server>
      <id>gitlab-maven</id>
      <configuration>
        <httpHeaders>
          <property>
            <name>Private-Token</name>
            <value>REPLACE_WITH_YOUR_PERSONAL_ACCESS_TOKEN</value>
          </property>
        </httpHeaders>
      </configuration>
    </server>
  </servers>
</settings>

2> 配置deploy token

<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>

3> 配置Job-Token,这真是个巨坑,根本找不到这个CI_JOB_TOKEN,这个配置可以忽略,上面的两个配一个就行了,都配也行。

<settings>
  <servers>
    <server>
      <id>gitlab-maven</id>
      <configuration>
        <httpHeaders>
          <property>
            <name>Job-Token</name>
            <value>${env.CI_JOB_TOKEN}</value>
          </property>
        </httpHeaders>
      </configuration>
    </server>
  </servers>
</settings>

4.Private-Token生成

5.Deploy-Token生成

三、使用Gitlab-CI方式构建一个Package

1.创建一个项目ci-demo

2.编写ci_settings.xml文件,这是固定写法,唯一可以改的是id

<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 http://maven.apache.org/xsd/settings-1.2.0.xsd">
    <servers>
        <server>
            <id>gitlab-maven</id>
            <configuration>
                <httpHeaders>
                    <property>
                        <name>Job-Token</name>
                        <value>${env.CI_JOB_TOKEN}</value>
                    </property>
                </httpHeaders>
            </configuration>
        </server>
    </servers>
</settings>

3.编写pom文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.example</groupId>
	<artifactId>demo</artifactId>
	<version>0.0.1.RELEASE</version>
	<packaging>jar</packaging>

	<name>demo</name>
	<description>Demo project for Spring Boot</description>

	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.1.3.RELEASE</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>

	<repositories>
		<repository>
			<id>gitlab-maven</id>
			<url>http://192.168.xx.xx/api/v4/projects/11/packages/maven</url>
		</repository>
	</repositories>
	<distributionManagement>
		<repository>
			<id>gitlab-maven</id>
			<url>http://192.168.xx.xx/api/v4/projects/11/packages/maven</url>
		</repository>
		<snapshotRepository>
			<id>gitlab-maven</id>
			<url>http://192.168.xx.xx/api/v4/projects/11/packages/maven</url>
		</snapshotRepository>
	</distributionManagement>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
		<java.version>11</java.version>
	</properties>

	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>


</project>

官方文档是这样的,其中CI_API_V4_URL为自己的gitlab服务器的地址+/api/v4,CI_PROJECT_ID为gitlab上Project ID,还需要注意的是,这里repository id 为ci_settings.xml中的id

<repositories>
  <repository>
    <id>gitlab-maven</id>
    <url>$env{CI_API_V4_URL}/projects/${env.CI_PROJECT_ID}/packages/maven</url>
  </repository>
</repositories>
<distributionManagement>
  <repository>
    <id>gitlab-maven</id>
    <url>${CI_API_V4_URL}/projects/${env.CI_PROJECT_ID}/packages/maven</url>
  </repository>
  <snapshotRepository>
    <id>gitlab-maven</id>
    <url>${CI_API_V4_URL}/projects/${env.CI_PROJECT_ID}/packages/maven</url>
  </snapshotRepository>
</distributionManagement>

我的项目为11

 4.编写.gitlab-ci.yml文件

deploy:
  image: maven:3.6-jdk-11
  script:
    - echo "deploy"
    - 'mvn deploy -s ci_settings.xml'
  only:
    - master
  tags:
    - demo

5.提交代码就会自动构建,生成一个package。

6.查看Package

四、使用本地配置,生成Package

1.创建一个项目

2.编写本地配置文件setting-local.xml

<settings>
    <servers>
        <server>
            <id>gitlab-maven</id>
            <configuration>
                <httpHeaders>
                    <property>
                        <name>Deploy-Token</name>
                        <value>rzusktVxxx-UvxrFDywj</value>
                    </property>
                </httpHeaders>
            </configuration>
        </server>
    </servers>
</settings>

3.编写pom 文件,同上,添加

<repositories>
  <repository>
    <id>gitlab-maven</id>
    <url>$env{CI_API_V4_URL}/projects/${env.CI_PROJECT_ID}/packages/maven</url>
  </repository>
</repositories>
<distributionManagement>
  <repository>
    <id>gitlab-maven</id>
    <url>${CI_API_V4_URL}/projects/${env.CI_PROJECT_ID}/packages/maven</url>
  </repository>
  <snapshotRepository>
    <id>gitlab-maven</id>
    <url>${CI_API_V4_URL}/projects/${env.CI_PROJECT_ID}/packages/maven</url>
  </snapshotRepository>
</distributionManagement>

4.使用maven 发布命令发布Package

mvn deploy -s setting-loacl.xml

5.发布包打印结果

6.gitlab服务器上查看Package,也能成功,具体使用哪一种就看自己需求了。

五、使用gitlab Package Registry中的Package

只需要在pom.xml文件中添加

1.dependence

<dependency>
   <groupId>com.example</groupId>
   <artifactId>demo</artifactId>
   <version>0.0.1-SNAPSHOT</version>
</dependency>

2.仓库地址

<repositories>
	<repository>
		<id>gitlab-maven</id>
		<url>http://192.168.xx.xx/api/v4/projects/11/packages/maven</url>
	</repository>
</repositories>

3.下载的jar包可以查看到

六、问题总结

1. No compiler is provided in this environment,遇到这个问题,需要将安装gitlab-runner的服务器上的JDK升级到11+

 

 2. git fetch-pack:expected shallow list ,这是因为gitlab-runner安装的时候自带的git版本过低,需要升级git版本。

git版本升级命令

#移除当前的git
yum remove git
#安装源
yum install http://opensource.wandisco.com/centos/7/git/x86_64/wandisco-git-release-7-2.noarch.rpm
#安装git
yum install git
#更新git
yum update git

 3. 报401都是没有授权,要在maven中配置server,填写token 

4.还有一个问题忘记了,但是是因为maven设置settings.xml文件中配置了阿里maven仓库,我们服务器请求后会转发,导致需要的pom文件变成html,解决方法就是去掉阿里maven仓库的配置。

好了,顺便说一下,我的版本是gitlab14.0.3,如果没有这个功能的可以升级一下。

<think>好的,我需要帮助用户了解如何使用GitLab进行项目管理和代码协作。首先,我要回顾用户提供的引用内容,确保回答中包含相关信息。根据引用[1]和[2],GitLab是一个DevOps平台,支持源代码托管、持续集成和项目管理。用户需要教程,所以应该分步骤讲解,涵盖项目创建、问题跟踪、合并请求等关键功能。 接下来,我需要按照用户的结构要求,确保行内公式正确使用$符号,但这里可能不太涉及数学公式,更多是功能步骤。不过要注意独立公式的格式,如果有的话。但在这个主题中可能不需要,所以主要关注功能说明和操作步骤。 用户要求生成相关问题,我需要根据内容提出相关问题,比如GitLab与其他工具的比较,权限管理,CI/CD配置等。同时,引用要正确标注,比如在提到极狐GitLab时添加[^1],在功能描述时引用[^2]。 需要检查LaTeX语法,但这里可能用不上,但如果有任何技术术语或代码块,要正确使用反引号。例如,在提到分支命令时使用代码块。 最后,确保回答结构清晰,分点说明,并自然地融入引用。可能的结构包括:项目创建与管理、代码协作流程、CI/CD集成、权限管理、文档协作等部分。每个部分给出具体步骤或方法,并附上引用来源。 现在开始组织内容,确保每个部分简洁明了,符合用户的要求,并生成相关问题。</think># GitLab项目管理和代码协作使用教程 ## 一、项目创建与管理 1. **项目初始化** - 通过极狐GitLab控制台点击`New project`创建项目,可选择空白项目/导入现有代码[^1] - 支持创建`.gitlab-ci.yml`文件实现自动化流水线,引用[2]提到其CI/CD功能 - 示例代码仓库初始化: ```bash git clone https://gitlab.cn/your-project.git cd your-project touch README.md git add . git commit -m "项目初始化" git push origin main ``` 2. **问题跟踪(Issue Tracking)** - 使用`Issues`面板创建任务卡片,支持标签分类、里程碑设置 - 通过`/assign @username`指派负责人,实现敏捷开发管理 ## 二、代码协作流程 1. **分支策略** - 主分支保护:设置`main`分支为受保护分支,禁止直接推送 - 功能开发:创建特性分支`feature/*`,提交格式:`git checkout -b feature/login-module` 2. **合并请求(Merge Request)** - 开发完成后发起MR,触发代码评审 - 使用`Changes`选项卡进行行级评论,支持讨论线程 - 通过`Approval Rules`设置必须的审批人数 ## 三、CI/CD集成 1. 流水线配置示例: ```yaml stages: - build - test - deploy build_job: stage: build script: - mvn package test_job: stage: test script: - mvn test ``` 2. 制品管理:使用`Package Registry`存储构建产物 ## 四、权限管理 - 通过`Members`添加协作者,设置角色(Guest/Reporter/Developer/Maintainer) - 使用`Protected Branches`控制代码合并权限 - 创建子组实现多项目统一管理[^1] ## 五、文档协作 - 内置Wiki系统支持Markdown文档编写 - 使用`Snippets`共享代码片段 - 通过`Web IDE`实现浏览器内协同编辑
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值