Push an image

Azure DevOps Services

Azure Pipelines can be used to push images to container registries such as Azure Container Registry (ACR), Docker Hub, Google Container Registries, and others.

Push step in pipeline

The following YAML snippet showcases the usage of Docker registry service connection along with a Docker task to log in and push to a container registry. Instances of Docker registry service connection serve as secure options for storing credentials needed to log in to the container registry before pushing the image. These service connections can be directly referenced in Docker tasks to log in to the registry without needing to add a script task for docker log in.

- task: Docker@2
  displayName: Push image
    containerRegistry: |
    repository: $(imageName)
    command: push
    tags: |

Azure Container Registry

With the Azure Container Registry option for Docker registry service connection, the subscription (associated with the Azure Active Directory identity of the user signed into Azure DevOps) and container registry within the subscription can be chosen to create the service connection. These service connections can be later referenced from a pipeline task as shown in the YAML snippet above.

When creating a new pipeline for a repository containing Dockerfile, the Build and Push to Azure Container Registry document describes the Docker template automatically recommended by Azure Pipelines upon detecting of Dockerfile in the repository. The Azure subscription and Azure Container Registry inputs provided for template configuration are used by Azure Pipelines to automatically create the Docker registry service connection and even construct a functioning build and push pipeline by referencing the created service connection.

Docker Hub

Choose the Docker Hub option under Docker registry service connection and provide the username and password required for verifying and creating the service connection.

Google Container Registry

The following steps walk through the creation of Docker registry service connection associated with Google Container Registry:

  1. Open your project in the GCP Console and then open Cloud Shell

  2. To save time typing your project ID and Compute Engine zone options, set default configuration values by running the following commands:

    gcloud config set project [PROJECT_NAME]
    gcloud config set compute/zone [ZONE]
  3. Replace [PROJECT_NAME] with the name of your GCP project and replace [ZONE] with the name of the zone that you're going to use for creating resources. If you're unsure about which zone to pick, use us-central1-a. For example:

    gcloud config set project azure-pipelines-test-project-12345
    gcloud config set compute/zone us-central1-a
  4. Enable the Container Registry API for your project:

    gcloud services enable containerregistry.googleapis.com
  5. Create a service account for Azure Pipelines to publish Docker images:

    gcloud iam service-accounts create azure-pipelines-publisher --display-name "Azure Pipelines Publisher"
  6. Assign the Storage Admin IAM role to the service account:

    PROJECT_NUMBER=$(gcloud projects describe \
    $(gcloud config get-value core/project) \
    AZURE_PIPELINES_PUBLISHER=$(gcloud iam service-accounts list \
        --filter="displayName:Azure Pipelines Publisher" \
    gcloud projects add-iam-policy-binding \
        $(gcloud config get-value core/project) \
        --member serviceAccount:$AZURE_PIPELINES_PUBLISHER \
        --role roles/storage.admin
  7. Generate a service account key:

    gcloud iam service-accounts keys create \
    azure-pipelines-publisher.json --iam-account $AZURE_PIPELINES_PUBLISHER
    tr -d '\n' < azure-pipelines-publisher.json > azure-pipelines-publisher-oneline.json

    Launch Code Editor by clicking the button in the upper-right corner of Cloud Shell:


  8. Open the file named azure-pipelines-publisher-oneline.json. You'll need the content of this file in one of the following steps:

  9. In your Azure DevOps organization, select Project settings and then select Pipelines -> Service connections.

  10. Select New service connection and choose Docker Registry

  11. In the dialog, enter values for the following fields:

  • Docker Registry: https://gcr.io/[PROJECT-ID], where [PROJECT-ID] is the name of your GCP project.
  • Docker ID: _json_key
  • Docker Password: Paste the contents of azure-pipelines-publisher-oneline.json
  • Service connection name: gcrServiceConnection
  1. Select Save to create the service connection