arrow_back

Create a Container Artifact Registry and Upload Code

Sign in Join
Get access to 700+ labs and courses

Create a Container Artifact Registry and Upload Code

Lab 30 minutes universal_currency_alt 1 Credit show_chart Introductory
info This lab may incorporate AI tools to support your learning.
Get access to 700+ labs and courses

gem-artifact-registry-container

Google Cloud self-paced labs logo

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.

  1. Click Activate Cloud Shell Activate Cloud Shell icon 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.

  1. (Optional) You can list the active account name with this command:
gcloud auth list

  1. Click Authorize.

  2. 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`
  1. (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'll learn how to create an Artifact Registry repository for storing container images and then push a sample image to it. Artifact Registry provides a central location for managing and securing your container images and other build artifacts. This lab assumes familiarity with Docker and basic Google Cloud concepts.

Task 1. Enable the Artifact Registry API

Before you can use Artifact Registry, you need to enable the API for your project.

  1. Enable the Artifact Registry API.
gcloud services enable artifactregistry.googleapis.com Note:
This command enables the Artifact Registry API for your project.

Task 2. Create an Artifact Registry Repository

Now, create a Docker repository in Artifact Registry to store your container images. You'll need to choose a region for the repository.

  1. Set your project ID:
gcloud config set project {{{ project_0.project_id | "PROJECT_ID" }}} Note:
This command sets your active project identity.
  1. Set your default region to
gcloud config set compute/region {{{ project_0.default_region | "REGION" }}} Note:
This command sets your active compute region.
  1. Create a Docker repository named 'my-docker-repo' in Artifact Registry in the region.
gcloud artifacts repositories create my-docker-repo \ --repository-format=docker \ --location={{{ project_0.default_region | "REGION" }}} \ --description="Docker repository" Note:
This command creates a Docker repository.

Task 3. Configure Docker Authentication

To push and pull images, configure Docker to authenticate with Artifact Registry.

  1. Configure Docker authentication.
gcloud auth configure-docker {{{ project_0.default_region | "REGION" }}}-docker.pkg.dev Note:
This command configures Docker to authenticate with Artifact Registry.

Task 4. Build and Tag a Sample Docker Image

Let's build a simple Docker image and tag it for Artifact Registry. This example uses a simple nginx image.

  1. Create a simple Dockerfile.
mkdir sample-app cd sample-app echo "FROM nginx:latest" > Dockerfile Note:
This creates a basic Dockerfile.
  1. Build the Docker image. Replace with your project ID.
docker build -t nginx-image . Note:
This command builds the Docker image.
  1. Tag the Docker image for Artifact Registry. Replace and with your project ID and region.
docker tag nginx-image {{{ project_0.default_region | "REGION" }}}-docker.pkg.dev/{{{ project_0.project_id | "PROJECT_ID" }}}/my-docker-repo/nginx-image:latest Note:
This command tags the Docker image.

Task 5. Push the Docker Image to Artifact Registry

Now, push the tagged image to your Artifact Registry repository.

  1. Push the Docker image to Artifact Registry. Replace and with your project ID and region.
docker push {{{ project_0.default_region | "REGION" }}}-docker.pkg.dev/{{{ project_0.project_id | "PROJECT_ID" }}}/my-docker-repo/nginx-image:latest Note:
This command pushes the Docker image to Artifact Registry.

Congratulations!

You have successfully created an Artifact Registry repository, built a Docker image, tagged it, and pushed it to Artifact Registry. You can now use this image in your deployments.

Additional Resources

Manual Last Updated Jun 23, 2025

Lab Last Tested Jun 23, 2025

Before you begin

  1. Labs create a Google Cloud project and resources for a fixed time
  2. Labs have a time limit and no pause feature. If you end the lab, you'll have to restart from the beginning.
  3. On the top left of your screen, click Start lab to begin

Use private browsing

  1. Copy the provided Username and Password for the lab
  2. Click Open console in private mode

Sign in to the Console

  1. Sign in using your lab credentials. Using other credentials might cause errors or incur charges.
  2. Accept the terms, and skip the recovery resource page
  3. Don't click End lab unless you've finished the lab or want to restart it, as it will clear your work and remove the project

This content is not currently available

We will notify you via email when it becomes available

Great!

We will contact you via email if it becomes available

One lab at a time

Confirm to end all existing labs and start this one

Use private browsing to run the lab

Use an Incognito or private browser window to run this lab. This prevents any conflicts between your personal account and the Student account, which may cause extra charges incurred to your personal account.