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): Run and test AI agents locally with azd
New azd ai agent run and invoke commands let you start and test AI agents from your terminal—locally or in the cloud. The post Azure Developer...
Microsoft Purview compliance portal: Endpoint DLP classification support for Azure RMS–protected Office documents
Microsoft Purview Endpoint DLP will soon classify Azure RMS–protected Office documents, enabling consistent DLP policy enforcement on encrypte...
Introducing the Azure Cosmos DB Plugin for Cursor
We’re excited to announce the Cursor plugin for Azure Cosmos DB bringing AI-powered database expertise, best practices guidance, and liv...
Azure DevOps Remote MCP Server (public preview)
When we released the local Azure DevOps MCP Server, it gave customers a way to connect Azure DevOps data with tools like Visual Studio and Vis...
Azure Cosmos DB at FOSSASIA Summit 2026: Sessions, Conversations, and Community
The FOSSASIA Summit 2026 was an incredible gathering of developers, open-source contributors, startups, and technology enthusiasts from across...
Dataverse: Avoid Concurrency issues by using Azure Service Bus Queue and Azure Functions
Another blog post to handle the concurrency issue. Previously, I shared how to do concurrency via a plugin in this blog post and also how to f...
March Patches for Azure DevOps Server
We are releasing patches for our self‑hosted product, Azure DevOps Server. We strongly recommend that all customers stay on the latest, most s...
Azure Developer CLI (azd): Debug hosted AI agents from your terminal
New azd ai agent show and monitor commands help you diagnose hosted AI agent failures directly from the CLI. The post Azure Developer CLI (azd...
A Look Ahead at Azure Cosmos DB Conf 2026: From AI Agents to Global Scale
Join us for Azure Cosmos DB Conf 2026, a free global, virtual developer event focused on building modern applications with Azure Cosmos DB. Da...