[Doc] Add doc for installing Azure CLI with pip

[jiasli]

There are platforms or architectures where we don't officially distribute native packages:

• Support arm64 Linux builds #7368
• Support Azure CLI 64-bit on Windows #18766
• Install Azure CLI on Alpine Linux #19591
• Please help maintain the Azure-cli conda packages #16526

The solution is to install azure-cli from PyPI: https://pypi.org/project/azure-cli/

pip install azure-cli

We do have the doc https://docs.microsoft.com/en-us/cli/azure/install-azure-cli-linux?pivots=script which is internally using pip to install azure-cli. It calls https://github.com/Azure/azure-cli/blob/dev/scripts/curl_install_pypi/install which then calls https://github.com/Azure/azure-cli/blob/dev/scripts/curl_install_pypi/install.py.

However, this method is

1. Too complex/automated and leaves users with very few customization options
2. Interactive, which is not suitable for automated installation:
3. Not actively maintained. For example, it support Ubuntu up to 18.04:

   azure-cli/scripts/curl_install_pypi/install.py

   Lines 366 to 367 in 50ccb24

   	elif distname == 'ubuntu' and version in ['15.10', '16.04', '18.04']or distname == 'debian' and version.startswith('8'):
   	dep_list = ['libssl-dev', 'libffi-dev', python_dep, 'build-essential']

[jiasli]

[draft version]

Install Azure CLI with pip

Azure CLI is built on Python. The supported Python versions are 3.7 ~ 3.10.

Directly running pip install azure-cli installs Azure CLI system-wide and may cause conflicts with other Python libraries. Instead, we recommend installing Azure CLI in a virtual environment.

Windows

Install

First install Python from https://www.python.org/downloads/windows/.

Then launch a PowerShell terminal and run:

# Create a virtual environment
python -m venv azure-cli-env

# Update pip
azure-cli-env\Scripts\python.exe -m pip install --upgrade pip

# Install azure-cli
azure-cli-env\Scripts\python.exe -m pip install azure-cli

# Run any Azure CLI commands
azure-cli-env\Scripts\az --version

Uninstall

Delete the virtual environment:

Remove-Item -Force -Recurse azure-cli-env

Linux/MacOS

Install

First make sure python3 and its related packages are installed:

# Ubuntu/Debian
sudo apt install python3 python3-venv --yes

# Fedora/CentOS/RHEL
sudo dnf install python3 -y

# Homebrew
brew install python

Then continue the installation:

# Create a virtual environment
python3 -m venv azure-cli-env

# Update pip
azure-cli-env/bin/python -m pip install --upgrade pip

# Install azure-cli
azure-cli-env/bin/python -m pip install azure-cli

# Run any Azure CLI commands
azure-cli-env/bin/az --version

Uninstall

Delete the virtual environment:

rm -rf azure-cli-env

Reference

• Install Azure CLI beta version: https://github.com/MicrosoftDocs/azure-docs-cli/blob/8d15e024d96102fb7b7a574be543783d7abefa4b/docs-ref-conceptual/install-azure-cli-beta.md