通过

安装或更新 Azure Developer CLI

  • 项目

欢迎使用 Azure Developer CLI (azd)！ 我们来开始安装 azd 并了解如何运行它。

首先选择您的开发环境。 有关不同开发环境选择的优缺点的详细信息，请参阅 Azure Developer CLI (azd) 支持的环境。

有关更高级的安装方案和说明，请参阅 Azure Developer CLI 安装程序脚本。

注意：安装 azd 时，以下工具也会安装在 azd 范围内（这意味着它们不会全局安装），如果卸载 azd，则会删除这些工具：

安装 azd

winget install microsoft.azd

更新 azd

winget upgrade microsoft.azd

卸载 azd

winget uninstall microsoft.azd

注意

在 Apple Silicon Mac（M1 和 M2）上，azd 需要 Rosetta 2。 如果尚未安装 Rosetta 2，请从终端运行 softwareupdate --install-rosetta。

azd 安装进程将自动为计算机的体系结构选择正确的二进制文件。

安装 azd

brew tap azure/azd && brew install azd

只需运行一次 brew tap azure/azd 命令，即可在 brew 中配置点击。

如果要使用 brew 从未使用 brew 安装的版本升级 azd，请使用卸载脚本删除现有版本的 azd（如果已安装到默认位置），或者通过手动删除 azd 二进制文件来删除它。 这将自动安装正确的版本。

更新 azd

brew upgrade azd

卸载 azd

brew uninstall azd

安装 azd

curl -fsSL https://aka.ms/install-azd.sh | bash

更新 azd

curl -fsSL https://aka.ms/install-azd.sh | bash

安装 azd 时，以下工具会安装在 azd 范围内（这意味着它们不会全局安装），如果卸载 azd，则会删除这些工具：

卸载 azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

先决条件

在开始使用 azd 之前，请确保您：

在开发容器中安装 azd

开发容器是一个 Docker 映像，其中包含在本地计算机上运行应用所需的所有先决条件。 通过以下步骤在开发容器中安装 azd 功能：

  1. 将 azd 功能添加到模板根目录下 .devcontainer 文件夹内的 devcontainer.json 文件中。

    {
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        // See https://containers.dev/features for list of features
        "ghcr.io/devcontainers/features/docker-in-docker:2": {
        },
        "ghcr.io/azure/azure-dev/azd:latest": {}
    }
    // Rest of file omitted...
}

  2. 重新生成并运行开发容器。 在 Visual Studio Code 中，使用命令面板执行在容器中重新生成并重新打开命令。

验证安装

通过在终端中运行 azd version 命令来验证 azd 安装是否成功完成：

azd version

azd 将打印当前版本：

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

更新 Azure Developer CLI

使用过时版本的 azd 时，您将看到升级到最新版本的警告。 按照警告中的说明更新到最新版本。

请求帮助

有关如何提交 bug、请求帮助或为 Azure Developer CLI 建议新功能的信息，请访问故障排除和支持页面。

后续步骤

快速入门 - 选择并部署 azd 模板

什么是 Azure Developer CLI 模板？

Azure Developer CLI FAQ