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

4 hours ago

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

16 hours ago

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

1 day ago

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

1 day ago

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

2 days ago

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

2 days ago

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

3 days ago

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

3 days ago

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

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