在 Linux 上安裝 Azure CLI

Azure CLI 是可在 Linux 電腦上本機安裝的跨平臺命令列工具。 您可以使用 Linux 上的 Azure CLI 連線到 Azure,並在 Azure 資源上執行系統管理命令。 Linux 上的 CLI 允許使用互動式命令列提示或腳本,透過終端機執行各種命令。 當您準備好在 Linux 上安裝 Azure CLI 時,建議您使用 Linux 發行版本的套件管理員。 從上述選項中,為您的發行版本選取適當的套件管理員。 如果您沒有其中一個列出的套件管理員,您可以選取 [ 安裝腳本 ] 選項,在 Linux 上手動安裝 Azure CLI。

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

概觀

針對具有 dnf 的 Linux 發行版本,例如 RHEL 8/9 或 CentOS Stream 8/9,Azure CLI 有 RPM 套件。

警告

Azure CLI 2.39.0 (于 2022/08/2022 發行) 是 RHEL 7 和 Centos 7 上支援的最後一個版本,而且會持續收到安全性修正,直到作業系統生命週期結束為止。 Microsoft 不會在此版本上提供任何其他更新或錯誤修正。

Azure CLI 和 Linux 安裝腳本 將繼續由 Microsoft 開發及支援。 Red Hat 和 CentOS 存放庫所提供的套件是由其各自的散發套件維護及支援。

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

重要

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

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

注意

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

注意

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

安裝

  1. 匯入 Microsoft 存放庫金鑰。

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

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

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

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

    針對 RHEL 7 或 CentOS 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
    
  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
    

疑難排解

以下是一些使用 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 封鎖連線

如果因為 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]

重要

如果您使用 Proxy,這些殼層變數必須設為使用 CLI 連線到 Azure 服務。 如果您並未使用基本驗證,建議您匯出 .bashrc 檔案中的這些變數。 務必遵循您的企業安全性原則和系統管理員的需求。

建議您明確地將 dnf 設定為一律使用此 Proxy。 請確定下列幾行有出現在 /etc/dnf/dnf.conf[main] 部份中:

[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

無法在適用於 Linux 的 Windows 子系統上安裝 CLI,或無法在適用於 Linux 的 Windows 子系統上執行 CLI

由於適用於 Linux 的 Windows 子系統 (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

更新

CLI 會提供工具內命令,以更新為最新版本:

az upgrade

注意

az upgrade 命令是在 2.11.0 版中新增的,無法與 2.11.0 版之前的版本搭配運作。 您可以重新安裝舊版,如 安裝 Azure CLI中所述。

根據預設,此命令也會更新所有已安裝的延伸模組。 如需更多的 az upgrade 選項,請參閱命令參考頁面

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

sudo dnf update 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
    

警告

Microsoft 針對 SUSE Linux Enterprise Server 所開發的最後一個 Azure CLI 套件 (SLES) ,而 OpenSUSE (Leap) 版本為 2.38.0 (于 2022/07/05 發行) 。 您可能會在這些系統上繼續使用 Azure CLI 的歷程記錄版本,但這些版本的 Microsoft 不會再進行更新或錯誤修正。

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

概觀

在 Azure 中,SUSE 和 OpenSUSE 虛擬機器 (VM) ,Azure Marketplace映射已安裝 Azure Command-Line 介面 (Azure CLI) 。

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

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

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

安裝 Azure CLI

從 SUSE 或 OpenSUSE 存放庫安裝

重要

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

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

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
    

疑難排解

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

OpenSUSE 15 VM 上的 NotImplementedError

OpenSUSE 15 VM 有已安裝 2.0.45 版的預先安裝的 Azure CLI,其已過期且有問題 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

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

在 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 變數。 您必須連絡系統管理員,了解這些 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 ,以一律使用此 Proxy。 若要這樣做,請以超級使用者的角色執行 yast2 proxy 命令,並在表單中填寫相關資訊。 如果您可在系統上使用視窗管理員,也可以使用 Network Services > Proxy 中的 YaST Control Center 窗格。

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

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

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

無法在適用於 Linux 的 Windows 子系統上安裝 CLI,或無法在適用於 Linux 的 Windows 子系統上執行 CLI

由於適用於 Linux 的 Windows 子系統 (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

更新

CLI 會提供工具內命令,以更新為最新版本:

az upgrade

注意

az upgrade 命令是在 2.11.0 版中新增的,無法與 2.11.0 版之前的版本搭配運作。 您可以重新安裝舊版,如 安裝 Azure CLI中所述。

根據預設,此命令也會更新所有已安裝的延伸模組。 如需更多的 az upgrade 選項,請參閱命令參考頁面

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

sudo zypper refresh
sudo zypper update 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
    

概觀

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

散發 版本
Ubuntu 18.04 LTS (B) 、20.04 LTS (Focal Fossa) 、22.04 (Jammy Jellyfish)
Debian 10 (Buster) ,11 (Bullseye)

警告

您可能會繼續使用舊系統上的 Azure CLI 歷程記錄版本,但不會有任何更新或錯誤修正。 請考慮升級至較新版本的 Ubuntu 或 Debian,以使用最新的 Azure CLI。

警告

Ubuntu 20.04 (Focal Fossa) 和 20.10 (Groovy Gorilla) 包含 universe 存放庫所提供 2.0.81 版的 azure-cli 套件。 此套件已過期且不建議使用。 如果已安裝此套件,請先加以移除,再繼續執行命令 sudo apt remove azure-cli -y && sudo apt autoremove -y。 如需 的詳細資訊 apt remove ,請參閱Ubuntu 套件管理要求 ubuntu

注意

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

安裝選項

有兩個選項可在您的系統上安裝 Azure CLI。 您可以下載將為您執行安裝命令的安裝腳本,或者,如果您想要的話,可以在逐步程式中自行執行安裝命令。 兩種方法分別提供如下。

選項 1:使用單一命令進行安裝

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 ca-certificates curl apt-transport-https lsb-release gnupg
    
  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_REPO=$(lsb_release -cs)
    echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. 更新存放庫資訊並安裝 azure-cli 套件:

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

安裝特定版本

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

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

    apt-cache policy azure-cli
    
  2. 若要安裝特定版本:

    sudo apt-get install azure-cli=<version>-1~bullseye
    

疑難排解

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

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

如果您已在 Focal 上安裝 azure-cli,但未在手動安裝指示的步驟 3 中新增 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 散發套件,請使用最新的 bullseye 存放庫:

AZ_REPO="bullseye"

重要

不支援在 UbuntuB和 Debian Buster 之前發行的發行版本。

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

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

原始檔案內容:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

修改的檔案內容

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

Proxy 封鎖連線

如果因為 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]

重要

如果您使用 Proxy,這些殼層變數必須設為使用 CLI 連線到 Azure 服務。 如果您並未使用基本驗證,建議您匯出 .bashrc 檔案中的這些變數。 務必遵循您的企業安全性原則和系統管理員的需求。

建議您明確地將 apt 設定為一律使用此 Proxy。 請確定下列幾行有出現在 /etc/apt/apt.conf.d/apt 組態檔中。 建議使用現有的通用組態檔、現有的 Proxy 組態檔 40proxies、或 99local,但依照您的系統管理需求設定。

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

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

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

  • https://packages.microsoft.com

無法在適用於 Linux 的 Windows 子系統上安裝 CLI,或無法在適用於 Linux 的 Windows 子系統上執行 CLI

由於適用於 Linux 的 Windows 子系統 (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

更新

CLI 會提供工具內命令,以更新為最新版本:

az upgrade

注意

az upgrade 命令是在 2.11.0 版中新增的,無法與 2.11.0 版之前的版本搭配運作。 您可以重新安裝舊版,如 安裝 Azure CLI中所述。

根據預設,此命令也會更新所有已安裝的延伸模組。 如需更多的 az upgrade 選項,請參閱命令參考頁面

您也可以使用 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,我們很遺憾您不再繼續使用。 您在解除安裝之前,請使用 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.list
    
  3. 如果您未從 Microsoft 使用其他套件,請移除簽署金鑰:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
    
  4. 移除任何不必要的套件:

    sudo apt autoremove
    

概觀

Azure Linux發行的RPM。

注意

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

安裝

  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

更新

使用 tdnf update 命令更新 Azure CLI:

sudo tdnf update azure-cli

解除安裝

如果您決定要解除安裝 Azure CLI,我們很遺憾您不再繼續使用。 您在解除安裝之前,請使用 az feedback 命令,讓我們知道可以加強或修正之處。 我們的目標是讓 Azure CLI 既沒有錯誤又易於使用。 如果找到錯誤 (bug),希望您提出 GitHub 問題,非常感謝您。

從您的系統移除套件:

sudo tdnf remove azure-cli

概觀

注意

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

CLI 需要下列軟體:

重要

自 版本 2.1.0 起,Azure CLI 已卸載 Python 2.7 的支援。 較新版本可能無法使用 Python 2.7 正確執行。

安裝或更新

安裝和更新 Azure CLI 都需要重新執行安裝腳本。

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

指令碼也可以在本機下載並執行。 您可能需要重新開機殼層,變更才會生效。

疑難排解

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

CURL「物件已移動」錯誤

如果您收到與 -L 參數有關,來自 curl 的錯誤,或者是包含「物件已移動」文字的錯誤訊息,請嘗試使用完整的 URL 而非 aka.ms 來重新導向:

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

找不到 az 命令

如果您使用 或 zsh 安裝 bash 之後無法執行命令,請嘗試清除殼層的命令雜湊快取,並檢查問題是否已解決。

hash -r

若您在安裝之後未重新啟動殼層,也可能會發生這種情形。 請確定 az 命令的位置是在 $PATHaz 命令的位置在

 <install path>/bin

Proxy 封鎖連線

如果因為 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]

重要

如果您使用 Proxy,這些殼層變數必須設為使用 CLI 連線到 Azure 服務。 如果您並未使用基本驗證,建議您匯出 .bashrc 檔案中的這些變數。 務必遵循您的企業安全性原則和系統管理員的需求。

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

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • 由散發套件管理員 (如果有) 供核心套件使用的端點

無法在適用於 Linux 的 Windows 子系統上安裝 CLI,或無法在適用於 Linux 的 Windows 子系統上執行 CLI

由於適用於 Linux 的 Windows 子系統 (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,我們很遺憾您不再繼續使用。 您在解除安裝之前,請使用 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

後續步驟

現在您已安裝 Azure CLI,接下來請簡單認識一下其功能和常用命令。