Artifact Registry provides a single location for managing private packages and Docker container images.
This quickstart shows you how to:
To follow step-by-step guidance for this task directly in the Google Cloud console, click Guide me:
Before you beginIn the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.Verify that billing is enabled for your Google Cloud project.
Enable the Artifact Registry API.
Make sure that you have the following role or roles on the project: Artifact Registry Administrator
Check for the rolesIn the Google Cloud console, go to the IAM page.
Go to IAMIn the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
In the Google Cloud console, go to the IAM page.
Go to IAMIn the New principals field, enter your user identifier. This is typically the email address for a Google Account.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.Verify that billing is enabled for your Google Cloud project.
Enable the Artifact Registry API.
Make sure that you have the following role or roles on the project: Artifact Registry Administrator
Check for the rolesIn the Google Cloud console, go to the IAM page.
Go to IAMIn the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
In the Google Cloud console, go to the IAM page.
Go to IAMIn the New principals field, enter your user identifier. This is typically the email address for a Google Account.
To complete this quickstart, use either Cloud Shell or your local shell.
To launch Cloud Shell, perform the following steps:
Go to Google Cloud console.
Click the Activate Cloud Shell button: .
A Cloud Shell session opens inside a frame lower on the console. You use this shell to run gcloud
commands.
To install gcloud CLI and Docker, perform the following steps:
Install the gcloud CLI. To update an existing installation, run the command gcloud components update
.
kubectl
or extensions to authenticate with Artifact Registry using the gcloud CLI.Install Docker if it is not already installed.
Docker requires privileged access to interact with registries. On Linux or Windows, add the user that you use to run Docker commands to the Docker security group. This step is not required on macOS since Docker Desktop runs on a virtual machine as the root user.
LinuxThe Docker security group is called docker
. To add your username, run the following command:
sudo usermod -a -G docker ${USER}
Windows
The Docker security group is called docker-users
. To add a user from the Administrator command prompt, run the following command:
net localgroup docker-users DOMAIN\USERNAME /add
Where
Log out and log back in for group membership changes to take effect. If you are using a virtual machine, you may need to restart the virtual machine for membership changes to take effect.
To ensure that Docker is running, run the following Docker command, which returns the current time and date:
docker run --rm busybox date
The --rm
flag deletes the container instance on exit.
Create a Docker repository to store the sample image for this quickstart.
ConsoleOpen the Repositories page in the Google Cloud console.
Click add Create Repository.
Specify quickstart-docker-repo
as the repository name.
Choose Docker as the format and Standard as the mode.
Under Location Type, select Region and then choose the location us-west1
.
Click Create.
The repository is added to the repository list.
gcloudRun the following command to create a new Docker repository named quickstart-docker-repo
in the location us-west1
with the description "docker repository".
gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
--location=us-west1 --description="Docker repository" \
--project=PROJECT
Where PROJECT is your Google Cloud project ID.
Run the following command to verify that your repository was created.
gcloud artifacts repositories list \
--project=PROJECT
For more information about Artifact Registry commands, run the command gcloud artifacts
.
Before you can push or pull images, configure Docker to use the Google Cloud CLI to authenticate requests to Artifact Registry.
To set up authentication to Docker repositories in the region us-west1
, run the following command:
gcloud auth configure-docker us-west1-docker.pkg.dev
The command updates your Docker configuration. You can now connect with Artifact Registry in your Google Cloud project to push and pull images.
For information about other authentication methods, see Authentication methods.
Obtain an image to pushFor this quickstart, you will push a sample image named hello-app
.
Run the following command to pull version 1.0 of the image.
docker pull us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0
Image paths in Artifact Registry include multiple parts. For this sample image:
us-docker.pkg.dev
is the hostname for container images stored in Artifact Registry Docker repositories, which includes the location of the repository (us
).google-samples
is the project ID.containers
is the repository ID./gke/hello-app
is the path to the image in the repository containers
.Before you push the Docker image to Artifact Registry, you must tag it with the repository name.
Tag the image with a registry nameTagging the Docker image with a repository name configures the docker push
command to push the image to a specific location. For this quickstart, the host location is us-west1-docker.pkg.dev
.
Run the following command to tag the image as quickstart-image:tag1
:
docker tag us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0 \ us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1
Where:
us-west1
is the repository location.us-west1-docker.pkg.dev
is the hostname for the Docker repository you created.:
), see Domain-scoped projects.quickstart-docker-repo
is the ID of the repository you created.quickstart-image
is the image name you want to use in the repository. The image name can be different than the local image name. For this quickstart you will store the image directly under the repository ID quickstart-docker-repo
.tag1
is a tag you're adding to the Docker image. If you didn't specify a tag, Docker will apply the default tag latest
.You are now ready to push the image to the repository you created.
Push the image to Artifact RegistryAfter you have configured authentication and tagged the local image, you can push the image to the repository that you created.
To push the Docker image, run the following command:
docker push us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1Replace PROJECT with your Google Cloud project ID. If your project ID contains a colon (
:
), see Domain-scoped projects. Pull the image from Artifact Registry
To pull the image from Artifact Registry onto your local machine, run the following command:
docker pull us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1Replace PROJECT with your Google Cloud project ID. If your project ID contains a colon (
:
), see Domain-scoped projects.
latest: Pulling from [PROJECT-ID]/quickstart-image:tag1 Digest: sha256:70c42... Status: Image is up to date for us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1Clean up
To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.
Before you remove the repository, ensure that any images you want to keep are available in another location.
To delete the repository:
ConsoleOpen the Repositories page in the Google Cloud console.
In the repository list, select the quickstart-docker-repo
repository.
Click Delete.
To delete the quickstart-docker-repo
repository, run the following command:
gcloud artifacts repositories delete quickstart-docker-repo --location=us-west1What's next
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4