Compartilhar via

Visão geral das extensões da CLI do Desenvolvedor do Azure

As extensões da CLI do Desenvolvedor do Azure (azd) são componentes modulares que estendem a funcionalidade da CLI do Desenvolvedor do Azure. Elas permitem que você adicione novos recursos, automatize fluxos de trabalho e integre-se a outros serviços diretamente da CLI. As extensões ajudam você a adaptar-se azd às necessidades de equipe em evolução e aos cenários do Azure.

Observação

azd as extensões estão atualmente na versão beta.

Gerenciar fontes de extensão

As extensões são distribuídas e gerenciadas por meio de fontes de extensão, facilitando a descoberta, instalação e atualização delas conforme seus requisitos aumentam.

  • As fontes de extensão são manifestações baseadas em arquivos ou URLs que fornecem listas de extensões disponíveis azd.
  • Os usuários podem adicionar fontes de extensão personalizadas que se conectam a registros privados, locais ou públicos.
  • As fontes de extensão são um conceito equivalente aos feeds do NuGet ou NPM (Gerenciador de Pacotes do Node) e devem aderir ao esquema oficial do registro de extensão.

azd fornece dois registros de origem de extensão para ajudá-lo a começar a usar extensões:

  • O registro de origem da extensão oficial está pré-configurado azd e está hospedado em https://aka.ms/azd/extensions/registry.
  • O registro de extensão de desenvolvimento também pode ser adicionado à sua azd configuração. Esse registro de aceitação contém extensões experimentais para testes internos que podem ou não se tornar extensões oficiais.

Para aceitar o registro de desenvolvimento, execute o seguinte comando:

# 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"

Cuidado

As extensões hospedadas no registro de desenvolvimento NÃO contêm binários assinados no momento.

Comandos de origem da extensão

Use os comandos a seguir para gerenciar fontes de extensão para sua azd instalação.

Listar fontes de extensão instaladas

azd extension source list

Adicionar uma nova fonte de extensão

azd extension source add -n <name> -t url -l <registry-url>
  • -l, --location: o local da origem da extensão.
  • -n, --name: Nome da fonte da extensão.
  • -t, --type: o tipo de fonte da extensão. Os tipos com suporte são arquivo e URL.

Remover uma fonte de extensão

azd extension source remove <name>

Gerenciar extensões

Depois que as extensões estiverem habilitadas e as fontes de extensão estiverem configuradas, você poderá instalar extensões para adicionar novos recursos.azd Visite o artigo Início Rápido – use a extensão de IA para um exemplo de como trabalhar com extensões.

Extensões de lista

`azd extension list [flags]
  • --installed Exibe uma lista de extensões instaladas.
  • --source Listar somente extensões da origem especificada.
  • --tags Permite filtrar extensões por marcas (IA, teste)

Instalar uma extensão

azd extension install <extension-names> [flags]

Substitua <extension-name> pelo nome da extensão que você deseja instalar.

  • -v, --version Especifica a restrição de versão a ser aplicada ao instalar extensões.
  • -s, --source Especifica a fonte de extensão usada para instalações.

Atualizar uma extensão

azd extension upgrade <extension-name>
  • --all Atualiza todas as extensões instaladas anteriormente quando especificadas.
  • -v, --version Atualiza uma extensão especificada usando uma restrição de versão, se fornecida.
  • -s, --source Especifica a fonte de extensão usada para instalações.

Desinstalar uma extensão

azd extension uninstall <extension-name>
  • --all Remove todas as extensões instaladas quando especificadas.

Próximas etapas

  • Last updated on