通过

安装或更新Azure开发人员 CLI

欢迎使用 Azure Developer CLI（azd）！ 让我们开始安装和了解如何运行 azd。

首先选择开发环境。 有关不同开发环境选择的优缺点的详细信息，请参阅 Azure 开发人员 CLI （azd） 支持的环境。

有关更高级的安装方案和说明，请参阅Azure开发人员 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 上，需要罗塞塔 2。 如果尚未安装 Rosetta 2，请从终端运行 softwareupdate --install-rosetta。

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

安装 azd

brew install azure/azd/azd

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

更新 azd

brew upgrade azure/azd/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.json文件夹的.devcontainer文件。

    {
    "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 扩展插件

azd开发容器功能支持在extensions容器生成期间自动安装以逗号分隔的azd扩展列表的选项。 容器启动后，即可使用这种方式安装的扩展，减少手动安装，并启用 azd 命令以使用已安装所需的扩展运行。

若要自动安装扩展，请将 extensions 选项添加到 azd 文件中的功能条目 devcontainer.json ：

{
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        "ghcr.io/azure/azure-dev/azd:latest": {
            "extensions": "my-ext-1,my-ext-2"
        }
    }
}

该值 extensions 是以逗号分隔的 azd 扩展名称列表。 安装发生在容器生成期间，因此扩展可以在容器启动时立即使用。 更改扩展列表后，使用 Visual Studio Code 中的“重新生成并重新打开开发容器 ”命令，以使用更新的扩展重新生成容器。

进一步了解 azd 开发容器功能。

验证安装

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

azd version

azd 打印当前版本：

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

更新Azure开发人员 CLI

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

请求帮助

有关如何提交 bug、请求帮助或为 Azure 开发人员 CLI 提出新功能的信息，请访问 troubleshooting and support 页。

后续步骤

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

Azure 开发人员 CLI 模板是什么？

Azure开发人员 CLI 常见问题解答

  • Last updated on