共用方式為


如何在 Docker 容器中執行 Azure CLI

您可以使用 Docker 搭配預安裝 Azure CLI 來執行獨立 Linux 容器,並提供快速且隔離的環境,以使用 Azure CLI。 此容器映像也可以做為您自己的自定義部署基底。

警告

Azure CLI 2.63.0 (2024 年 8 月發行)是 Alpine 型 Docker 映射上支持的最終版本。 Microsoft不再提供此映像的更新或錯誤修正。 若要確保持續支援,請移轉至完全維護的 Azure Linux 映射 (Azure Linux 3.0)。 請參閱下列使用 Azure Linux 3.0 的範例。

若要隱藏警告訊息,請執行: az config set core.only_show_errors=yes。 如需組態選項的詳細資訊,請參閱 Azure CLI 組態值和環境變數

使用預安裝 Azure CLI 啟動 Docker 容器

開啟命令提示字元,然後使用下列命令啟動已預先安裝 Azure CLI 的 Docker 容器。 在管線中使用此命令時,請使用確定性標記 (例如 azurelinux3.0) 以確保一致的行為。

docker run -it mcr.microsoft.com/azure-cli:azurelinux3.0

備註

若要在容器內使用本機 SSH 金鑰,請加入下列選項來掛接 .ssh 目錄: --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh。 這個選項可讓容器從用戶環境存取 SSH 金鑰。

docker run -it --mount type=bind,src="$HOME"/.ssh,dst=/root/.ssh mcr.microsoft.com/azure-cli:azurelinux3.0

Azure CLI 作為 az 命令可在映像中使用,位於 /usr/local/bin/az

使用特定版本的 Azure CLI 執行 Docker 容器

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

若要在 Docker 容器中執行特定版本的 Azure CLI,請使用下列命令,將 取代 2.74.0 為您所需的版本。

docker run -it mcr.microsoft.com/azure-cli:2.74.0-azurelinux3.0

更新 Docker 映像

若要在使用 Docker 時更新 Azure CLI,您必須提取最新的映像,並重新建立任何現有的容器。 由於此更新程式,請避免使用 Azure CLI 容器作為持續性數據存放區。

使用下列命令更新本機映射:

docker pull mcr.microsoft.com/azure-cli:latest

刪除 Docker 映像

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

若要移除 Docker 映射,請先停止任何執行中的容器,然後執行:

docker rmi mcr.microsoft.com/azure-cli

後續步驟

既然您已準備好在 Docker 容器中使用 Azure CLI,請快速流覽其主要功能和常用命令以開始使用。