> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# cimg/azure

An Azure Docker image built to run on CircleCI that contains the Azure CLI and related tools.

`cimg/azure` is a Docker image created by CircleCI with continuous delivery and deployment pipelines in mind.
It contains the Azure CLI, `az`, related tools, and is based on the [cimg/deploy](https://github.com/CircleCI-Public/cimg-deploy) image.
Each tag is a date-based snapshot.


## Getting Started

This image can be used with the CircleCI `docker` executor.
For example:

```yaml
jobs:
  build:
    docker:
      - image: cimg/azure:2026.04
    steps:
      - checkout
      - run: az --version
```

In the above example, the CircleCI Azure Docker image is used for the primary container.
You can now use all of the tools pre-installed in this image in this job.


## How This Image Works

This image is published on a monthly basis.
Each month, we'll update the main tools to newer versions as they are available.

### Tagging Scheme

This image has the following tagging scheme:

```
cimg/azure:YYYY.MM.I
```

The tag will be `YYYY.MM.I` where YYYY is the 4 digit year, MM is the 2 digit month, and I is the nth release of that month.
The last piece there typically will only change when we need to patch an image for that month.

## Image Tags