Compartilhar via

Tutorial: Implantar um projeto de .NET Aspire com um Banco de Dados SQL Server para Azure

  • Artigo

Neste tutorial, você aprenderá a configurar um aplicativo ASP.NET Core com um Banco de Dados SQL Server para implantação para Azure. .NET Aspire fornece várias configurações de integração SQL Server que provisionam diferentes serviços de banco de dados no Azure. Você aprenderá a:

  • Criar um aplicativo de ASP.NET Core básico configurado para usar a integração .NET AspireSQL Server
  • Configurar o aplicativo para provisionar um Banco de Dados SQL Azure
  • Configurar o aplicativo para provisionar um banco de dados SQL Server em contêineres

Nota

Este documento se concentra especificamente nas configurações de .NET Aspire para provisionar e implantar recursos SQL Server em Azure. Visite o tutorial de implantação Azure Container Apps para saber mais sobre o processo completo de implantação de .NET.NET Aspire.

Pré-requisitos

Para trabalhar com .NET.NET Aspire, você precisa do seguinte instalado localmente:

Para obter mais informações, consulte .NET.NET Aspirede instalação e ferramentas e .NET.NET Aspiredo SDK.

Criar a solução de exemplo

  1. Na parte superior do Visual Studio, navegue até >Nova>Projeto.
  2. Na janela da caixa de diálogo, pesquise Aspire e selecione .NET.NET Aspire – Aplicativo Inicial. Selecione Próximo.
  3. Na tela Configurar seu novo projeto:
    • Insira um nome do projeto de AspireSQL.
    • Deixe o rest dos valores em seus valores padrão e selecione Avançar.
  4. Na tela Informações adicionais:
    • Verifique se .NET 9.0 está selecionado e escolha Criar.

Visual Studio cria uma nova solução ASP.NET Core estruturada para usar .NET Aspire. A solução consiste nos seguintes projetos:

  • AspireSQL.Web: um projeto de Blazor que depende dos padrões de serviço.
  • AspireSQL.ApiService: um projeto de API que depende dos padrões de serviço.
  • AspireSQL.AppHost: um projeto de orquestrador projetado para conectar e configurar os diferentes projetos e serviços do seu aplicativo. O orquestrador deve ser definido como o projeto inicial.
  • AspireSQL.ServiceDefaults: uma biblioteca de classes compartilhada para armazenar configurações que podem ser reutilizadas entre os projetos em sua solução.

Configurar o aplicativo para implantação SQL Server

.NET Aspire fornece duas opções de configuração internas para simplificar a implantação de SQL Server em Azure:

  • Provisionar um banco de dados SQL Server em contêineres usando Azure Container Apps
  • Provisione uma instância do Banco de Dados SQL Azure

Adicionar a integração .NET.NET Aspire ao aplicativo

Adicione a integração apropriada ao projeto de AspireSQL.AppHost para o serviço de hospedagem desejado.

Adicione o pacote NuGet 📦Aspire.Hosting.Azure.Sql ao projeto AspireSQL.AppHost:

dotnet add package Aspire.Hosting.Azure.Sql

Configurar o projeto AppHost

Configure o projeto AspireSQL.AppHost para o serviço de banco de dados SQL desejado.

Substitua o conteúdo do arquivo no projeto AspireSQL.AppHost pelo seguinte código:

var builder = DistributedApplication.CreateBuilder(args);

var apiService = builder.AddProject<Projects.AspireSql_ApiService>("apiservice");

// Provisions an Azure SQL Database when published
var sqlServer = builder.AddAzureSqlServer("sqlserver")
                       .AddDatabase("sqldb");

builder.AddProject<Projects.AspireSql_Web>("webfrontend")
    .WithExternalHttpEndpoints()
    .WithReference(apiService)
    .WaitFor(apiService);

builder.Build().Run();

O código anterior adiciona um recurso de contêiner SQL Server ao seu aplicativo e configura uma conexão com um banco de dados chamado sqldata. O método PublishAsAzureSqlDatabase garante que ferramentas como o Azure Developer CLI ou Visual Studio criem um recurso do Banco de Dados SQL Azure durante o processo de implantação.

Implantar o aplicativo

Ferramentas como o Azure Developer CLI (azd) dão suporte a configurações de integração .NET AspireSQL Server para simplificar as implantações. azd consome essas configurações e provisiona recursos configurados corretamente para você.

Inicializar o modelo

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

  2. Execute o comando azd init para inicializar seu projeto com azd, que inspecionará a estrutura do diretório 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 solicitar duas opções de inicialização de aplicativo.

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

  4. Depois de verificar o diretório, solicitará que você confirme que encontrou o projeto correto do AppHost . Selecione a opção Confirme e continue a inicializar 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 em 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 arquivos são:

  • azure.yaml: descreve os serviços do aplicativo, como o projeto AppHost .NET Aspire, e os mapeia para os recursos Azure.
  • .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.

Implantar o modelo

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

    azd up

  2. Selecione a assinatura na qual você 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. SamepleSubscription02 (xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx)

  3. Selecione o local de Azure desejado a ser usado 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 .NET ASPIRE DASHBOARD>

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

O comando azd up atua como wrapper para os seguintes comandos de azd individuais 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 recursos de Azure que o aplicativo precisará serão provisionados.
  3. azd deploy: Os projetos são implantados como contêineres em uma instância de Registro de Contêiner Azure e, em seguida, usados para criar novas revisões de Azure Container Apps, nas quais o código será hospedado.

Quando os estágios de azd up forem concluídos, seu aplicativo estará disponível no Azuree você poderá abrir o portal Azure para explorar os recursos. azd também gera URLs para acessar os aplicativos implantados diretamente.

O processo de implantação provisionou um recurso do Banco de Dados SQL Azure devido à configuração .AppHost que você forneceu.

Uma captura de tela mostrando o Banco de Dados SQL Azure implantado.

Limpar recursos

Execute o seguinte comando Azure CLI para excluir o grupo de recursos quando você não precisar mais dos recursos de Azure que você criou. Excluir o 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.

Consulte também