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 Roadmap 2026: Skills, Certifications, Projects, and Career Path
Introduction Cloud computing has become the backbone of modern software development, and Microsoft Azure is one of the world’s leading c...
July Patches for Azure DevOps Server
We are releasing new patches for our self‑hosted product, Azure DevOps Server. We strongly recommend that all customers stay up to date with t...
What Is Azure AI Foundry and Why Should Developers Learn It? (Complete 2026 Guide)
Introduction Artificial Intelligence is no longer a futuristic technology—it’s becoming a core component of modern software development....
AI agents, meet the Azure Cosmos DB vNext emulator
If you use the Azure Cosmos DB vNext emulator, you probably know the local development loop: start the emulator, connect to it, create some re...
Building a Complete Business Application Using C#, Azure, and Power Platform (2026 Guide)
Introduction Modern businesses need applications that are scalable, secure, intelligent and capable of adapting to rapidly changing business r...
Creating AI-Powered Power Apps Using Azure OpenAI (2026 Guide)
Introduction Artificial Intelligence is rapidly transforming the way businesses build applications. Traditional business apps required users t...
How to Integrate ChatGPT with Dynamics 365 Using Azure Functions (Complete 2026 Guide)
Introduction Artificial Intelligence is transforming enterprise applications, and Microsoft Dynamics 365 is no exception. Businesses are incre...
How to build long-running MCP tools on Azure Functions
Learn how to build long-running MCP tools on Azure Functions using Durable Functions. This post explains why synchronous tool calls break down...