CircleCI Logo
Navigation Menu Icon

Deploy to Azure Container Registry

Language Icon 29 days ago · 3 min read
Cloud Server v4+
Contribute Go to Code

In this how-to guide, you will learn how to configure CircleCI to deploy to Azure Container Registry.

Introduction

This page describes a simple deployment to the Azure Container Registry (ACR) using the CircleCI ACR orb and version 2.1 configuration.

To take advantage of secrets masking, it is best practice to set environment variables at the project level or within a context.

In addition to the orb described below, CircleCI has created an Azure convenience image focusing on deployment: cimg/azure.

For detailed information about the Azure ACR orb, including all options, refer to the CircleCI ACR Orb Reference page.

1. Provide environment variables to CircleCI

Whether your require a user or service principal login, you will need to provide environment variables for username, password and tenant to CircleCI. For user logins use environment variable names as follows:

  • AZURE_USERNAME

  • AZURE_PASSWORD

  • AZURE_TENANT

For service principal logins use:

  • AZURE_SP

  • AZURE_SP_PASSWORD

  • AZURE_SP_TENANT

2. Deploy to ACR

Use the orb’s build-and-push-image job to build your image and deploy it to ACR. Note the use of workflows to deploy only if the current branch is main.

Make sure to replace any placeholder versions in the example. 
version: 2.1 # Use version 2.1 config to get access to orbs, pipelines

orbs:
  azure-acr: circleci/azure-acr@0.2.2 # Use the Azure ACR orb in your config

workflows:
  build-deploy:
    jobs:
      - azure-acr/build-and-push-image:
          dockerfile: <name-of-your-dockerfile> # defaults to `Dockerfile`
          path: <path-to-your-dockerfile> # Defaults to working directory
          login-server-name: <your-login-server-name> # e.g. {yourregistryname}.azure.io
          registry-name: <your-ACR-registry-name>
          repo: <URI-to-your-login-server-name>
          filters:
            branches:
              only: main # Only deploys when the commit is on the `main` branch

If pushing to your repository is required, see the Users, Organizations, and Integrations Guide. Then, configure the Azure Web App to use your production branch.