安裝 Azure 傳統 CLI
重要
本主題將說明如何安裝 Azure 傳統 CLI。 傳統 CLI 已有替代產品,應只搭配傳統部署模型使用。 針對所有其他部署,請使用 Azure CLI。
快速安裝 Azure 傳統 CLI 以使用一組開放原始碼的命令介面式命令,用於建立和管理 Microsoft Azure 中的資源。 有數個選項可讓您在電腦上安裝這些跨平台工具︰
- npm 套件 - 執行 npm (適用於 JavaScript 的套件管理員) 將 Azure 傳統 CLI 套件安裝在您的 Linux 散發套件或作業系統上。 需要 Node.js 和 npm。
- 安裝程式 - 下載安裝程式以輕鬆在 macOS 或 Windows 上安裝。
- Docker 容器 - 在已就緒可執行的 Docker 容器中開始使用傳統 CLI。 需要 Docker 主機。
如需詳細的選項和背景,請參閱 GitHub上的專案儲存機制。
安裝好 Azure 傳統 CLI 之後,連線至 azure login
並從命令列介面 (Bash、終端機及命令提示字元等) 中執行 azure
命令以使用 Azure 資源。
選項 1:安裝 npm 套件
若要從 npm 套件安裝傳統 CLI,請確定已下載並安裝最新的 Node.js 和 npm。 然後,執行 npm install
,以安裝 azure-cli 套件:
npm install -g azure-cli
在 Linux 散發套件上,建議您使用 sudo
,才能順利執行 npm
命令,如下所示:
sudo npm install -g azure-cli
注意
如果您需要在作業系統上安裝或更新 Node.js 和 npm,建議您安裝 Node.js LTS 4.x 版或更新版本。 如果您使用較舊的版本,可能會發生安裝錯誤。
根據您的偏好,也可以從 GitHub 版本下載 tar 檔案。 然後,安裝下載的 npm 套件,如下所示 (在 Linux 散發套件上,建議您使用 sudo
):
npm install -g <path to downloaded tar file>
選項 2:使用安裝程式
如果您使用 Mac 或 Windows 電腦,可從 GitHub 版本中取得 DMG 和 MSI 安裝程式︰
提示
在 Windows 中,您也可以下載 Web Platform Installer 來安裝傳統 CLI。 這個安裝程式可讓您選擇安裝額外的 Azure SDK 和命令列工具。
選項 3:使用 Docker 容器
如果您已將電腦設定為 Docker 主機,您可以在 Docker 容器中執行 Azure 傳統 CLI。 執行下列命令 (在 Linux 散發套件上,您可能需要使用 sudo
):
docker run -it mcr.microsoft.com/azure-cli:0.10.14
執行 Azure 傳統 CLI
安裝好傳統 CLI 之後,從命令列使用者介面 (Bash、終端機及命令提示字元等) 中執行 azure
命令。 例如,若要執行 [說明] 命令,請輸入下列命令:
azure help
注意
在某些 Linux 散發套件上,您可能會收到類似 /usr/bin/env: ‘node’: No such file or directory
的錯誤訊息。 此錯誤訊息是來自最近安裝在 /usr/bin/nodejs 的 Node.js。 若要修正此錯誤,請執行此命令來建立 /usr/bin/node 的符號連結︰
sudo ln -s /usr/bin/nodejs /usr/bin/node
若要查看您所安裝的 Azure 傳統 CLI 版本,請輸入下列命令:
azure --version
注意
當您第一次使用 Azure 傳統 CLI 時會看到一則訊息,詢問您是否要允許 Microsoft 收集使用情況資訊。 參與為自願性質。 如果您選擇參與,只要執行 azure telemetry --disable
即可隨時停止參與。 只要執行 azure telemetry --enable
即可隨時啟用參與。
更新傳統 CLI
Microsoft 可能會發行 Azure 傳統 CLI 的更新版本。 請使用適用於您作業系統的安裝程式來重新安裝傳統 CLI,或執行最新的 Docker 容器。 或者,如果您已安裝最新的 Node.js 和 npm,請輸入下列命令來進行更新 (在 Linux 散發套件上,建議您使用 sudo
)。
npm update -g azure-cli
啟用 TAB 鍵自動完成
針對 Mac 和 Linux 提供傳統 CLI 命令 TAB 鍵自動完成支援。
若要在 zsh 中啟用它,請執行︰
echo '. <(azure --completion)' >> .zshrc
若要在 bash 中啟用它,請執行︰
azure --completion >> ~/azure.completion.sh
echo 'source ~/azure.completion.sh' >> ~/.bash_profile
下一步
- 若要深入了解 Azure 傳統 CLI、下載來源程式碼、回報問題,或是參與專案,請造訪 Azure 傳統 CLI 的 GitHub 存放庫。