共用方式為


在 Linux 上安裝 Azure CLI

本文說明如何在Linux上安裝 Azure CLI。 從頁面頂端的選項中,為您的散發套件選取適當的套件管理員。 建議您使用Linux發行版的套件管理員,但您可以選取 [安裝腳本 ] 選項,在Linux上手動安裝 Azure CLI。

目前 Azure CLI 的版本是 2.70.0。 如需最新版本的相關資訊,請參閱版本資訊。 若要尋找已安裝的版本,並查看是否需要更新,請執行 az version

開始之前

  • Azure CLI 2.38.2 (於 2024 年 6 月 21 日發行)是 RHEL 7 和 Centos 7 上支持的最後一個版本。 Microsoft不再提供這些散發套件的更新或錯誤修正。

  • Microsoft會繼續開發和支援 Azure CLI 和 Linux 安裝腳本

  • yum如果您使用不支援套件管理員的 dnf Linux系統,請使用套件管理員。

安裝 Azure CLI

若要安裝 Azure CLI,請遵循下列步驟:

  1. 匯入 Microsoft 存放庫金鑰。

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. 針對 RHEL 9 或 CentOS Stream,新增存放 packages-microsoft-com-prod 庫:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
    

    針對 RHEL 8,新增 packages-microsoft-com-prod 存放庫:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
    

    針對 RHEL 7,新增 azure-cli 存放庫:

    echo -e "[azure-cli]
    name=Azure CLI
    baseurl=https://packages.microsoft.com/yumrepos/azure-cli
    enabled=1
    gpgcheck=1
    gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo
    

    警告

    CentOS 7 生命週期結束 (EOL) 是 2024 年 6 月 30 日。 如需 Azure CLI 支援環境的相關信息,請參閱 Azure CLI 支援生命週期

  3. 使用 dnf install 命令進行安裝。

    sudo dnf install azure-cli
    

安裝特定版本

您必須先如先前所示設定 azure-cli 存放庫資訊。 您可以在 Azure CLI 版本資訊中找到可用的版本。

  1. 若要使用 命令檢視可用的版本:

    dnf list --showduplicates azure-cli
    
  2. 若要安裝特定版本:

    sudo dnf install azure-cli-<version>-1.el7
    

更新 Azure CLI

從 2.11.0 版開始,Azure CLI 會提供工具內命令來更新至最新版本。

az upgrade

依預設,此命令也會更新所有已安裝的延伸模組。 如需更多 az upgrade 選項,請參閱 命令參考頁面。 針對 2.11.0 之前的 Azure CLI 版本,請重新安裝 ,如安裝 Azure CLI 中所述進行更新。

您也可以使用 dnf update 命令來更新 Azure CLI。

sudo dnf update azure-cli

卸載 Azure CLI

如果您決定卸載 Azure CLI,我們為您的離開感到遺憾。 卸載之前,請使用 az feedback 命令讓我們知道哪些可以改進或修正的地方。 我們的目標是讓 Azure CLI 無 Bug 且方便使用者使用。 如果您發現錯誤,如果您 提出 GitHub 問題,我們很感激。

  1. 從系統移除套件。

    sudo dnf remove azure-cli
    
  2. 如果您不打算重新安裝 CLI,請移除存放庫資訊。

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. 如果您未使用任何其他Microsoft套件,請移除簽署密鑰。

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

移除資料

如果您不打算重新安裝 Azure CLI,請移除其數據。

rm -rf ~/.azure

疑難排解

以下是使用 dnf安裝 時所見的一些常見問題。 如果您遇到此處未涵蓋的問題, 請在 GitHub 上提出問題。

在 RHEL 7.6 或其他沒有 Python 3 的系統上安裝

如果可以,請將系統升級至有正式支援python 3.6+套件的版本。 否則,您必須先安裝 python3 套件,然後安裝 Azure CLI 而不需相依性。

您可以使用下列命令,下載並安裝從原始碼建置的 Azure CLI 指令碼 python 3.6

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

您也可以逐步執行:

首先,Azure CLI 需要 SSL 1.1+ 且您需要從來源建置 openssl 1.1 ,才能建置 python3

sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v

然後從來源建置 Python 3:

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

最後,請遵循安裝指示的步驟 1 和 2 來新增 Azure CLI 存放庫。 您現在可以下載套件並加以安裝,而不需相依性。

注意

如果尚未安裝 dnf 下載外掛程式,則執行下列程式代碼時會發生 command not found 錯誤。 使用 dnf install 'dnf-command(download)' 來安裝 dnf 下載外掛程式。

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

或者,您也可以使用 另一個存放庫來安裝 Python 3。 如果您已設定 python3 ,但仍收到錯誤 python3: command not found,請使用此方法。 請確定它已包含在您的路徑中。

scl enable rh-python36 bash

Proxy 封鎖連線

如果您因為代理伺服器而無法連接到外部資源,請確定您已在終端機中正確設定 HTTP_PROXYHTTPS_PROXY 變數。 您需要聯繫系統管理員,以了解哪些主機和端口用於這些代理。

許多 Linux 程式會使用這些變數中的值,並在安裝程式期間使用。 若要設定這些值:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

如果您位於代理伺服器後方,則必須設定這些 shell 變數,才能使用 CLI 連線到 Azure 服務。 如果您未使用基本身份驗證,建議您在檔案中 .bashrc 匯出這些變數。 請一律遵循您企業的安全策略和系統管理員的需求。

您也可以明確設定 dnf 為一律使用此代理。 請確定下列幾行會出現在 的 [main]/etc/dnf/dnf.conf區段底下:

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

若要從我們的存放庫取得Microsoft簽署密鑰和套件,您的 Proxy 必須允許 HTTPS 連線到下列位址:

  • https://packages.microsoft.com

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 (WSL) 是 Windows 平臺上的系統呼叫轉譯層,因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤,很有可能是 WSL 的問題,而不是 CLI 安裝程式的問題。

若要對 WSL 安裝進行疑難排解並可能解決問題:

如果您繼續在 WSL 上安裝或執行時發生問題,請考慮 安裝適用於 Windows 的 CLI。

開始之前

  • Azure CLI 2.38.2 (於 2024 年 6 月 21 日發行)是 SUSE Linux Enterprise Server (SLES) 和 OpenSUSE (Leap) 上支援的最新版本。 Microsoft不再提供這些發行版的更新或錯誤修正。

  • Microsoft會繼續開發和支援 Azure CLI 和 Linux 安裝腳本。 SUSE 會維護並支援 SUSE/OpenSUSE 存放庫所提供的套件。

  • 在 Azure 中,以 Azure Marketplace 映射為基礎的 SUSE 和 OpenSUSE 虛擬機已安裝 Azure CLI。

安裝 Azure CLI

若要在 SUSE/OpenSUSE 上安裝 Azure CLI,請選擇下列其中一種方法:

  1. 使用 SUSE/OpenSUSE 存放庫中 SUSE 所提供的企業套件。

  2. 使用 [安裝腳本(任何)] 索引標籤中所述的安裝方法。

  3. 從Microsoft存放庫安裝

從 SUSE 或 OpenSUSE 存放庫安裝

Azure CLI 的 RPM 套件取決於 python3 套件。

sudo zypper install -y azure-cli

使用安裝文稿進行安裝

您可以使用 [安裝腳本] 選項,在 Linux 的任何版本上手動安裝 Azure CLI。

如果您要 使用此方法更新 至最新版本,請務必先卸載舊版,以及您可能已針對該版本新增的任何存放庫。

從Microsoft存放庫安裝

若要使用 Microsoft 存放庫安裝最新版的 Azure CLI,請遵循下列步驟。

(此套件已經過在 SLES 15OpenSUSE Leap 15.1 的測試)

  1. 安裝 curl

    sudo zypper install -y curl
    
  2. 匯入Microsoft存放庫金鑰:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. 建立本機 azure-cli 儲存庫資訊:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. zypper更新套件索引並安裝:

    sudo zypper install --from azure-cli azure-cli
    

    輸入 2 以繼續安裝,忽略部分相依性。

安裝特定版本

您必須先如先前所示設定 azure-cli 存放庫資訊。 您可以在 Azure CLI 版本資訊中找到可用的版本。

  1. 使用此指令檢視可用的版本:

    zypper search --details --match-exact azure-cli
    
  2. 若要安裝特定版本:

    sudo zypper install --from azure-cli azure-cli=<version>-1.el7
    

更新 Azure CLI

從 2.11.0 版開始,Azure CLI 會提供工具內命令來更新至最新版本。

az upgrade

依預設,此命令也會更新所有已安裝的延伸模組。 如需更多 az upgrade 選項,請參閱 命令參考頁面。 針對 2.11.0 之前的 Azure CLI 版本,請重新安裝 ,如安裝 Azure CLI 中所述進行更新。

您也可以使用 zypper update 命令來更新套件。

sudo zypper refresh
sudo zypper update azure-cli

卸載 Azure CLI

如果您決定卸載 Azure CLI,我們很遺憾見到您離開。 卸載之前,請使用 az feedback 命令告訴我們有哪些地方可以改善或修正。 我們的目標是讓 Azure CLI 無 Bug 且方便使用者使用。 如果您發現錯誤,如果您 提出 GitHub 問題,我們很感激。

  1. 從系統移除套件。

    sudo zypper remove -y azure-cli
    
  2. 如果您不打算重新安裝 CLI,請移除存放庫資訊。

    sudo zypper removerepo azure-cli
    
  3. 如果您沒有使用其他Microsoft套件,請移除Microsoft簽署密鑰。

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

刪除資料

如果您不打算重新安裝 Azure CLI,請移除其數據。

rm -rf ~/.azure

疑難排解

以下是使用 zypper安裝 時所見的一些常見問題。 如果您遇到此處未涵蓋的問題, 請在 GitHub 上提出問題。

不使用 Python 3 安裝

重要

Azure CLI 的 RPM 套件取決於 python3 套件。 在您的系統上,這可能是早於 Python 3.6.x 需求的 Python 版本。 如果這會影響您,請尋找取代 python3 套件。

請注意,Python 2 已於 2020 年 1 月 1 日終止生命週期 (EOL),且將不再收到更新。 自 2.1.0起,Azure CLI 已放棄對 Python 2.7 的支援。 較新版本的 CLI 可能無法使用 Python 2.7 正確執行。

OpenSUSE 15 VM 上的未實作錯誤 (NotImplementedError)

OpenSUSE 15 VM 具有預安裝的 Azure CLI,版本 2.0.45 已過期,且有問題 az login。 請先移除此版本及其相依性,再遵循 安裝 指示來新增最新的 Azure CLI:

sudo zypper rm -y --clean-deps azure-cli

如果您更新 Azure CLI 而不移除 2.0.45 版的相依性,其舊相依性可能會影響最新版的 Azure CLI。 您需要將舊版新增回來以連結其依賴項,然後移除azure-cli及其依賴項。

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

在沒有 Python 3.6 的 SLES 12 或其他系統上安裝

在 SLES 12 上,預設 python3 套件為 3.4,且 Azure CLI 不支援。 您可以先遵循安裝指示中的步驟 1-3來添加azure-cli倉庫。 然後從來源建置更高版本 python3 。 最後,您可以下載 Azure CLI 套件並加以安裝,而不需相依性。

您可以使用下列一個命令,根據上述步驟來安裝或更新 Azure CLI。 腳本會在 底下 /usr/local/azcli 安裝 Python 3.8,並將 的 az 別名設定為 PATH=/usr/local/azcli/bin:$PATH az,讓 Azure CLI 使用它。 您也可以下載文本,並根據您的需求加以修改。 例如,您可以變更 Python 版本或安裝位置。

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

第一次安裝時,請記得執行下列命令來啟動別名:

source ~/.bashrc

Proxy 封鎖連線

如果您因為 Proxy 而無法連線到外部資源,請確定您已在終端中正確設定 HTTP_PROXYHTTPS_PROXY 變數。 您必須連絡系統管理員,才能得知用於這些代理伺服器的主機和埠。

許多 Linux 程式會使用這些變數中的值,並在安裝程式期間使用。 若要設定這些值:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

如果您位於 proxy 後方,必須設定這些環境變數,才能使用 CLI 連線到 Azure 服務。 如果您未使用基本身份驗證,建議您在檔案中 .bashrc 匯出這些變數。 請一律遵循您企業的安全策略和系統管理員的需求。

您也可以明確設定 zypper(透過 yast2)一律使用此代理伺服器。 若要這樣做,請以超級使用者身分執行 yast2 proxy 命令,並填寫窗體中呈現的資訊。 如果您的系統上有可用的視窗管理員,您也可以使用 Network Services > Proxy 中的 YaST Control Center窗格。

如需進階設定或詳細資訊,請參閱 OpenSUSE Proxy 組態檔

若要取得Microsoft簽署密鑰,並從我們的存放庫取得套件,您的 Proxy 必須允許 HTTPS 連線到下列位址:

  • https://packages.microsoft.com
  • https://download.opensuse.org

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 (WSL) 是 Windows 平臺上的系統呼叫轉譯層,因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤,很有可能是 WSL 的問題,而不是 CLI 安裝程式的問題。

請參照以下步驟以進行 WSL 安裝的疑難排解,並可能解決相關問題:

  • 如果可以,請在 Linux 機器或 VM 上執行相同的安裝程式,以查看其是否成功。 如果這樣做,您的問題可能與 WSL 相關。 若要在 Azure 中啟動 Linux VM,請參閱 Azure 入口網站 檔中的建立 Linux VM。
  • 請確定您執行的是最新版本的 WSL。 若要取得最新版本, 請更新您的 Windows 10 安裝
  • 檢查 WSL 是否有任何開放問題可能解決您的問題。 通常會提供關於如何解決此問題的建議,或問題已修復的版本相關資訊。
  • 如果沒有針對您的問題的現有問題,請向WSL 提出新的問題,並確保您盡可能提供詳盡的資訊。

如果您繼續在 WSL 上安裝或執行時發生問題,請考慮 安裝適用於 Windows 的 CLI。

SSL 憑證問題

當計算機上的憑證中斷或過期時,您可能會收到錯誤,指出 curl 無法驗證伺服器的合法性,因此無法建立安全連線。 更新您的憑證以更正問題。

sudo zypper update-ca-certificates

開始之前

  • 套件 apt 管理員包含 Azure CLI 的x86_64和 ARM64 套件,這些套件已在下列發行版上進行測試。

    分配 版本
    Debian 11 (公牛), 12 (書蟲)
    Ubuntu 20.04 LTS (焦點福薩), 22.04 (傑米水母), 24.04 (貴族努巴特)
  • Ubuntu 20.04 (Focal Fossa) 和 20.10 (Groovy Gorilla) 包含一個套件,其中包含存放azure-cli庫所提供的2.0.81版本universe。 此套件已過期,不建議使用。 如果已安裝此套件,請先移除套件,再繼續執行 命令 sudo apt remove azure-cli -y && sudo apt autoremove -y。 如需 的詳細資訊 apt remove,請參閱 Ubuntu 套件管理詢問 ubuntu

安裝 Azure CLI

在您的系統上安裝 Azure CLI 有兩個選項。 您可以下載執行安裝命令的安裝腳本,也可以自行在逐步程式中執行安裝命令。 這裡提供這兩種方法:

選項 1:使用一個命令安裝

安裝 Azure CLI 最簡單的方式是透過 Azure CLI 小組維護的指令碼。 此指令碼會在單一個步驟中執行所有安裝命令。 此指令碼會透過 curl 下載,並直接以管道傳送至 bash 來安裝 CLI。

如果您想要在執行指令碼之前自行檢查其內容,請先使用 curl 下載指令碼然後在您慣用的文字編輯器中檢查指令碼。

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

選項 2:逐步安裝指示

如果您想要逐步安裝程式,請完成下列步驟來安裝 Azure CLI。

  1. 取得安裝程式所需的套件:

    sudo apt-get update
    sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
    
  2. 下載並安裝Microsoft簽署金鑰:

    sudo mkdir -p /etc/apt/keyrings
    curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
      gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
    sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
    
  3. 新增 Azure CLI 軟體存放庫:
    AZ_DIST=$(lsb_release -cs)
    echo "Types: deb
    URIs: https://packages.microsoft.com/repos/azure-cli/
    Suites: ${AZ_DIST}
    Components: main
    Architectures: $(dpkg --print-architecture)
    Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
    
  4. 更新存放庫資訊並安裝 azure-cli 套件:

    sudo apt-get update
    sudo apt-get install azure-cli
    

安裝特定版本

請按照先前的說明配置 azure-cli 存放庫資訊。 您可以在 Azure CLI 版本資訊中找到可用的版本。

  1. 檢視 Azure CLI 的可用版本。

    apt-cache policy azure-cli
    
  2. 安裝特定版本。

    # Obtain the currently installed distribution
    AZ_DIST=$(lsb_release -cs)
    
    # Store an Azure CLI version of choice
    AZ_VER=2.51.0
    
    # Install a specific version
    sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}
    

    若要安裝不含變數的特定版本,請取代顯示的 Azure CLI 版本和 Linux 發行版名稱:

    sudo apt-get install azure-cli=2.51.0-1~bullseye
    

如果您收到錯誤訊息找不到套件 azure-cli,則儲存庫資訊未設定。 請遵循選項 2:逐步安裝指示提供的步驟。

如果您收到錯誤訊息 無法找到 azure-cli 的版本 x.xx.x-1~distributionName,請使用 lsb_release -cs 來尋找您正在執行的發行版。

更新 Azure CLI

從 2.11.0 版開始,Azure CLI 會提供工具內命令來更新至最新版本。

az upgrade

依預設,此命令也會更新所有已安裝的延伸模組。 如需更多 az upgrade 選項,請參閱 命令參考頁面。 針對 2.11.0 之前的 Azure CLI 版本,請重新安裝 ,如安裝 Azure CLI 中所述進行更新。

您也可以使用 apt-get upgrade 來更新 CLI 套件。 此命令會升級系統上尚未變更相依性的所有已安裝套件。

sudo apt-get update && sudo apt-get upgrade

若要僅升級 CLI,請使用 apt-get install

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

卸載 Azure CLI

我們很遺憾看到您決定卸載 Azure CLI。 卸載之前,請使用 az feedback 命令告訴我們有什麼可以改進或修正的內容。 我們的目標是讓 Azure CLI 無 Bug 且方便使用者使用。 如果您發現錯誤,如果您 提出 GitHub 問題,我們很感激。

  1. 使用 apt-get remove 卸載:

    sudo apt-get remove -y azure-cli
    
  2. 如果您不打算重新安裝 CLI,請移除 Azure CLI 存放庫資訊:

    sudo rm /etc/apt/sources.list.d/azure-cli.sources
    
  3. 如果您未使用Microsoft的其他套件,請移除簽署金鑰:

    sudo rm /etc/apt/keyrings/microsoft.gpg
    
  4. 移除任何不需要的套件:

    sudo apt autoremove
    

移除資料

如果您不打算重新安裝 Azure CLI,請移除其數據。

rm -rf ~/.azure

疑難排解

以下是使用 apt安裝 時所見的一些常見問題。 如果您遇到此處未涵蓋的問題, 請在 GitHub 上提出問題。

套件azure-cli支援 CLI 2.46.0的 ARM64 架構。

Ubuntu 20.04 (Focal)/WSL 上沒有模塊問題

如果您在手動安裝指示的步驟 3 沒有將 Azure CLI 軟體存放庫添加到azure-cli 或使用我們的腳本,那麼您可能遇到如找不到名為 'decorator' 或 'antlr4' 的模組之類的問題,因為您安裝的套件是來自focal/universe存放庫的過期版本azure-cli 2.0.81。 先執行 sudo apt remove azure-cli -y && sudo apt autoremove -y來移除它,然後依照上述 指示 安裝最新的 azure-cli 套件。

lsb_release 不會傳回正確的基底發行版本

某些 Ubuntu 或其他 Debian 衍生的發行版(例如 Linux Mint)可能不會從 lsb_release傳回正確的版本名稱。 這個值用於安裝程式,以判斷要安裝的套件。 如果您知道您的散發套件衍生自的 Ubuntu 或 Debian 版本代碼名稱,在新增存放庫時,您可以手動設定AZ_REPO。 否則,請查閱您的系統發行版本資訊,以瞭解如何判斷基礎發行版本代號,並將 AZ_REPO 設定為正確的值。

你的發行版沒有可用的套件

有時候,更新的 Azure CLI 套件在發行版發行后無法立即取得。 Azure CLI 的設計目的是要在面對未來的相依性版本時保持穩定性,並盡可能減少對它們的依賴。 如果您的基本發行版沒有可用的套件,請嘗試較早版本的套件。

若要嘗試較早版本的套件,請在新增存放庫時手動設定AZ_REPO的值。 針對 Ubuntu 發行版,請使用最新的 jammy 存放庫:

AZ_REPO="jammy"

針對 Debian 散發套件,請使用最新的 bookworm 存放庫:

AZ_REPO="bookworm"

重要

不支援在Ubuntu B生和Debian Buster之前發行的發行版。

基本 OS (EOS) 無法安裝 Azure CLI

EOS 無法安裝 Azure CLI,因為 lsb_release 會傳 HERA回 ,這是 EOS 版本名稱。 解決方案是修正檔案 /etc/apt/sources.list.d/azure-cli.sources ,並將 變更 Suites: heraSuites: bionic

來源檔案內容:

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

修改過的檔案內容

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Proxy 封鎖連線

如果您因為代理伺服器而無法連線到外部資源,請確定您已在命令列中正確設定 HTTP_PROXYHTTPS_PROXY 變數。 您需要聯絡系統管理員,以瞭解要用於這些 proxy 的主機和埠。

許多 Linux 程式會使用這些變數中的值,並在安裝程式期間使用。 若要設定這些值:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

如果您在代理伺服器後方,則必須設定這些 Shell 變數,才能使用 CLI 連線到 Azure 服務。 如果您未使用基本身份驗證,建議您在檔案中 .bashrc 匯出這些變數。 請一律遵循您企業的安全策略和系統管理員的需求。

您也可以明確設定 apt 為一律使用此代理。 請確保下列幾行出現在apt中的/etc/apt/apt.conf.d/組態檔中。 建議您使用現有的全域組態檔、現有的 Proxy 組態檔或 40proxies99local但請遵循系統管理需求。

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

如果您的 Proxy 未使用基本身份驗證,請 移除[username]:[password]@ Proxy URI 的部分。 如果您需要 Proxy 設定的詳細資訊,請參閱官方 Ubuntu 檔:

若要取得Microsoft簽署金鑰並從我們的存放庫取得套件,您的 Proxy 必須允許 HTTPS 連線到下列位址: 'https://packages.microsoft.com.

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 (WSL) 是 Windows 平臺上的系統呼叫轉譯層,因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤,很有可能是 WSL 的問題,而不是 CLI 安裝程式的問題。

若要對 WSL 安裝進行疑難排解,並可能解決問題:

  • 如果可以,請在 Linux 機器或 VM 上執行相同的安裝程式,以查看其是否成功。 如果這樣做,您的問題可能與 WSL 相關。 若要在 Azure 中啟動 Linux VM,請參閱 Azure 入口網站 檔中的建立 Linux VM。
  • 請確定您執行的是最新版本的 WSL。 若要取得最新版本, 請更新您的 Windows 10 安裝
  • 檢查任何可能解決您問題的 WSL 未解決的問題。 通常有關於如何解決此問題的建議,或問題修正所在版本的相關信息。
  • 如果沒有現有的問題與您的問題相關,請在 WSL 上提交新的問題,並確保您包含盡可能多的資訊。

如果您繼續在 WSL 上安裝或執行時發生問題,請考慮 安裝適用於 Windows 的 CLI。

安裝 Azure CLI

RPM 會透過 CBL-Mariner 發行給 Azure Linux。 套件azure-cli支援 CLI 2.46.0的 ARM64 架構。

若要安裝 Azure CLI,請遵循下列步驟:

  1. 安裝官方 Microsoft 精選的受信任的根證書集:

    sudo tdnf install ca-certificates
    
  2. 安裝 Azure CLI:

    sudo tdnf install azure-cli
    

安裝特定版本

您可以在 Azure CLI 版本資訊中找到可用的版本。

若要使用 命令檢視可用的版本:

tdnf list azure-cli

若要安裝特定版本:

sudo tdnf install azure-cli-<version>-1

更新 Azure CLI

使用 tdnf update 命令更新 Azure CLI:

sudo tdnf update azure-cli

卸載 Azure CLI

如果您決定卸載 Azure CLI,我們很遺憾看到您離開。 卸載之前,請使用 az feedback 命令告訴我們可以改進或修正的問題。 我們的目標是讓 Azure CLI 無 Bug 且方便使用者使用。 如果您發現錯誤,如果您 提出 GitHub 問題,我們很感激。

從您的系統移除套件:

sudo tdnf remove azure-cli

移除資料

如果您不打算重新安裝 Azure CLI,請移除其數據。

rm -rf ~/.azure

開始之前

強烈建議使用套件管理員安裝 CLI。 套件管理員可確保您一律會取得最新的更新,並保證 CLI 元件的穩定性。 在手動安裝之前,請檢查並查看您的發行版是否有套件。

Azure CLI 的安裝腳本需要下列軟體:

安裝或更新 Azure CLI

重要

安裝腳本僅適用於 Python 3.8.x、3.9.x 或 3.10.x。 此安裝腳本不適用於 Python 3.11.x 或更新版本。

安裝與更新 Azure CLI 都需要重新執行安裝文稿:

curl -L https://aka.ms/InstallAzureCli | bash

指令碼也可以在本機下載並執行。 您可能需要重新啟動命令列介面,變更才會生效。

卸載 Azure CLI

如果您決定卸載 Azure CLI,我們感到很遺憾。 卸載之前,請使用 az feedback 命令讓我們知道可以改善或修正的問題。 我們的目標是讓 Azure CLI 無 Bug 且方便使用者使用。 如果您發現錯誤,如果您 提出 GitHub 問題,我們很感激。

直接從安裝時選擇的位置刪除檔案,以卸載 CLI。 預設安裝位置是使用者的主目錄($HOME)。

  1. 拿掉已安裝的 CLI 檔案。

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. 修改檔案 $HOME/.bash_profile 以移除下列這一行:

    <install location>/lib/azure-cli/az.completion
    
  3. 如果使用 bashzsh,請重載殼層的命令快取。

    hash -r
    

移除資料

如果您不打算重新安裝 Azure CLI,請移除其數據。

rm -rf ~/.azure

疑難排解

以下是一些手動安裝期間常見的問題。 如果您遇到此處未涵蓋的問題, 請在 GitHub 上提出問題。

不使用 Python 3 安裝

自 2.1.0起,Azure CLI 已放棄對 Python 2.7 的支援。 在您的系統上,可能有一個早於 Python 3.6.x 的 Python 版本。 尋找可替代的 python3 套件。

Curl「物件已移動」錯誤

如果您收到與 curl 參數相關的 -L 錯誤,或出現錯誤訊息指出「物件已移動」,請嘗試使用完整的 URL 而不是 aka.ms 重新導向:

curl https://azurecliprod.blob.core.windows.net/install | bash

az 找不到命令

如果您安裝後無法使用 bashzsh 執行命令,請嘗試清除您殼層中的命令哈希快取,並檢查問題是否已解決。

hash -r

若您在安裝之後未重新啟動Shell,也可能會發生這種情形。 請確定命令的位置 az 位於 您的 $PATH中。 命令的位置為 az ...

 <install path>/bin

Proxy 封鎖連線

如果您因為 proxy 而無法連線到外部資源,請確定您已在 shell 中正確設定 HTTP_PROXYHTTPS_PROXY 變數。 您需要聯系系統管理員,以瞭解用於這些代理伺服器的主機和端口。

許多 Linux 程式會使用這些變數中的值,並在安裝程式期間使用。 若要設定這些值:

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

如果您位於代理伺服器後方,則必須設定這些 Shell 變數,才能使用 CLI 連線到 Azure 服務。 如果您未使用基本身份驗證,建議您在檔案中 .bashrc 匯出這些變數。 請一律遵循您企業的安全策略和系統管理員的需求。

若要取得安裝指令碼,您的 Proxy 必須允許 HTTPS 連線至下列位址:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • 您的操作系統套件管理員(如果有的話)使用的端點,適用於核心套件

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 (WSL) 是 Windows 平臺上的系統呼叫轉譯層,因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤,很有可能是 WSL 的問題,而不是 CLI 安裝程式的問題。

如需對 WSL 安裝進行疑難排解並可能解決問題:

如果您繼續在 WSL 上安裝或執行時發生問題,請考慮 安裝適用於 Windows 的 CLI。

後續步驟

現在您已安裝 Azure CLI,請簡短流覽其功能和常見命令。