Loading...

Azure CLI docker container base Linux image is now Azure Linux

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:

 

  1. Package missing

ICU package: Bicep stopped working on azure-cli:latest Docker image (2.64.0) · Issue #29828 · Azure/azure-cli (github.com)

Jq: jq command stopped working on azure-cli:latest Docker image (2.64.0) · Issue #29830 · Azure/azure-cli (github.com)

Solution:

a. Pin to 2.63.0

 

- name: Azure CLI script uses: azure/cli@v2 with: azcliversion: 2.63.0 inlineScript: | <Your az commands here>

 

 

b. Install package manually: tdnf install -y icu, tdnf install –y jq

 

- name: Azure CLI script uses: azure/cli@v2 with: azcliversion: 2.64.0 inlineScript: | tdnf install -y icu tdnf install –y jq <Your az commands here>

 

 

  1. tdnf not working: `tdnf` not working in GitHub Actions · Issue #29835 · Azure/azure-cli

A sample of affected use case:

 

jobs: deploy: runs-on: ubuntu-latest container: mcr.microsoft.com/azure-cli steps: - name: Cleanup build folder run: | tdnf install -y zip

 

Solution:

a. Pin to 2.63.0

 

 

b. Use azure/cli action

 

- name: Azure CLI script uses: azure/cli@v2 with: azcliversion: 2.64.0 inlineScript: | tdnf install -y zip

 

 

 

 

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 issue

Opening Azure CLI action issue

 

Published on:

Learn more
Azure Tools Blog articles
Azure Tools Blog articles

Azure Tools Blog articles

Share post:

Related posts

UPDATED: Azure outage affecting Windows Updates and related services

UPDATED 1:45 PM PST: Resolution efforts are complete at this time, and Windows services are expected to be back to normal. Notices related to ...

20 hours ago

Native Agent Memory for Microsoft Agent Framework, Powered by Azure Cosmos DB

Recently we introduced the Agent Memory Toolkit and the Agentic Retrieval Toolkit for Azure Cosmos DB. The Agent Memory Toolkit gives your age...

22 hours ago

Building AI Chatbots with Copilot Studio and Azure OpenAI (Complete 2026 Guide)

Introduction Artificial Intelligence has fundamentally changed how businesses interact with customers, employees and partners. Modern organisa...

1 day ago

Build locally, ship to Azure: meet Azure SQL Developer

Big news: Azure SQL Developer is here, in private preview. It’s the Azure SQL Database engine, on your laptop, in a container. Build aga...

1 day ago

Azure Developer vs Azure Administrator: Which Azure Career Path Should You Choose in 2026?

Introduction Cloud computing has become the backbone of modern businesses, and Microsoft Azure continues to be one of the world’s leadin...

2 days ago

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...

3 days ago

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...

3 days ago

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....

4 days ago

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...

4 days ago
Stay up to date with latest Microsoft Dynamics 365 and Power Platform news!
* Yes, I agree to the privacy policy