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

Top Azure Services Every Dynamics 365 Developer Must Learn

Introduction Microsoft Dynamics 365 has evolved far beyond being just a Customer Relationship Management (CRM) or Enterprise Resource Planning...

5 hours ago

Creating AI-Powered Workflows Using Power Automate and Azure AI

Introduction Artificial Intelligence is revolutionising business automation by enabling organisations to build workflows that not only automat...

1 day ago

Azure Developer CLI (azd) July 2026

This is the July round-up for the Azure Developer CLI (azd). Five releases shipped since the last post: 1.27.0, 1.27.1, 1.28.0, 1.28.1, and 1....

1 day ago

Azure vs AWS: Which Cloud Platform Should You Learn in 2026?

Introduction Cloud computing has become the foundation of modern digital transformation. From startups to Fortune 500 companies, organizations...

2 days ago

Building Enterprise Applications with .NET 10 and Azure Cloud

Introduction As businesses continue their digital transformation journey, enterprise applications are expected to be more intelligent, scalabl...

2 days ago

Azure Tops $100 Billion As Microsoft Reports FY26 Q4 Results

On July 29, Microsoft released their FY26 Q4 results. We learned that Microsoft 365 Copilot has 30 million paid seats, but that's still less t...

2 days ago

Azure SDK Release (July 2026)

Azure SDK releases every month. In this post, you'll find this month's highlights and release notes. The post Azure SDK Release (July 2026) ap...

2 days ago

Azure OpenAI Service: Complete Guide for Beginners

Introduction Artificial Intelligence is transforming how businesses build software, automate workflows and deliver personalised customer exper...

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