Implantar um Aspire projeto em Azure Container Apps

Aspire Os projetos são projetados para serem executados em ambientes conteinerizados. Azure Container Apps é um ambiente totalmente gerenciado que permite executar microsserviços e aplicativos em contêineres em uma plataforma sem servidor. Este artigo irá guiá-lo através da criação de uma nova Aspire solução e implantá-la na Microsoft Azure Container Apps usando o Azure Developer CLI (azd). Você aprenderá a concluir as seguintes tarefas:

Pré-requisitos

Para trabalhar com Aspire, necessita do seguinte software instalado localmente:

• .NET 8,0 ou .NET 9,0.
  • A partir da Aspire versão 9.4, .NET o 10 Preview 5 ou posterior é suportado.
• Um ambiente de execução de contenedor compatível com OCI, como:
  • Docker Desktop ou Podman. Para obter mais informações, consulte Container runtime.
• Um ambiente de desenvolvedor integrado (IDE) ou editor de código, como:
  • Visual Studio 2022 versão 17.9 ou superior (opcional)
  • Visual Studio Code (Opcional)
    • C# Dev Kit: Extensão (Opcional)
  • JetBrains Rider com o plugin Aspire (Opcional)

Para obter mais informações, consulte Aspire configuração e ferramentas e Aspire SDK.

Como alternativa a este tutorial e para obter um guia mais aprofundado, consulte Implantação de um Aspire projeto em Azure Container Apps usando azd (guia detalhado).

Desenvolva Aspire projetos com azd

Com Aspire e Azure Container Apps (ACA), você tem um ótimo cenário de hospedagem para criar as suas aplicações nativas da nuvem com .NET. Incorporamos alguns novos recursos incríveis no Azure Developer CLI (azd) específicos para tornar o desenvolvimento e a implantação de Aspire para Azure uma experiência sem atrito. Para cenários de produção que exigem controle granular sobre a infraestrutura, consulte Personalizar AspireAzure implantações. Mas para novos projetos, você não encontrará um caminho mais fácil para o sucesso para obter uma nova topologia de microsserviço implantada na nuvem.

Criar um Aspire projeto

Como ponto de partida, este artigo pressupõe que você criou um Aspire projeto a partir do Aspire modelo Aplicativo inicial . Para obter mais informações, consulte Guia de início rápido: criar seu primeiro Aspire projeto.

Nomenclatura de recursos

Ao criar novos Azure recursos, é importante seguir os requisitos de nomenclatura. Para Azure Container Apps, o nome deve ter de 2 a 32 caracteres e consistir em letras minúsculas, números e hífenes. O nome deve começar com uma letra e terminar com um caractere alfanumérico.

Para obter mais informações, consulte Regras de nomenclatura e restrições para Azure recursos.

Instale o Azure Developer CLI

O processo de instalação azd varia de acordo com o seu sistema operacional, mas está amplamente disponível via winget, brew, apt, ou diretamente via curl. Para instalar o azd, consulte Instalar Azure Developer CLI.

Inicializar o modelo

1. Abra uma nova janela do terminal e cd no diretório da sua Aspire solução.

2. Execute o comando azd init para inicializar seu projeto com azd, que inspecionará a estrutura de diretórios local e determinará o tipo de aplicativo.

   azd init
   

   Para obter mais informações sobre o comando azd init, consulte azd init.

3. Selecione Usar código no diretório atual quando azd lhe solicitar três opções de inicialização da app.

   ? How do you want to initialize your app?  [Use arrows to move, type to filter]
   > Use code in the current directory
     Select a template
     Create a minimal project
   

4. Depois de verificar o diretório, azd solicita que você confirme que encontrou o projeto Aspire correto. Selecione a opção Confirmar e continuar inicializando meu aplicativo.

   Detected services:
   
     .NET (Aspire)
     Detected in: D:\source\repos\AspireSample\AspireSample.AppHost\AspireSample.AppHost.csproj
   
   azd will generate the files necessary to host your app on Azure using Azure Container Apps.
   
   ? Select an option  [Use arrows to move, type to filter]
   > Confirm and continue initializing my app
     Cancel and exit
   

5. Insira um nome de ambiente, que é usado para nomear recursos provisionados no Azure e gerenciar ambientes diferentes, como dev e prod.

   Generating files to run your app on Azure:
   
     (✓) Done: Generating ./azure.yaml
     (✓) Done: Generating ./next-steps.md
   
   SUCCESS: Your app is ready for the cloud!
   You can provision and deploy your app to Azure by running the azd up command in this directory. For more information on configuring your app, see ./next-steps.md
   

azd gera vários arquivos e os coloca no diretório de trabalho. Estes ficheiros são:

• azure.yaml: descreve os serviços do aplicativo, como Aspire projeto AppHost, e os mapeia para Azure recursos.
• .azure/config.json: Arquivo de configuração que informa azd qual é o ambiente ativo atual.
• .azure/aspireazddev/.env: Contém substituições específicas do ambiente.

Implementar o modelo

1. Depois que um azd modelo é inicializado, o processo de provisionamento e implantação pode ser executado como um único comando do diretório do projeto AppHost usando azd up:

   azd up
   

2. Selecione a assinatura na qual deseja implantar na lista de opções disponíveis:

   Select an Azure Subscription to use:  [Use arrows to move, type to filter]
     1. SampleSubscription01 (xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx)
     2. SampleSubscription02 (xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx)
   

3. Selecione o local desejado Azure para usar na lista de opções disponíveis:

   Select an Azure location to use:  [Use arrows to move, type to filter]
     42. (US) Central US (centralus)
     43. (US) East US (eastus)
   > 44. (US) East US 2 (eastus2)
     46. (US) North Central US (northcentralus)
     47. (US) South Central US (southcentralus)
   

Depois de fazer suas seleções, azd executa o processo de provisionamento e implantação.

By default, a service can only be reached from inside the Azure Container Apps environment it is running in. Selecting a service here will also allow it to be reached from the Internet.
? Select which services to expose to the Internet webfrontend
? Select an Azure Subscription to use:  1. <YOUR SUBSCRIPTION>
? Select an Azure location to use: 1. <YOUR LOCATION>

Packaging services (azd package)


Provisioning Azure resources (azd provision)
Provisioning Azure resources can take some time.

Subscription: <YOUR SUBSCRIPTION>
Location: <YOUR LOCATION>

  You can view detailed progress in the Azure Portal:
  <LINK TO DEPLOYMENT>

  (✓) Done: Resource group: <YOUR RESOURCE GROUP>
  (✓) Done: Container Registry: <ID>
  (✓) Done: Log Analytics workspace: <ID>
  (✓) Done: Container Apps Environment: <ID>

SUCCESS: Your application was provisioned in Azure in 1 minute 13 seconds.
You can view the resources created under the resource group <YOUR RESOURCE GROUP> in Azure Portal:
<LINK TO RESOURCE GROUP OVERVIEW>

Deploying services (azd deploy)

  (✓) Done: Deploying service apiservice
  - Endpoint: <YOUR UNIQUE apiservice APP>.azurecontainerapps.io/

  (✓) Done: Deploying service webfrontend
  - Endpoint: <YOUR UNIQUE webfrontend APP>.azurecontainerapps.io/

Aspire Dashboard: <LINK TO DEPLOYED Aspire DASHBOARD>

SUCCESS: Your up workflow to provision and deploy to Azure completed in 3 minutes 50 seconds.

O azd up comando atua como wrapper para os seguintes comandos individuais azd para provisionar e implantar seus recursos em uma única etapa:

1. azd package: Os projetos de aplicativo e suas dependências são empacotados em contêineres.
2. azd provision: Os Azure recursos que o aplicativo precisará são provisionados.
3. azd deploy: Os projetos são enviados como contentores para uma Azure instância do Registo de Contentores e, em seguida, usados para criar novas revisões de Azure Container Apps onde o código será hospedado.

Quando as azd up etapas forem concluídas, seu aplicativo estará disponível no Azure, e você poderá abrir o Azure portal para explorar os recursos. azd também gera URLs para acessar os aplicativos implantados diretamente.

Testar o aplicativo implantado

Agora que o aplicativo foi provisionado e implantado, você pode navegar até o Azure portal. No grupo de recursos onde você implantou o aplicativo, você verá os três aplicativos de contêiner e outros recursos.

Clique em web Container App para o abrir no portal.

Clique no link URL do aplicativo para abrir o front-end no navegador.

Quando clica no nó "Weather" na barra de navegação, a aplicação de contêiner front-end web realiza uma chamada à aplicação de contêiner apiservice para obter dados. A saída do front-end será armazenada em cache através da aplicação de contentor e da integração de Cache de Saída . Ao atualizar o front-end algumas vezes, você notará que os dados meteorológicos são armazenados em cache. Ele será atualizado após alguns segundos.

Implantar o Aspire painel

Você pode implantar o Aspire painel como parte do seu aplicativo hospedado. Este recurso agora é totalmente suportado. Durante a implantação, os logs de saída azd imprimem uma URL adicional para o painel implantado.

Você pode executar azd monitor para iniciar automaticamente o painel.

azd monitor

Limpeza de recursos

Execute o seguinte comando Azure CLI para excluir o grupo de recursos quando não precisar mais dos recursos Azure criados. A exclusão do grupo de recursos também exclui os recursos contidos nele.

az group delete --name <your-resource-group-name>

Para obter mais informações, consulte Limpeza de recursos no Azure.