在 Linux 上安裝 Azure CLI

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

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

總覽

apt 套件管理員包含 Azure CLI 的 x86_64 套件,已在下列發行版本中進行測試。

散發 版本
Ubuntu 16.04 LTS (Xenial Xerus) , 18.04 LTS (B) 、20.04 LTS (Focal Fossa) 、21.10 (Impish Indri) 、22.04 (Jammy Jellyfish)
Debian 9 (Stretch) 、10 (Buster) 、11 (Bullseye)

警告

從 Azure CLI 2.37.0 開始,Ubuntu 16.04 (Xenial Xerus) 和 Debian 9 (Stretch) 不會發行 DEB 套件。 您可能會在這些系統上繼續使用 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

deb azure-cli 套件不支援 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 簽署金鑰:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. 新增 Azure CLI 軟體存放庫:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=amd64] 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 散發版本,請使用 bionic 存放庫;若是 Debian 散發版本,請使用 stretch。 不支援在 Ubuntu Trusty 和 Debian Wheezy 之前發佈的散發版本。

基本 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
    

概觀

對於 Linux dnf 所隨附的散發套件 (如 RHEL、Fedora 或 CentOS),有適用於 Azure CLI 的套件。 此套件已經過 RHEL 7.7、RHEL 8、Fedora 24 和更新版本、CentOS 7 和 CentOS 資料流程 8 的測試。

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

重要

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

請注意,Python 2 已在 2020 年 1 月 1 日到達生命週期尾聲,而且不會再收到更新。 Azure CLI 從 2.1.0 版開始已捨棄對於 Python 2.7 的支援。 新版本不再保證可搭配 Python 2.7 正確地執行。

注意

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

安裝

  1. 匯入 Microsoft 存放庫金鑰。

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. 針對 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。

您可以使用下面這個命令,以使用從來源建置的 python 3.6 安裝 Azure CLI:

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

您也可以逐步執行:

首先,Azure CLI 需要 SSL 1.1+,而且您必須在建置 python3 之前,先從來源建置 openssl 1.1

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 下載外掛程式,在執行下列程式碼時,您可能會遇到找不到命令錯誤。 使用 dnf install 'dnf-command(download)' 來安裝 dnf 下載外掛程式。

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

或者,您也可以透過某些其他存放庫安裝 Python 3。 如此一來,如果您已設定 python3,但在嘗試執行 cli 時仍然收到錯誤 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
    

概觀

CBL-以1.0 和 2.0 發行的RPM。

安裝

使用 tdnf install 命令安裝:

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

概觀

對於 Linux zypper 所隨附的散發套件 (如 openSUSE 或 SLES),有適用於 Azure CLI 的套件。 此套件已在 openSUSE Leap 15.1 和 SLES 15 上經過測試。

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

重要

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

請注意,Python 2 已在 2020 年 1 月 1 日到達生命週期尾聲,而且不會再收到更新。 Azure CLI 從 2.1.0 版開始已捨棄對於 Python 2.7 的支援。 新版本不再保證可搭配 Python 2.7 正確地執行。

安裝

  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 有一個預先安裝的 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

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

在 SLES 12 上,預設的 python3 套件是 3.4,但 Azure CLI 不支援。 您可以先遵循安裝指示的步驟 1-3 來新增 azure-cli 存放庫。 然後再從來源建立較高版本的 python3。 最後,您可以下載 Azure CLI 套件,並在沒有相依性的情況下安裝。

您可以使用下列一個命令,根據上述步驟來安裝或更新 Azure CLI。 腳本將會安裝在 Python 3.8 底下 /usr/local/azcli ,並將 的 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
    

概觀

注意

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

CLI 需要下列軟體:

重要

CLI 從 2.1.0 版開始已捨棄對於 Python 2.7 的支援。 新版本不再保證可搭配 Python 2.7 正確地執行。

安裝或更新

安裝及更新 CLI 都需要重新執行安裝指令碼。 執行 curl 來安裝 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 命令

若您在安裝之後無法執行命令及使用 bashzsh,請清除殼層的命令雜湊快取。 執行

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,接下來請簡單認識一下其功能和常用命令。