gcloud docker

NAME
gcloud docker - enable Docker CLI access to Google Container Registry
SYNOPSIS
gcloud docker [--authorize-only , -a ] [--docker-host =DOCKER_HOST] [--server =SERVER,[SERVER ,…], -s SERVER ,[SERVER ,…]; default="gcr.io,us.gcr.io,eu.gcr.io,asia.gcr.io,staging-k8s.gcr.io,marketplace.gcr.io"] [GCLOUD_WIDE_FLAG] [-- DOCKER_ARGS …]
DESCRIPTION
(DEPRECATED) Enable Docker CLI access to Google Container Registry.

gcloud docker will not be supported for Docker client versions above 18.03.

As an alternative, use gcloud auth configure-docker to configure docker to use gcloud as a credential helper, then use docker as you would for non-GCR registries, e.g. docker pull gcr.io/project-id/my-image. Add --verbosity=error to silence this warning: gcloud docker --verbosity=error -- pull gcr.io/project-id/my-image.

See: https://cloud.google.com/container-registry/docs/support/deprecation-notices#gcloud-docker gcloud docker wraps Docker commands so that gcloud can inject the appropriate fresh authentication token into requests that interact with the Docker registry.

All Docker-specific flags are passed through to the underlying docker command. A full reference of Docker's command line options available after -- can be found here: https://docs.docker.com/engine/reference/commandline/cli/. You may also run gcloud docker -- --help to view the Docker CLI's help directly.

Detailed documentation on Container Registry can be found here: https://cloud.google.com/container-registry/docs/

EXAMPLES
To pull the image 'gcr.io/google-containers/pause:1.0' from the docker registry, run:
gclouddocker--pullgcr.io/google-containers/pause:1.0

Push the image 'gcr.io/example-org/example-image:latest' to our private docker registry.

gclouddocker--pushgcr.io/example-org/example-image:latest

Configure authentication, then simply use docker:

gclouddocker--authorize-only
dockerpushgcr.io/example-org/example-image:latest
POSITIONAL ARGUMENTS
[-- DOCKER_ARGS …]
Arguments to pass to Docker.

The '--' argument must be specified between gcloud specific args on the left and DOCKER_ARGS on the right.

FLAGS
--authorize-only, -a
Configure Docker authorization only; do not launch the Docker command-line.
--docker-host=DOCKER_HOST
URL to connect to Docker Daemon. Format: tcp://host:port or unix:///path/to/socket.
--server=SERVER,[SERVER,…], -s SERVER,[SERVER,…]; default="gcr.io,us.gcr.io,eu.gcr.io,asia.gcr.io,staging-k8s.gcr.io,marketplace.gcr.io"
Address of the Google Cloud Registry.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file , --account , --billing-project , --configuration , --flags-file , --flatten , --format , --help , --impersonate-service-account , --log-http , --project , --quiet , --trace-token , --user-output-enabled , --verbosity .

Run $ gcloud help for details.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年07月22日 UTC.