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

Azure DevOps and GitHub: Journeying into the AI Era

AI is changing how software gets planned, built, and reviewed. As teams adopt agentic development, the platform underneath those workflows mat...

16 hours ago

Introducing azure-functions-skills: An AI-Era Workspace for Azure Functions (Preview)

azure-functions-skills gives GitHub Copilot CLI, Claude Code, Codex CLI, and VS Code the skills, MCP configuration, hooks, and instructions ne...

16 hours ago

Announcing the Public Preview of Integrated Embeddings in Azure Cosmos DB: Build AI Apps With Embeddings That Stay in Sync

AI applications built on Azure Cosmos DB depend on embeddings for grounded results. Keeping them in sync with your data is the hard part: it m...

16 hours ago

Introducing OmniVec: An Open-Source Embedding Platform for AI Apps on Azure

Today we are open-sourcing OmniVec, a platform for building and operating the embedding pipelines that keep the vector representation of your ...

16 hours ago

Azure Cosmos DB All Versions and Deletes Change Feed Mode is Now Generally Available

Modern applications don’t just write data and move on. They react to it. A new order triggers an inventory update. A profile change sync...

16 hours ago

Change Partition Keys in Azure Cosmos DB is Now Generally Available

We’re excited to announce the general availability of Change Partition Key in Azure Cosmos DB for NoSQL, now with online copy support. Y...

16 hours ago

Announcing the General Availability of Per Partition Automatic Failover for Azure Cosmos DB NoSQL

Today, we are excited to announce the General Availability of Per Partition Automatic Failover (PPAF) for Azure Cosmos DB NoSQL API. PPAF is a...

16 hours ago

Public Preview: AI-powered Azure Cosmos DB Migration Assistant for RDBMS to NoSQL

Today, we are excited to announce the public preview of the Azure Cosmos DB Migration Assistant for RDBMS to NoSQL, now available in the Azure...

16 hours ago

Azure Cosmos DB MCP Toolkit Is Now Generally Available — Bringing Your Database to AI Agents at Scale

Since we introduced the Azure Cosmos DB MCP Toolkit at Ignite 2025 in preview, the response has been clear: developers want a straightforward ...

16 hours ago

Announcing General availability of the Azure Cosmos DB vNext emulator

The Azure Cosmos DB vNext emulator is generally available today. It ships as a Docker image that runs on Linux, macOS, and Windows, on both x6...

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