gem-artifact-registry-go

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

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

gcloud auth list

3. Click Authorize.

4. 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`

5. (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 an Artifact Registry repository for Go packages and upload a sample Go module to it. This allows you to manage and share Go packages within your Google Cloud environment. This lab focuses on using Artifact Registry for container images.

Task 1. Create an Artifact Registry Repository

First, you'll create a new Artifact Registry repository to store your Go packages. Choose a name and region for your repository.

1. Enable the Artifact Registry API.

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

2. Set your Project ID is:

gcloud config set project {{{ project_0.project_id | "PROJECT_ID" }}} Note:
This command sets your active project identity.

3. Set your default region to

gcloud config set compute/region {{{ project_0.default_region | "REGION" }}} Note:
This command sets your active compute region.

4. Create a new Artifact Registry repository. Ensure you are using a supported region ().

gcloud artifacts repositories create my-go-repo \ --repository-format=go \ --location={{{ project_0.default_region | "REGION" }}} \ --description="Go repository" Note:
This command creates the Artifact Registry repository.

5. Verify the repository was created successfully. Replace my-go-repo with your repository name.

gcloud artifacts repositories describe my-go-repo \ --location={{{ project_0.default_region | "REGION" }}} Note:
This command describes the Artifact Registry repository.

Task 2. Configure Go to Use Artifact Registry

Next, you'll configure your Go environment to use the newly created Artifact Registry repository.

1. Set the GOPRIVATE environment variable. Replace with your Google Cloud project ID.

go env -w GOPRIVATE=cloud.google.com/{{{ project_0.project_id | "PROJECT_ID" }}} Note:
This command sets the GOPRIVATE environment variable.

2. Configure go to authenticate with Artifact Registry. Replace with your repository's region and with your Google Cloud project ID.

export GONOPROXY=github.com/GoogleCloudPlatform/artifact-registry-go-tools GOPROXY=proxy.golang.org go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@latest add-locations --locations={{{ project_0.default_region | "REGION" }}} Note:
This command configures go to authenticate with Artifact Registry using application default credentials.

Task 3. Create a Sample Go Module

Now, let's create a simple Go module to upload to the Artifact Registry.

1. Create a directory for your Go module. Replace hello with desired directory name.

mkdir hello cd hello Note:
This command creates the module directory and navigates into it.

2. Initialize the Go module.

go mod init labdemo.app/hello Note:
This command initializes the Go module.

3. Create a hello.go file with the following content:

package main import "fmt" func main() { fmt.Println("Hello, Go module from Artifact Registry!") } Note:
This code defines a simple Go program.

4. Optional: Verify the go module builds

go build Note:
This command builds the go module.

Task 4. Set up Version control

Add version control information to the environment.

1. Setup the user email

git config --global user.email {{{ user_0.username | "EMAIL" }}}

2. Setup the user name

git config --global user.name cls

3. Set the default branch naming as main

git config --global init.defaultBranch main

4. Initialize a git repo

git init

5. Add the files to the repository

git add .

6. Add a commit message

git commit -m "Initial commit"

7. Tag the files

git tag v1.0.0

Task 5. Upload the Go Module to Artifact Registry

Finally, you'll upload the Go module to your Artifact Registry repository.

1. Upload the module to Artifact Registry using the go upload command. Replace with your repository's region, my-go-repo with your repository name.

gcloud artifacts go upload \ --repository=my-go-repo \ --location={{{ project_0.default_region | "REGION" }}} \ --module-path=labdemo.app/hello \ --version=v1.0.0 \ --source=. Note:
This command uploads the Go module to Artifact Registry.

2. Verify the module has been pushed.

gcloud artifacts packages list --repository=my-go-repo --location={{{ project_0.default_region | "REGION" }}} Note:
This command lists Go packages in the Artifact Registry. You can verify that your package exists.

Congratulations!

You have successfully created an Artifact Registry repository for Go packages, configured your Go environment, and uploaded a sample Go module. This allows you to share and manage Go modules within your Google Cloud environment.

Additional Resources

• Artifact Registry Documentation

• Go Modules Reference

Manual Last Updated Jun 23, 2025

Lab Last Tested Jun 23, 2025