Azure CLI Docker Image

Minimal Alpine-based Azure CLI base image for the devops-infra organization

Available on

• Docker Hub: devopsinfra/docker-azure-cli:latest
• GitHub Packages: ghcr.io/devops-infra/docker-azure-cli:latest
• Source: devops-infra/docker-azure-cli

Badges

Current image tags

• Exact Azure CLI tag: 2.87.0
• Minor Azure CLI tag: 2.87
• Floating tag: latest

All published images are multi-architecture:

• linux/amd64
• linux/arm64

What is included

• bash
• ca-certificates
• jq
• python3 with python
• pip3 with pip
• azure-cli

This image intentionally does not include:

• AWS CLI
• Google Cloud SDK
• Terraform
• OpenTofu
• Terragrunt

Validation

Container Structure Tests for this repository are run with devops-infra/action-container-structure-test@v1, and the local task test:structure helper uses the same published runtime image. CI candidate images use the shared suffix tag format: <version>-test.

Local usage

Build the image for the local host platform:

task docker:build

Push the multi-arch image to Docker Hub and GHCR:

task docker:push

Check for Azure CLI and Alpine package updates:

task dependency:update

Run Container Structure Tests against the built image:

task test:structure

Downstream usage

Use this image as a base for Azure-enabled Docker images:

FROM ghcr.io/devops-infra/docker-azure-cli:2.87.0

Example interactive usage:

docker run --rm -it devopsinfra/docker-azure-cli:latest az version

Automation

The repository includes workflows for:

• dependency update pull requests when a new Azure CLI version is published
• manual multi-arch image publishing to Docker Hub and GHCR
• automatic pull request creation for non-default branches