Azure CLI docker container base Linux image is now Azure Linux
Starting from the version 2.64.0 of Azure CLI, the base Linux distribution of Azure CLI is now Azure Linux.
Impact of the change
- az commands are unaffected.
- shell commands specific to Alpine will not be functional (ex: apk).
- The following GitHub action will use the new image and could impact scripts using Alpine specific commands or components
Addressing the change in GitHub actions
If you are using GitHub actions, remove any Alpine-specific commands from the `inlineScript` in azure/cli action to achieve a smooth transition to this new image.
Known issues with workaround
We have identified the following issues that may impact your pipelines or scripts:
- Package missing
ICU package: Bicep stopped working on azure-cli:latest Docker image (2.64.0) · Issue #29828 · Azure/azure-cli (github.com)
Solution:
a. Pin to 2.63.0
b. Install package manually: tdnf install -y icu, tdnf install –y jq
- tdnf not working: `tdnf` not working in GitHub Actions · Issue #29835 · Azure/azure-cli
A sample of affected use case:
Solution:
a. Pin to 2.63.0
b. Use azure/cli action
Thank you for your cooperation!
If you are not yet prepared to migrate to Azure Linux due to some specific issues, please open an issue on GitHub by clicking the below links, so we can assist you.
Opening Azure CLI action issue
Published on:
Learn moreRelated posts
Azure Developer CLI (azd) – May and June 2026
This is the combined May and June round-up for the Azure Developer CLI (azd). Nine releases shipped across the two months: 1.24.3, 1.25.0, 1.2...
Which Azure Cosmos DB Role Does My App Need?
In the previous post in the series, we covered the security decisions you make on day one. In this part, we will talk about how to give your a...
Find and fix app issues - Azure Copilot Observability Agent
Cut through alert noise and move from detection to root cause using the Azure Copilot Observability Agent. It autonomously investigates incide...
Azure Functions MCP Extension: What’s New at Build 2026
A roundup of what shipped in the Azure Functions MCP extension since preview: resource and prompt triggers, MCP Apps, built-in MCP authenticat...
Secure Boot certificate updates for Linux on Azure virtual machines
Microsoft has published new guidance for managing Secure Boot certificate updates for Linux on Azure virtual machines, including Trusted Launc...
Soluzione Earns Microsoft Solutions Partner Designation for Digital & App Innovation (Azure)
Soluzione is pleased to announce that it has earned the Microsoft Solutions Partner designation for Digital & App Innovation (Azure). This...
Azure SDK Release (May 2026)
Azure SDK releases every month. In this post, you'll find this month's highlights and release notes. The post Azure SDK Release (May 2026) app...
How to Use Deep Agents with Azure Cosmos DB – Plan, act, and verify against operational data
Deep Agents is an agent harness built on LangGraph, for agents that need to work through a task over many steps instead of a single LLM call. ...
Retirement of Azure DevOps issuer in Workload identity federation service connections
We are announcing the deprecation of the Azure DevOps issuer in workload identity federation (WIF) service connections, with planned retiremen...