Create a Maven Artifact Registry and Upload Code

Activate Cloud Shell

Cloud Shell is a virtual machine that is loaded with development tools. It offers a persistent 5GB home directory and runs on the Google Cloud. Cloud Shell provides command-line access to your Google Cloud resources.

Click Activate Cloud Shell

at the top of the Google Cloud console.

When you are connected, you are already authenticated, and the project is set to your PROJECT_ID. The output contains a line that declares the PROJECT_ID for this session:

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud is the command-line tool for Google Cloud. It comes pre-installed on Cloud Shell and supports tab-completion.

(Optional) You can list the active account name with this command:

gcloud auth list

Click Authorize.
Your output should now look like this:

Output:

ACTIVE: *
ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

(Optional) You can list the project ID with this command:

gcloud config list project

Output:

[core]
project = <project_ID>

Example output:

[core]
project = qwiklabs-gcp-44776a13dea667a6

Note: For full documentation of gcloud, in Google Cloud, refer to the gcloud CLI overview guide.

Overview

In this lab, you will learn how to create a Maven Artifact Registry in Google Cloud and upload a sample Maven project to it. You'll use the gcloud CLI and Maven commands to interact with Artifact Registry, enabling you to store and manage your Java dependencies effectively. This lab assumes you have basic familiarity with Google Cloud, Maven, and command-line operations.

Task 1. Enable Artifact Registry API and Configure gcloud

Enable the Artifact Registry API and configure the gcloud CLI to interact with your Google Cloud project.

Enable the Artifact Registry API:

gcloud services enable artifactregistry.googleapis.com

Note:
This command enables the Artifact Registry API in your project.

Set your Project ID: qwiklabs-gcp-02-cf0b9c197435

gcloud config set project qwiklabs-gcp-02-cf0b9c197435

Note:
This command sets your active project identity.

Set your default region to us-central1

gcloud config set compute/region us-central1

Note:
This command sets your active compute region.

Task 2. Create a Maven Repository in Artifact Registry

Create a new Maven repository in Artifact Registry to store your Maven artifacts.

Create a new Maven repository in Artifact Registry.

gcloud artifacts repositories create my-maven-repo \
    --repository-format=maven \
    --location=us-central1 \
    --description="Maven repository"

Note:
Replace my-maven-repo with your desired repository name.

Verify the repository was created successfully by listing the available repositories.

gcloud artifacts repositories list --location=us-central1

Note:
This command lists all Artifact Registry repositories in the specified region.

Task 3. Configure Maven for Artifact Registry

Configure Maven to authenticate with Artifact Registry.

Configure Maven authentication using the gcloud CLI.

gcloud artifacts print-settings mvn --repository=my-maven-repo --project=qwiklabs-gcp-02-cf0b9c197435 --location=us-central1

Note:
Replace my-maven-repo with your desired repository name. This command generates XML configuration for Maven.

The output from the previous command will be similar to below:

<project>
<distributionmanagement>
<snapshotrepository>
<id>artifact-registry</id>
<url>artifactregistry://us-central1-maven.pkg.dev/qwiklabs-gcp-02-cf0b9c197435/my-maven-repo</url>
</snapshotrepository>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-central1-maven.pkg.dev/qwiklabs-gcp-02-cf0b9c197435/my-maven-repo</url>
</repository>
</distributionmanagement>
<repositories>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-central1-maven.pkg.dev/qwiklabs-gcp-02-cf0b9c197435/my-maven-repo</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<build>
<extensions>
<extension>
<groupid>com.google.cloud.artifactregistry</groupid>
<artifactid>artifactregistry-maven-wagon</artifactid>
<version>2.2.0</version>
</extension>
</extensions>
</build>
</project>

Note:
The output provides a valuable template that can be used to define the settings for an example Maven configuration.

Task 4. Create and Deploy a Sample Maven Project

Create a sample Maven project and deploy it to Artifact Registry.

Create a new Maven project using the mvn archetype:generate command. Choose a suitable archetype (e.g., maven-archetype-quickstart).

mvn archetype:generate \
    -DgroupId=com.example \
    -DartifactId=my-app \
    -Dversion=1.0-SNAPSHOT \
    -DarchetypeArtifactId=maven-archetype-quickstart \
    -DinteractiveMode=false

Note:
This command generates a basic Maven project structure. On successful completion a file pom.xml will be generated in the designated folder.

Navigate to the project directory.

cd my-app

Note:
Change directory to your new maven app

Output the mvn Artifact Registry settings to a file example.xml.

gcloud artifacts print-settings mvn --repository=my-maven-repo --project=qwiklabs-gcp-02-cf0b9c197435 --location=us-central1 > example.pom

Note:
If you are unsure how to make the edits, use the example.xml file to validate the sample application settings.

Update the generated pom.xml file to include the Artifact Registry repository information for deployment. Add a <distributionManagement> section:

<distributionmanagement>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-central1-maven.pkg.dev/qwiklabs-gcp-02-cf0b9c197435/my-maven-repo</url>
</repository>
<snapshotrepository>
<id>artifact-registry</id>
<url>artifactregistry://us-central1-maven.pkg.dev/qwiklabs-gcp-02-cf0b9c197435/my-maven-repo</url>
</snapshotrepository>
</distributionmanagement>

Note:
Place the new distributionManagement xml section within the project block of the pom.xml.

Add a build section to provider Artifact Registry Authentication in the pom.xml

<build>
<extensions>
<extension>
<groupid>com.google.cloud.artifactregistry</groupid>
<artifactid>artifactregistry-maven-wagon</artifactid>
<version>2.2.0</version> </extension>
</extensions>
</build>

Note:
Place the new build xml section within the project block of the pom.xml.

The updated pom.xml will look similar to below:

<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/maven-v4_0_0.xsd">
<modelversion>4.0.0</modelversion>
<groupid>com.example</groupid>
<artifactid>my-app</artifactid>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>my-app</name>
<url>http://maven.apache.org</url>
<build>
<extensions>
<extension>
<groupid>com.google.cloud.artifactregistry</groupid>
<artifactid>artifactregistry-maven-wagon</artifactid>
<version>2.2.0</version> </extension>
</extensions>
</build>
<distributionmanagement>
<snapshotrepository>
<id>artifact-registry</id>
<url>artifactregistry://us-central1-maven.pkg.dev/qwiklabs-gcp-02-cf0b9c197435/my-maven-repo</url>
</snapshotrepository>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-central1-maven.pkg.dev/qwiklabs-gcp-02-cf0b9c197435/my-maven-repo</url>
</repository>
</distributionmanagement>
<dependencies>
<dependency>
<groupid>junit</groupid>
<artifactid>junit</artifactid>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>

Note:
The above changes enable the build process to interact with Artifact Registry.

Deploy the artifact to Artifact Registry using the mvn deploy command.

mvn deploy

Note:
This command deploys the Maven artifact to Artifact Registry.

Task 5. Validate Artifact Registry

Verify the artifact was deployed successfully by navigating to your Artifact Registry repository in the Google Cloud Console or by listing the artifacts using the gcloud CLI.

gcloud artifacts versions list --repository=my-maven-repo --package=com.example:my-app --location=us-central1

Note:
This command lists package in the specified repository.

Verify that your package is listed in the Artifact Registry repository.

PACKAGE: my-package
CREATE_TIME: 2025-06-25T06:06:10
UPDATE_TIME: 2025-06-25T06:06:11
ANNOTATIONS:

Solution of Lab

https://youtu.be/TYHBORCpV-8

curl -LO raw.githubusercontent.com/Techcps/Google-Cloud-Skills-Boost/master/Create%20a%20Maven%20Artifact%20Registry%20and%20Upload%20Code/techcps.sh
sudo chmod +x techcps.sh
./techcps.sh

David Nguyen