欢迎使用 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
安装 azd
choco install azd
更新 azd
choco upgrade azd
卸载 azd
choco uninstall azd
安装 azd
安装脚本使用默认参数在计算机上下载并安装 MSI 包。
powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"
更新 azd
powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"
卸载 azd
使用卸载脚本删除 azd 会在计算机上留下某些项目。
相反,对于版本 0.5.0-beta.1 及更高版本:
在 Windows 中搜索 添加或删除程序。
找到 Azure Dev CLI并选择三个点以展开选项菜单。
选择卸载。
注释
目前对 Windows Arm64 的支持处于 Alpha 阶段。 有关详细信息,请访问 功能版本控制与发布策略 页。
azd的 Arm64 版本可直接在 GitHub 发布页上下载。 目前,没有直接支持包管理器安装程序或其他通道。
安装 azd
注释
如果您的计算机已安装 Windows x86_64 版本的 azd,请先卸载 x86_64 版本,以防止在进行 MSI 升级或维修时覆盖 Arm64 可执行文件。
在GitHub 发布页上,下载最新的azd-windows-arm64-alpha.zip文件。
提取 azd-windows-arm64-alpha.zip 文件,并将 azd-windows-amd64.exe 可执行文件复制到设备上的默认 azd 位置 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI。
将一个条目添加到设备上的 PATH 环境变量,以指向 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe 提取文件。
更新 azd
在GitHub 发布页上,下载最新的azd-windows-arm64-alpha.zip文件。
提取 azd-windows-arm64-alpha.zip 文件,并将 azd-windows-amd64.exe 可执行文件复制到设备上的默认 azd 位置 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI,以替换现有可执行文件。
验证您的设备上是否有一个环境变量 PATH 指向提取文件所在位置 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe。
卸载 azd
从设备上的默认 azd-windows-amd64.exe 位置中删除 azd 可执行文件C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI。 如果安装在 azd 其他位置,则需要从该位置将其删除。
删除您添加的PATH环境变量,这些变量用于指向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 过程将自动为计算机的体系结构选择正确的二进制文件。
安装脚本可用于在计算机范围内安装正确的版本 azd 。
curl -fsSL https://aka.ms/install-azd.sh | bash
更新 azd
curl -fsSL https://aka.ms/install-azd.sh | bash
卸载 azd
curl -fsSL https://aka.ms/uninstall-azd.sh | bash
安装 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
Azure开发人员 CLI 将签名的 .deb 和 .rpm 包发布到 GitHub Releases。 若要安装或更新,请从GitHub版本下载相应的文件,并运行相应的命令以安装包:**
安装或更新.deb的软件包以适用于azd
你可以使用 .deb 来安装 apt-get 包。
curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd_<version>_amd64.deb -o azd_<version>_amd64.deb
apt update
apt install ./azd_<version>_amd64.deb -y
卸载 .deb 的 azd 包
apt remove -y azd
Azure开发人员 CLI 将签名的 .deb 和 .rpm 包发布到 GitHub Releases。 若要安装,请从GitHub版本下载相应的文件,并运行相应的命令来安装包:**
安装 .rpm 包用于 azd
你可以使用 .rpm 来安装 yum install 包。
curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd-<version>-1.x86_64.rpm -o azd-<version>-1.x86_64.rpm
yum install -y azd-<version>-1.x86_64.rpm
卸载 .rpm 的 azd 包
yum remove -y azd
先决条件
在开始使用 azd之前,请确保具备:
在开发容器中安装azd
开发容器是一个 Docker 映像,其中包含在本地计算机上运行应用所需的所有先决条件。 通过以下步骤在开发容器中安装 azd 为功能:
将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...
}
重新生成并运行开发容器。 在Visual Studio Code中,使用 命令面板执行 在开发容器中重新生成和重新打开命令。
验证安装
azd通过在终端中运行azd version命令来验证安装是否成功完成:
azd version
azd 打印当前版本:
azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)
更新Azure开发人员 CLI
使用过时版本 azd时,你将看到升级到最新版本的警告。 按照警告中的说明更新到最新版本。
请求帮助
有关如何提交 bug、请求帮助或为 Azure 开发人员 CLI 提出新功能的信息,请访问 troubleshooting and support 页。
后续步骤