Upgrade & Secure Your Future with DevOps, SRE, DevSecOps, MLOps!

We spend hours scrolling social media and waste money on things we forget, but won’t spend 30 minutes a day earning certifications that can change our lives.
Master in DevOps, SRE, DevSecOps & MLOps by DevOpsSchool!

Learn from Guru Rajesh Kumar and double your salary in just one year.


Get Started Now!

GitLab Deploy – Package Registry – A Complete Guide


🏗️ 1. Ensure Your GitLab Project Is Maven-Ready

To store your Java packages (JAR/WAR) into the GitLab Package Registry using GitLab CI/CD (SaaS, version 18.x), you can use GitLab’s built-in Maven repository support.

Here’s a step-by-step guide to:

✅ Build your Java project
✅ Upload the .jar or .war to GitLab’s Maven Package Registry
✅ Do this all through your .gitlab-ci.yml pipeline

In your project root:

Ensure pom.xml (for Maven) is set up with:

<project>
  ...
  <groupId>com.example</groupId>
  <artifactId>my-app</artifactId>
  <version>1.0.0</version>
  ...
</project>
Code language: HTML, XML (xml)

🧪 2. GitLab Package Registry URL

GitLab SaaS Maven registry endpoint:

https://gitlab.com/api/v4/projects/<PROJECT_ID>/packages/maven
Code language: HTML, XML (xml)

You can find <PROJECT_ID> in your GitLab project settings or by using:

https://gitlab.com/<namespace>/<project_name>
Code language: HTML, XML (xml)

🔐 3. Create a CI/CD Job to Publish Artifact

.gitlab-ci.yml example for Maven:

stages:
  - build
  - publish

variables:
  MAVEN_CLI_OPTS: "-B -DskipTests"

build-job:
  stage: build
  image: maven:3.8.7-jdk-11
  script:
    - mvn $MAVEN_CLI_OPTS clean package
  artifacts:
    paths:
      - target/*.jar
      - target/*.war

publish-job:
  stage: publish
  image: maven:3.8.7-jdk-11
  script:
    - mvn deploy -s settings.xml
  only:
    - main
Code language: PHP (php)

⚙️ 4. Add settings.xml for GitLab Auth

In the root of your repo (or dynamically generate in CI):

<settings>
  <servers>
    <server>
      <id>gitlab</id>
      <username>gitlab-ci-token</username>
      <password>${env.CI_JOB_TOKEN}</password>
    </server>
  </servers>
</settings>
Code language: HTML, XML (xml)

Ensure your pom.xml contains:

<distributionManagement>
  <repository>
    <id>gitlab</id>
    <url>https://gitlab.com/api/v4/projects/<PROJECT_ID>/packages/maven</url>
  </repository>
</distributionManagement>
Code language: HTML, XML (xml)

🛡️ 5. Use the CI_JOB_TOKEN Securely

  • gitlab-ci-token is a special user recognized by GitLab’s package registry.
  • CI_JOB_TOKEN is auto-injected in GitLab CI/CD and scoped to your project.

📦 6. Check Published Packages

After the pipeline completes:

  1. Go to your GitLab project
  2. Click on Packages & Registries → Package Registry
  3. You’ll see your .jar or .war listed

🧠 Bonus: Clean Up or Promote Packages

You can add manual jobs to:

  • Promote packages to another environment
  • Delete old versions via API
  • Install them in another Java project using Maven:
<dependency>
  <groupId>com.example</groupId>
  <artifactId>my-app</artifactId>
  <version>1.0.0</version>
</dependency>
Code language: HTML, XML (xml)

✅ Summary

StepDescription
Build ArtifactUse mvn package in CI job
Upload to GitLabUse mvn deploy with GitLab Maven repo
AuthUse CI_JOB_TOKEN with gitlab-ci-token
ViewPackages tab in GitLab UI

How to use Package registry using Gradle

Here is a step-by-step guide to publish JAR/WAR packages from a Gradle-based Java project to GitLab’s Maven Package Registry, using GitLab SaaS 18.x.


✅ Overview

  • You’ll use GitLab’s Maven-compatible Package Registry
  • You’ll configure Gradle to use GitLab as a Maven repo
  • You’ll automate it using .gitlab-ci.yml and CI_JOB_TOKEN

📁 1. Setup Your Gradle Project

In your build.gradle file:

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

group = 'com.example'
version = '1.0.0'

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
        }
    }
    repositories {
        maven {
            name = "GitLab"
            url = uri("https://gitlab.com/api/v4/projects/<PROJECT_ID>/packages/maven")
            credentials {
                username = project.findProperty("gitlabUser") ?: System.getenv("CI_JOB_TOKEN")
                password = project.findProperty("gitlabToken") ?: System.getenv("CI_JOB_TOKEN")
            }
        }
    }
}
Code language: JavaScript (javascript)

Replace <PROJECT_ID> with your GitLab project ID. You can find it on the project homepage (e.g., gitlab.com/api/v4/projects/1234567).


🔐 2. No Hardcoded Credentials

Do not store username/token in code.

In CI/CD, GitLab will inject CI_JOB_TOKEN automatically. For local testing, you can override via gradle.properties or CLI:

gitlabUser=gitlab-ci-token
gitlabToken=<your personal access token>
Code language: HTML, XML (xml)

🧪 3. Test Locally (Optional)

./gradlew publish \
  -PgitlabUser=gitlab-ci-token \
  -PgitlabToken=<your GitLab personal access token>
Code language: HTML, XML (xml)

⚙️ 4. Create .gitlab-ci.yml

stages:
  - build
  - publish

variables:
  GRADLE_USER_HOME: "$CI_PROJECT_DIR/.gradle"

build-job:
  stage: build
  image: gradle:8.2.1-jdk17
  script:
    - gradle build

publish-job:
  stage: publish
  image: gradle:8.2.1-jdk17
  script:
    - gradle publish
  only:
    - main
Code language: JavaScript (javascript)

This will publish the JAR/WAR file to GitLab Package Registry on main branch only.


📦 5. Where to View Packages

After successful pipeline execution:

  • Navigate to Your Project → Packages & Registries → Package Registry
  • You’ll see the .jar or .war under your published Maven group.

🔁 6. How to Use in Other Projects

In another Gradle project, consume the published package:

repositories {
    maven {
        url = uri("https://gitlab.com/api/v4/projects/<PROJECT_ID>/packages/maven")
        credentials {
            username = 'gitlab-ci-token'
            password = System.getenv("CI_JOB_TOKEN") // or use .env or gradle.properties
        }
    }
}

dependencies {
    implementation 'com.example:your-artifact:1.0.0'
}
Code language: JavaScript (javascript)

✅ Summary Table

StepAction
build.gradleAdd maven-publish, configure GitLab Maven repo
CredentialsUse CI_JOB_TOKEN with gitlab-ci-token
.gitlab-ci.ymlRun gradle publish from CI/CD
Registry URLhttps://gitlab.com/api/v4/projects/<PROJECT_ID>/packages/maven
View PackagesProject → Packages & Registries → Package Registry

Subscribe
Notify of
guest
0 Comments
Newest
Oldest Most Voted
Inline Feedbacks
View all comments

Certification Courses

DevOpsSchool has introduced a series of professional certification courses designed to enhance your skills and expertise in cutting-edge technologies and methodologies. Whether you are aiming to excel in development, security, or operations, these certifications provide a comprehensive learning experience. Explore the following programs:

DevOps Certification, SRE Certification, and DevSecOps Certification by DevOpsSchool

Explore our DevOps Certification, SRE Certification, and DevSecOps Certification programs at DevOpsSchool. Gain the expertise needed to excel in your career with hands-on training and globally recognized certifications.

0
Would love your thoughts, please comment.x
()
x