Pirate Praveen 54117d12b7 New upstream version 15.5.4+ds1

2022-11-25 23:54:43 +05:30

34 KiB

Raw Blame History

stage	group	info
Package	Package	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments

Maven packages in the Package Repository (FREE)

Moved from GitLab Premium to GitLab Free in 13.3.

Publish Maven artifacts in your project's Package Registry. Then, install the packages whenever you need to use them as a dependency.

For documentation of the specific API endpoints that the Maven package manager client uses, see the Maven API documentation.

Build a Maven package

This section explains how to install Maven and build a package.

If you already use Maven and know how to build your own packages, go to the next section.

Maven repositories work well with Gradle, too. To set up a Gradle project, see get started with Gradle.

Install Maven

The required minimum versions are:

Java 11.0.5+
Maven 3.6+

Follow the instructions at maven.apache.org to download and install Maven for your local development environment. After installation is complete, verify you can use Maven in your terminal by running:

mvn --version

The output should be similar to:

Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555; 2019-04-04T20:00:29+01:00)
Maven home: /Users/<your_user>/apache-maven-3.6.1
Java version: 12.0.2, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-12.0.2.jdk/Contents/Home
Default locale: en_GB, platform encoding: UTF-8
OS name: "mac os x", version: "10.15.2", arch: "x86_64", family: "mac"

Create a project

Follow these steps to create a Maven project that can be published to the GitLab Package Registry.

Open your terminal and create a directory to store the project.
From the new directory, run this Maven command to initialize a new package:
```
mvn archetype:generate -DgroupId=com.mycompany.mydepartment -DartifactId=my-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
```
The arguments are:
- DgroupId: A unique string that identifies your package. Follow the Maven naming conventions.
- DartifactId: The name of the JAR, appended to the end of the DgroupId.
- DarchetypeArtifactId: The archetype used to create the initial structure of the project.
- DinteractiveMode: Create the project using batch mode (optional).

This message indicates that the project was set up successfully:

...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.429 s
[INFO] Finished at: 2020-01-28T11:47:04Z
[INFO] ------------------------------------------------------------------------

In the folder where you ran the command, a new directory should be displayed. The directory name should match the DartifactId parameter, which in this case, is my-project.

Build a Java project with Gradle

This section explains how to install Gradle and initialize a Java project.

If you already use Gradle and know how to build your own packages, go to the next section.

Install Gradle

If you want to create a new Gradle project, you must install Gradle. Follow instructions at gradle.org to download and install Gradle for your local development environment.

In your terminal, verify you can use Gradle by running:

gradle -version

To use an existing Gradle project, in the project directory, on Linux execute gradlew, or on Windows execute gradlew.bat.

The output should be similar to:

------------------------------------------------------------
Gradle 6.0.1
------------------------------------------------------------

Build time:   2019-11-18 20:25:01 UTC
Revision:     fad121066a68c4701acd362daf4287a7c309a0f5

Kotlin:       1.3.50
Groovy:       2.5.8
Ant:          Apache Ant(TM) version 1.10.7 compiled on September 1 2019
JVM:          11.0.5 (Oracle Corporation 11.0.5+10)
OS:           Windows 10 10.0 amd64

Create a Java project

Follow these steps to create a Maven project that can be published to the GitLab Package Registry.

Open your terminal and create a directory to store the project.

From this new directory, run this Maven command to initialize a new package:

gradle init

The output should be:

Select type of project to generate:
  1: basic
  2: application
  3: library
  4: Gradle plugin
Enter selection (default: basic) [1..4]

Enter 3 to create a new Library project. The output should be:

Select implementation language:
  1: C++
  2: Groovy
  3: Java
  4: Kotlin
  5: Scala
  6: Swift

Enter 3 to create a new Java Library project. The output should be:

Select build script DSL:
  1: Groovy
  2: Kotlin
Enter selection (default: Groovy) [1..2]

Enter 1 to create a new Java Library project that is described in Groovy DSL, or 2 to create one that is described in Kotlin DSL. The output should be:
```
Select test framework:
  1: JUnit 4
  2: TestNG
  3: Spock
  4: JUnit Jupiter
```
Enter 1 to initialize the project with JUnit 4 testing libraries. The output should be:
```
Project name (default: test):
```
Enter a project name or press Enter to use the directory name as project name.

Authenticate to the Package Registry with Maven

To authenticate to the Package Registry, you need one of the following:

A personal access token with the scope set to api.
A deploy token with the scope set to read_package_registry, write_package_registry, or both.
A CI_JOB_TOKEN.

Authenticate with a personal access token in Maven

To use a personal access token, add this section to your settings.xml file.

The name must be Private-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>

Authenticate with a deploy token in Maven

Introduced deploy token authentication in GitLab 13.0.

Moved from GitLab Premium to GitLab Free in 13.3.

To use a deploy token, add this section to your settings.xml file.

The name must be 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>

Authenticate with a CI job token in Maven

To authenticate with a CI job token, add this section to your settings.xml file.

The name must be Job-Token.

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

Authenticate to the Package Registry with Gradle

To authenticate to the Package Registry, you need either a personal access token or deploy token.

If you use a personal access token, set the scope to api.
If you use a deploy token, set the scope to read_package_registry, write_package_registry, or both.

Authenticate with a personal access token in Gradle

In your GRADLE_USER_HOME directory, create a file gradle.properties with the following content:

gitLabPrivateToken=REPLACE_WITH_YOUR_PERSONAL_ACCESS_TOKEN

Add a repositories section to your build.gradle file:

repositories {
    maven {
        url "https://gitlab.example.com/api/v4/groups/<group>/-/packages/maven"
        name "GitLab"
        credentials(HttpHeaderCredentials) {
            name = 'Private-Token'
            value = gitLabPrivateToken
        }
        authentication {
            header(HttpHeaderAuthentication)
        }
    }
}

Or add it to your build.gradle.kts file if you are using Kotlin DSL:

repositories {
    maven {
        url = uri("https://gitlab.example.com/api/v4/groups/<group>/-/packages/maven")
        name = "GitLab"
        credentials(HttpHeaderCredentials::class) {
            name = "Private-Token"
            value = findProperty("gitLabPrivateToken") as String?
        }
        authentication {
            create("header", HttpHeaderAuthentication::class)
        }
    }
}

Authenticate with a deploy token in Gradle

To authenticate with a deploy token, add a repositories section to your build.gradle file:

repositories {
    maven {
        url "https://gitlab.example.com/api/v4/groups/<group>/-/packages/maven"
        name "GitLab"
        credentials(HttpHeaderCredentials) {
            name = 'Deploy-Token'
            value = '<deploy-token>'
        }
        authentication {
            header(HttpHeaderAuthentication)
        }
    }
}

Or add it to your build.gradle.kts file if you are using Kotlin DSL:

repositories {
    maven {
        url = uri("https://gitlab.example.com/api/v4/groups/<group>/-/packages/maven")
        name = "GitLab"
        credentials(HttpHeaderCredentials::class) {
            name = "Deploy-Token"
            value = "<deploy-token>"
        }
        authentication {
            create("header", HttpHeaderAuthentication::class)
        }
    }
}

Authenticate with a CI job token in Gradle

To authenticate with a CI job token, add a repositories section to your build.gradle file:

repositories {
    maven {
        url "${CI_API_V4_URL}/groups/<group>/-/packages/maven"
        name "GitLab"
        credentials(HttpHeaderCredentials) {
            name = 'Job-Token'
            value = System.getenv("CI_JOB_TOKEN")
        }
        authentication {
            header(HttpHeaderAuthentication)
        }
    }
}

Or add it to your build.gradle.kts file if you are using Kotlin DSL:

repositories {
    maven {
        url = uri("$CI_API_V4_URL/groups/<group>/-/packages/maven")
        name = "GitLab"
        credentials(HttpHeaderCredentials::class) {
            name = "Job-Token"
            value = System.getenv("CI_JOB_TOKEN")
        }
        authentication {
            create("header", HttpHeaderAuthentication::class)
        }
    }
}

Use the GitLab endpoint for Maven packages

To use the GitLab endpoint for Maven packages, choose an option:

Project-level: To publish Maven packages to a project, use a project-level endpoint. To install Maven packages, use a project-level endpoint when you have few Maven packages and they are not in the same GitLab group.
Group-level: Use a group-level endpoint when you want to install packages from many different projects in the same GitLab group.
Instance-level: Use an instance-level endpoint when you want to install many packages from different GitLab groups or in their own namespace.

The option you choose determines the settings you add to your pom.xml file.

In all cases, to publish a package, you need:

A project-specific URL in the distributionManagement section.
A repository and distributionManagement section.

Project-level Maven endpoint

The relevant repository section of your pom.xml in Maven should look like this:

<repositories>
  <repository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url>
  </repository>
</repositories>
<distributionManagement>
  <repository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url>
  </repository>
  <snapshotRepository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url>
  </snapshotRepository>
</distributionManagement>

The corresponding section in Gradle Groovy DSL would be:

repositories {
    maven {
        url "https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven"
        name "GitLab"
    }
}

In Kotlin DSL:

repositories {
    maven {
        url = uri("https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven")
        name = "GitLab"
    }
}

The id is what you defined in settings.xml.
The PROJECT_ID is your project ID, which you can view on your project's home page.
Replace gitlab.example.com with your domain name.
For retrieving artifacts, use either the URL-encoded path of the project (like group%2Fproject) or the project's ID (like 42). However, only the project's ID can be used for publishing.

Group-level Maven endpoint

Moved from GitLab Premium to GitLab Free in 13.3.

If you rely on many packages, it might be inefficient to include the repository section with a unique URL for each package. Instead, you can use the group-level endpoint for all the Maven packages stored within one GitLab group. Only packages you have access to are available for download.

The group-level endpoint works with any package names, so you have more flexibility in naming, compared to the instance-level endpoint. However, GitLab does not guarantee the uniqueness of package names within the group. You can have two projects with the same package name and package version. As a result, GitLab serves whichever one is more recent.

This example shows the relevant repository section of your pom.xml file. You still need a project-specific URL for publishing a package in the distributionManagement section:

<repositories>
  <repository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/groups/GROUP_ID/-/packages/maven</url>
  </repository>
</repositories>
<distributionManagement>
  <repository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url>
  </repository>
  <snapshotRepository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url>
  </snapshotRepository>
</distributionManagement>

For Gradle, the corresponding repositories section in Groovy DSL would look like:

repositories {
    maven {
        url "https://gitlab.example.com/api/v4/groups/GROUP_ID/-/packages/maven"
        name "GitLab"
    }
}

In Kotlin DSL:

repositories {
    maven {
        url = uri("https://gitlab.example.com/api/v4/groups/GROUP_ID/-/packages/maven")
        name = "GitLab"
    }
}

For the id, use what you defined in settings.xml.
For GROUP_ID, use your group ID, which you can view on your group's home page.
For PROJECT_ID, use your project ID, which you can view on your project's home page.
Replace gitlab.example.com with your domain name.
For retrieving artifacts, use either the URL-encoded path of the group (like group%2Fsubgroup) or the group's ID (like 12).

Instance-level Maven endpoint

Moved from GitLab Premium to GitLab Free in 13.3.

If you rely on many packages, it might be inefficient to include the repository section with a unique URL for each package. Instead, you can use the instance-level endpoint for all Maven packages stored in GitLab. All packages you have access to are available for download.

Only packages that have the same path as the project are exposed by the instance-level endpoint.

Project	Package	Instance-level endpoint available
`foo/bar`	`foo/bar/1.0-SNAPSHOT`	Yes
`gitlab-org/gitlab`	`foo/bar/1.0-SNAPSHOT`	No
`gitlab-org/gitlab`	`gitlab-org/gitlab/1.0-SNAPSHOT`	Yes

This example shows how relevant repository section of your pom.xml. You still need a project-specific URL in the distributionManagement section.

<repositories>
  <repository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/packages/maven</url>
  </repository>
</repositories>
<distributionManagement>
  <repository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url>
  </repository>
  <snapshotRepository>
    <id>gitlab-maven</id>
    <url>https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven</url>
  </snapshotRepository>
</distributionManagement>

The corresponding repositories section in Gradle Groovy DSL would look like:

repositories {
    maven {
        url "https://gitlab.example.com/api/v4/packages/maven"
        name "GitLab"
    }
}

In Kotlin DSL:

repositories {
    maven {
        url = uri("https://gitlab.example.com/api/v4/packages/maven")
        name = "GitLab"
    }
}

The id is what you defined in settings.xml.
The PROJECT_ID is your project ID, which you can view on your project's home page.
Replace gitlab.example.com with your domain name.
For retrieving artifacts, use either the URL-encoded path of the project (like group%2Fproject) or the project's ID (like 42). However, only the project's ID can be used for publishing.

Publish a package

After you have set up the remote and authentication and configured your project, publish a Maven package to your project.

Publish by using Maven

To publish a package by using Maven:

mvn deploy

If the deploy is successful, the build success message should be displayed:

...
[INFO] BUILD SUCCESS
...

The message should also show that the package was published to the correct location:

Uploading to gitlab-maven: https://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven/com/mycompany/mydepartment/my-project/1.0-SNAPSHOT/my-project-1.0-20200128.120857-1.jar

Publish by using Gradle

To publish a package by using Gradle:

Add the Gradle plugin maven-publish to the plugins section:

In Groovy DSL:

plugins {
    id 'java'
    id 'maven-publish'
}

In Kotlin DSL:

plugins {
    java
    `maven-publish`
}

Add a publishing section:

In Groovy DSL:

publishing {
    publications {
        library(MavenPublication) {
            from components.java
        }
    }
    repositories {
        maven {
            url "https://gitlab.example.com/api/v4/projects/<PROJECT_ID>/packages/maven"
            credentials(HttpHeaderCredentials) {
                name = "Private-Token"
                value = gitLabPrivateToken // the variable resides in $GRADLE_USER_HOME/gradle.properties
            }
            authentication {
                header(HttpHeaderAuthentication)
            }
        }
    }
}

In Kotlin DSL:

publishing {
    publications {
        create<MavenPublication>("library") {
            from(components["java"])
        }
    }
    repositories {
        maven {
            url = uri("https://gitlab.example.com/api/v4/projects/<PROJECT_ID>/packages/maven")
            credentials(HttpHeaderCredentials::class) {
                name = "Private-Token"
                value =
                    findProperty("gitLabPrivateToken") as String? // the variable resides in $GRADLE_USER_HOME/gradle.properties
            }
            authentication {
                create("header", HttpHeaderAuthentication::class)
            }
        }
    }
}

Replace PROJECT_ID with your project ID, which can be found on your project's home page.
Run the publish task:
```
gradle publish
```

Now navigate to your project's Packages and registries page and view the published artifacts.

Publishing a package with the same name or version

When you publish a package with the same name and version as an existing package, the new package files are added to the existing package. You can still use the UI or API to access and view the existing package's older files.

To delete these older package versions, consider using the Packages API or the UI.

Do not allow duplicate Maven packages

Introduced in GitLab 13.9.

Required permissions changed from developer to maintainer in GitLab 15.0.

To prevent users from publishing duplicate Maven packages, you can use the GraphQl API or the UI.

In the UI:

For your group, go to Settings > Packages and registries.
Expand the Package Registry section.
Turn on the Reject duplicates toggle.
Optional. To allow some duplicate packages, in the Exceptions box, enter a regex pattern that matches the names and/or versions of packages you want to allow.

Your changes are automatically saved.

Install a package

To install a package from the GitLab Package Registry, you must configure the remote and authenticate. When this is completed, you can install a package from a project, group, or namespace.

If multiple packages have the same name and version, when you install a package, the most recently-published package is retrieved.

Use Maven with `mvn install`

To install a package by using mvn install:

Add the dependency manually to your project pom.xml file. To add the example created earlier, the XML would be:

<dependency>
  <groupId>com.mycompany.mydepartment</groupId>
  <artifactId>my-project</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

In your project, run the following:
```
mvn install
```

The message should show that the package is downloading from the Package Registry:

Downloading from gitlab-maven: http://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven/com/mycompany/mydepartment/my-project/1.0-SNAPSHOT/my-project-1.0-20200128.120857-1.pom

Use Maven with `mvn dependency:get`

You can install packages by using the Maven dependency:get command directly.

In your project directory, run:
```
mvn dependency:get -Dartifact=com.nickkipling.app:nick-test-app:1.1-SNAPSHOT -DremoteRepositories=gitlab-maven::::<gitlab endpoint url>  -s <path to settings.xml>
```
- <gitlab endpoint url> is the URL of the GitLab endpoint.
- <path to settings.xml> is the path to the settings.xml file that contains the authentication details.

NOTE: The repository IDs in the command(gitlab-maven) and the settings.xml file must match.

The message should show that the package is downloading from the Package Registry:

Downloading from gitlab-maven: http://gitlab.example.com/api/v4/projects/PROJECT_ID/packages/maven/com/mycompany/mydepartment/my-project/1.0-SNAPSHOT/my-project-1.0-20200128.120857-1.pom

NOTE: In the GitLab UI, on the Package Registry page for Maven, you can view and copy these commands.

Use Gradle

Add a dependency to build.gradle in the dependencies section:

dependencies {
    implementation 'com.mycompany.mydepartment:my-project:1.0-SNAPSHOT'
}

Or to build.gradle.kts if you are using Kotlin DSL:

dependencies {
    implementation("com.mycompany.mydepartment:my-project:1.0-SNAPSHOT")
}

Request forwarding to Maven Central

Introduced behind a feature flag, disabled by default in GitLab 15.4

FLAG: On self-managed GitLab, by default this feature is not available. To make it available, ask an administrator to enable the feature flag named maven_central_request_forwarding. On GitLab.com, this feature is not available.

When a Maven package is not found in the Package Registry, the request is forwarded to Maven Central.

When the feature flag is enabled, administrators can disable this behavior in the Continuous Integration settings.

There are many ways to configure your Maven project so that it will request packages in Maven Central from GitLab. Maven repositories are queried in a specific order. By default, maven-central is usually checked first through the Super POM, so GitLab needs to be configured to be queried before maven-central.

Using GitLab as a mirror of the central proxy is one way to force GitLab to be queried in place of maven-central.

Maven forwarding is restricted to only the project level and group level endpoints. The instance level endpoint has naming restrictions that prevent it from being used for packages that don't follow that convention and also introduces too much security risk for supply-chain style attacks.

Setting GitLab as a mirror for the central proxy

To ensure all package requests are sent to GitLab instead of Maven Central, you can override Maven Central as the central repository by adding a <mirror> section to your settings.xml:

<settings>
  <servers>
    <server>
      <id>central-proxy</id>
      <configuration>
        <httpHeaders>
          <property>
            <name>Private-Token</name>
            <value>{personal_access_token}</value>
          </property>
        </httpHeaders>
      </configuration>
    </server>
  </servers>
  <mirrors>
    <mirror>
      <id>central-proxy</id>
      <name>GitLab proxy of central repo</name>
      <url>https://gitlab.example.com/api/v4/projects/{project_id}/packages/maven</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>
</settings>

Remove a package

For your project, go to Packages and registries > Package Registry.

To remove a package, select the red trash icon or, from the package details, the Delete button.

Create Maven packages with GitLab CI/CD

After you have configured your repository to use the Package Repository for Maven, you can configure GitLab CI/CD to build new packages automatically.

Create Maven packages with GitLab CI/CD by using Maven

You can create a new package each time the main branch is updated.

Create a ci_settings.xml file that serves as Maven's settings.xml file.

Add the server section with the same ID you defined in your pom.xml file. For example, use gitlab-maven as the ID:

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

Make sure your pom.xml file includes the following. You can either let Maven use the predefined CI/CD variables, as shown in this example, or you can hard code your server's hostname and project's ID.

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

Add a deploy job to your .gitlab-ci.yml file:

deploy:
  image: maven:3.6-jdk-11
  script:
    - 'mvn deploy -s ci_settings.xml'
  only:
    - main

Push those files to your repository.

The next time the deploy job runs, it copies ci_settings.xml to the user's home location. In this example:

The user is root, because the job runs in a Docker container.
Maven uses the configured CI/CD variables.

Create Maven packages with GitLab CI/CD by using Gradle

You can create a package each time the main branch is updated.

Authenticate with a CI job token in Gradle.

Add a deploy job to your .gitlab-ci.yml file:

deploy:
  image: gradle:6.5-jdk11
  script:
    - 'gradle publish'
  only:
    - main

Commit files to your repository.

When the pipeline is successful, the package is created.

Version validation

The version string is validated by using the following regex.

\A(?!.*\.\.)[\w+.-]+\z

You can play around with the regex and try your version strings on this regular expression editor.

Troubleshooting

To improve performance, Maven caches files related to a package. If you encounter issues, clear the cache with these commands:

rm -rf ~/.m2/repository

If you're using Gradle, run this command to clear the cache:

rm -rf ~/.gradle/caches # Or replace ~/.gradle with your custom GRADLE_USER_HOME

Review network trace logs

If you are having issues with the Maven Repository, you may want to review network trace logs.

For example, try to run mvn deploy locally with a PAT token and use these options:

mvn deploy \
-Dorg.slf4j.simpleLogger.log.org.apache.maven.wagon.providers.http.httpclient=trace \
-Dorg.slf4j.simpleLogger.log.org.apache.maven.wagon.providers.http.httpclient.wire=trace

WARNING: When you set these options, all network requests are logged and a large amount of output is generated.

Useful Maven command-line options

There are some Maven command-line options that you can use when performing tasks with GitLab CI/CD.

File transfer progress can make the CI logs hard to read. Option -ntp,--no-transfer-progress was added in 3.6.1. Alternatively, look at -B,--batch-mode or lower level logging changes.

Specify where to find the pom.xml file (-f,--file):

package:
  script:
    - 'mvn --no-transfer-progress -f helloworld/pom.xml package'

Specify where to find the user settings (-s,--settings) instead of the default location. There's also a -gs,--global-settings option:
```
package:
  script:
    - 'mvn -s settings/ci.xml package'
```

Verify your Maven settings

If you encounter issues within CI/CD that relate to the settings.xml file, try adding an additional script task or job to verify the effective settings.

The help plugin can also provide system properties, including environment variables:

mvn-settings:
  script:
    - 'mvn help:effective-settings'

package:
  script:
    - 'mvn help:system'
    - 'mvn package'

Supported CLI commands

The GitLab Maven repository supports the following Maven CLI commands:

mvn deploy: Publish your package to the Package Registry.
mvn install: Install packages specified in your Maven project.
mvn dependency:get: Install a specific package.

34 KiB Raw Blame History

Maven packages in the Package Repository (FREE)

Build a Maven package

Install Maven

Create a project

Build a Java project with Gradle

Install Gradle

Create a Java project

Authenticate to the Package Registry with Maven

Authenticate with a personal access token in Maven

Authenticate with a deploy token in Maven

Authenticate with a CI job token in Maven

Authenticate to the Package Registry with Gradle

Authenticate with a personal access token in Gradle

Authenticate with a deploy token in Gradle

Authenticate with a CI job token in Gradle

Use the GitLab endpoint for Maven packages

Project-level Maven endpoint

Group-level Maven endpoint

Instance-level Maven endpoint

Publish a package

Publish by using Maven

Publish by using Gradle

Publishing a package with the same name or version

Do not allow duplicate Maven packages

Install a package

Use Maven with mvn install

Use Maven with mvn dependency:get

Use Gradle

Request forwarding to Maven Central

Setting GitLab as a mirror for the central proxy

Remove a package

Create Maven packages with GitLab CI/CD

Create Maven packages with GitLab CI/CD by using Maven

Create Maven packages with GitLab CI/CD by using Gradle

Version validation

Troubleshooting

Review network trace logs

Useful Maven command-line options

Verify your Maven settings

Supported CLI commands

34 KiB

Raw Blame History

Use Maven with `mvn install`

Use Maven with `mvn dependency:get`