Azure 开发人员 CLI 扩展概述

Azure 开发人员 CLI (azd) 扩展是扩展 Azure 开发人员 CLI 功能的模块化组件。 它们允许你添加新功能、自动执行工作流,以及直接从 CLI 与其他服务集成。 扩展可帮助你根据不断变化的团队需求和 Azure 方案进行定制 azd

启用扩展

扩展当前处于初始功能阶段。 若要启用扩展支持,请在终端中运行以下命令:

azd config set alpha.extensions on

此命令可在 azd 环境中启用扩展的管理和使用。

管理扩展源

扩展是通过扩展源进行分发和管理的,因此随着需求的增长,可以轻松发现、安装和更新它们。

  • 扩展源是文件清单或基于 URL 的清单文件,它们提供可用 azd 扩展的列表。
  • 用户可以添加连接到专用、本地或公共注册表的自定义扩展源。
  • 扩展源是与 NuGet 或 Node 包管理器(NPM)源相等的概念,必须符合 官方扩展注册表架构

azd 提供了两个扩展源注册表,可帮助你开始使用扩展:

  • 官方扩展源注册表已预配置,并托管在azd
  • 还可以将 开发扩展注册表 添加到 azd 配置中。 此选择加入注册表包含可用于内部测试的实验性扩展,这些扩展可能或可能不会成为官方扩展。

若要选择加入开发注册表,请运行以下命令:

# Add a new extension source name 'dev' to your `azd` configuration.
azd extension source add -n dev -t url -l "https://aka.ms/azd/extensions/registry/dev"

谨慎

开发注册表中托管的扩展目前不包含已签名的二进制文件。

扩展源命令

使用以下命令管理安装的扩展源 azd

列出已安装的扩展源

azd extension source list

添加新的扩展源

azd extension source add -n <name> -t url -l <registry-url>
  • -l, --___location:扩展源的位置。
  • -n, --name:扩展源的名称。
  • -t, --type:扩展源的类型。 支持的类型为文件和 URL。

删除扩展源

azd extension source remove <name>

管理扩展

启用扩展并配置扩展源后,可以安装扩展以向其中添加新功能 azd。 请访问 快速入门 - 使用 AI 扩展 文章获取使用扩展的示例。

列出扩展

`azd extension list [flags]
  • --installed 显示已安装扩展的列表。
  • --source 仅列出来自指定源的扩展。
  • --tags 允许按标记筛选扩展 (AI, 测试)

安装扩展

azd extension install <extension-names> [flags]

请将 <extension-name> 替换为您要安装的扩展名称。

  • -v, --version 指定要在安装扩展时应用的版本约束。
  • -s, --source 指定用于安装的扩展源。

升级扩展

azd extension upgrade <extension-name>
  • --all 在指定时升级以前安装的所有扩展。
  • -v, --version 使用版本约束(如果提供)升级指定的扩展。
  • -s, --source 指定用于安装的扩展源。

卸载扩展

azd extension uninstall <extension-name>
  • --all 指定时删除所有已安装的扩展。

后续步骤