Partilhar via

Criar um ambiente a partir de um modelo de CLI do Azure Developer

  • Artigo

Neste artigo, você cria um novo ambiente a partir de um modelo existente compatível com a CLI do Desenvolvedor do Azure (azd) usando o azd. Você aprende a configurar os Ambientes de Implantação do Azure (ADE) e azd a trabalhar em conjunto para provisionar a infraestrutura do aplicativo e implantar o código do aplicativo na nova infraestrutura.

Para aprender os principais conceitos de como azd e o ADE funcionam juntos, consulte Usar a CLI do Desenvolvedor do Azure com Ambientes de Implantação do Azure.

Pré-requisitos

Anexar catálogo de início rápido da Microsoft

A Microsoft fornece um catálogo de início rápido que contém um conjunto de azd modelos compatíveis que você pode usar para criar ambientes. Você pode anexar o catálogo de início rápido ao seu centro de desenvolvimento na criação ou adicioná-lo mais tarde. O catálogo de início rápido contém um conjunto de modelos que você pode usar para criar ambientes.

Examinar um azd modelo compatível

Você pode usar um modelo compatível existente azd para criar um novo ambiente ou pode adicionar um arquivo azure.yaml ao repositório. Nesta seção, você examina um modelo compatível existente azd .

azd O provisionamento para ambientes depende de modelos selecionados do catálogo. Os modelos no catálogo podem atribuir tags a recursos provisionados do Azure para você associar seus serviços de aplicativo no arquivo azure.yaml ou especificar os recursos explicitamente. Neste exemplo, os recursos são especificados explicitamente.

Para obter mais informações sobre como marcar recursos, consulte Marcando recursos para ambientes de implantação do Azure.

  1. No portal do Azure, navegue até o centro de desenvolvimento.

  2. No menu à esquerda, em Configuração do ambiente, selecione Catálogos e copie a URL de clonagem do catálogo de início rápido.

    Captura de ecrã do portal do Azure a mostrar os catálogos anexados a um centro de desenvolvimento, com o URL de clone realçado.

  3. Para visualizar o catálogo de início rápido no GitHub, cole o URL do clone na barra de endereço e pressione Enter. Ou, você pode usar a seguinte URL: Catálogo de início rápido da Microsoft.

  4. No repositório GitHub, navegue até a pasta Environment-Definitions/ARMTemplates/Function-App-with-Cosmos_AZD-template .

  5. Abra o arquivo environment.yaml . No final do arquivo, você verá os repositórios permitidos que contêm código-fonte de aplicativo de exemplo.

    Captura de tela do repositório GitHub, mostrando o arquivo environment.yaml com modelos de origem realçados.

  6. Copie a URL do https://github.com/azure-samples/todo-python-mongo-swa-func repositório e navegue até o repositório no GitHub.

  7. Na raiz do repositório, abra o arquivo azure.yaml .

  8. No arquivo azure.yaml, na seção serviços, você vê os serviços Web e de API definidos no modelo.

Nota

Nem todos os azd catálogos compatíveis usam a estrutura de modelos vinculados mostrada no exemplo. Você pode usar um único catálogo para todos os seus ambientes incluindo o arquivo azure.yaml. O uso de vários catálogos e repositórios de código permite mais flexibilidade na configuração de acesso seguro para engenheiros e desenvolvedores de plataforma.

Se você estiver trabalhando com sua própria definição de catálogo e ambiente, poderá criar um arquivo azure.yaml na raiz do repositório. Use o arquivo azure.yaml para definir os serviços que você deseja implantar no ambiente.

Criar um ambiente a partir de um modelo existente

Use um modelo compatível existente azd para criar um novo ambiente.

Prepare-se para trabalhar com azd

Quando você trabalha pela azd primeira vez, há algumas tarefas de configuração únicas que você precisa concluir. Essas tarefas incluem instalar a CLI do Desenvolvedor do Azure, entrar em sua conta do Azure e habilitar azd o suporte para Ambientes de Implantação do Azure.

Instalar a extensão da CLI do Azure Developer

Quando você instala azdo , as ferramentas são instaladas azd dentro de um azd escopo em vez de globalmente e são removidas se azd for desinstalada. Você pode instalar azd no Visual Studio Code, na linha de comando ou no Visual Studio.

Para habilitar os recursos da CLI do Desenvolvedor do Azure no Visual Studio Code, instale a extensão da CLI do Desenvolvedor do Azure. Selecione o ícone Extensões na barra de atividades, procure CLI do Azure Developer e selecione Instalar.

Captura de tela do Visual Studio Code, mostrando o comando Entrar na paleta de comandos.

Entrar com a CLI do Desenvolvedor do Azure

Aceda aos seus recursos do Azure iniciando sessão. Quando você inicia um logon, uma janela do navegador é aberta e solicita que você faça logon no Azure. Depois de entrar, o terminal exibe uma mensagem informando que você está conectado ao Azure.

Entre usando azd a paleta de comandos:

Captura de tela do Visual Studio Code, mostrando o painel Extensões com a CLI do Desenvolvedor do Azure e Instalação realçadas.

A saída de comandos emitidos a partir da paleta de comandos é exibida em um terminal azd dev como o exemplo a seguir:

Captura de tela do terminal do desenvolvedor AZD, mostrando a mensagem de pressionar qualquer tecla para fechar.

Habilitar azd suporte para ADE

Quando platform.type definido como devcenter, todo o azd estado e provisionamento do ambiente remoto usa componentes do centro de desenvolvimento. azd Usa um dos modelos de infraestrutura definidos no catálogo do Centro de Desenvolvimento para provisionamento de recursos. Nessa configuração, a pasta infra em seus modelos locais não é usada.

Captura de tela do Visual Studio Code, mostrando o comando Enable support na paleta de comandos.

Criar um novo ambiente

Agora você está pronto para criar um ambiente para trabalhar. Você começa com um modelo existente. O ADE define a infraestrutura para seu aplicativo e o azd modelo fornece código de aplicativo de exemplo.

  1. No Visual Studio Code, abra uma pasta vazia.

  2. Abra a paleta de comandos, insira Azure Developer CLI init e, na lista, selecione Azure Developer CLI (azd): init.

    Captura de ecrã da paleta de comandos do Visual Studio Code com a CLI do Azure Developer (azd): init realçada.

  3. Na lista de modelos, selecione Function-App-with-Cosmos_AZD-template.

    Captura de tela da paleta de comandos do Visual Studio Code com uma lista de modelos, Function App realçado.

  4. No terminal, insira um nome de azd ambiente.

    Captura de tela do terminal do Desenvolvedor do Azure, mostrando o prompt para um novo nome de ambiente.

  5. Selecione um projeto.

    Captura de tela do terminal do Desenvolvedor do Azure, mostrando o prompt para selecionar um projeto.

  6. Selecione uma definição de ambiente.

    Captura de tela do terminal do Desenvolvedor do Azure, mostrando o prompt para selecionar uma definição de ambiente.

    azd Cria os recursos do projeto, incluindo um arquivo Azure.yaml na raiz do seu projeto.

Configure seu devcenter

Você pode definir azd configurações para seus centros de desenvolvimento para não precisar especificá-las sempre que atualizar um ambiente. Neste exemplo, você define os nomes do catálogo, centro de desenvolvimento e projeto que está usando para seu ambiente.

  1. No Visual Studio Code, navegue até o arquivo azure.yaml na raiz do seu projeto.

  2. No arquivo azure.yaml, adicione as seguintes configurações:

    platform:
    type: devcenter
    config:
        catalog: MS-cat
        name: Contoso-DevCenter
        project: Contoso-Dev-project

    Captura de tela do arquivo azure.yaml com as configurações do centro de desenvolvimento realçadas.

Para saber mais sobre as configurações que você pode definir, consulte Definir configurações do centro de desenvolvimento.

Provisione seu ambiente

Você pode usar azd para provisionar e implantar recursos em seus ambientes de implantação usando comandos como azd up ou azd provision.

Para saber mais sobre como provisionar seu ambiente, consulte Trabalhar com ambientes de implantação do Azure.

Conteúdos relacionados