Partilhar via

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

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

Observação

azd As extensões estão atualmente em 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 sua descoberta, instalação e atualização à medida que suas necessidades crescem.

  • As fontes de extensão são manifestos que se baseiam em ficheiros ou URLs e 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 do Gerenciador de Pacotes de Nó (NPM) e devem aderir ao esquema de registro de extensão oficial.

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 e hospedado em azdhttps://aka.ms/azd/extensions/registry.
  • O registro da extensão de desenvolvimento também pode ser adicionado à sua azd configuração. Este registo de aceitação contém extensões experimentais para testes internos que podem ou não tornar-se 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"

Atenção

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

Comandos de fonte de 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: A localização da fonte de extensão.
  • -n, --name: O nome da fonte de extensão.
  • -t, --type: O tipo de fonte de extensão. Os tipos suportados 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 suas fontes de extensão estiverem configuradas, você poderá instalar extensões para adicionar novos recursos ao azd. Visite o Guia de início rápido - use o artigo da extensão AI para obter um exemplo de trabalho com extensões.

Extensões de lista

`azd extension list [flags]
  • --installed Exibe uma lista de extensões instaladas.
  • --source Liste apenas extensões da fonte especificada.
  • --tags Permite filtrar extensões por tags (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 especificado.
  • -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 especificado.

Próximos passos

  • Last updated on