Condividi tramite

Esercitazione: Distribuire un progetto di .NET Aspire con una memoria cache Redis su Azure

Questa esercitazione illustra come configurare un progetto di .NET Aspire con una cache Redis per la distribuzione in Azure. .NET Aspire fornisce più configurazioni di integrazione della cache che eseguono il provisioning di diversi servizi di Redis in Azure. Si apprenderà come:

  • Configurare l'app per la configurazione di un AzureAzure Cache for Redis
  • Configurare l'app per il provisioning di una cache containerizzata Redis

Nota

Questo documento è incentrato in particolare sulle configurazioni di .NET Aspire per effettuare il provisioning e distribuire le risorse della cache Redis in Azure. Per altre informazioni e per altre informazioni sul processo di distribuzione completo , vedere l'esercitazione sulla distribuzione di .

Prerequisiti

Per usare .NET.NET Aspire, è necessario che il codice seguente sia installato in locale:

Per altre informazioni, vedere .NET.NET Aspire configurazione e strumentie .NET.NET Aspire SDK.

Creare la soluzione di esempio

Seguire il Tutorial: Implementare il caching con le integrazioni di .NET,.NET Aspire e per creare un progetto di esempio.

Configurare l'app per la distribuzione della cache Redis

.NET Aspire offre due opzioni di configurazione predefinite per semplificare la distribuzione della cache Redis in Azure:

  • Effettuare il provisioning di una cache Redis in contenitori usando Azure Container Apps
  • Eseguire il provisioning di un'istanza AzureAzure Cache for Redis

Aggiungere l'integrazione .NET.NET Aspire all'app

Aggiungere l'integrazione appropriata al progetto AspireRedis.AppHost per il servizio di hosting desiderato.

Aggiungere il pacchetto NuGet 📦Aspire.Hosting.Azure.Redis al progetto AspireRedis.AppHost:

dotnet add package Aspire.Hosting.Azure.Redis

Configurare il progetto AppHost

Configurare il progetto di aspiraredis.AppHost per il servizio di desiderato.

Sostituire il contenuto del file Program.cs nel progetto AspireRedis.AppHost con il codice seguente:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddAzureRedis("cache");

var apiService = builder.AddProject<Projects.AspireRedis_ApiService>("apiservice")
                        .WithReference(cache);

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

builder.Build().Run();

Il codice precedente aggiunge una risorsa AzureAzure Cache for Redis all'app e configura una connessione denominata cache. Il metodo AddAzureRedis garantisce che strumenti come il Azure Developer CLI o il Visual Studio creino una risorsa Azure Cache for Redis nel corso del processo di distribuzione.

Distribuire l'app

Strumenti come Azure Developer CLI (azd) supportano le configurazioni di integrazione .NET AspireRedis per semplificare le distribuzioni. azd utilizza queste impostazioni e effettua il provisioning di risorse correttamente configurate per te.

Nota

È anche possibile usare dell'interfaccia della riga di comando di o Bicep per effettuare il provisioning e distribuire le risorse del progetto . Queste opzioni richiedono passaggi più manuali, ma offrono un controllo più granulare sulle distribuzioni. I progetti .NET Aspire possono connettersi anche a un'istanza di Redis esistente tramite configurazioni manuali.

  1. Apri una finestra del terminale nella directory principale del tuo progetto .NET.NET Aspire.

  2. Eseguire il comando azd init per inizializzare il progetto con azd.

    azd init

  3. Quando viene richiesto un nome di ambiente, immettere docs-aspireredis.

  4. Eseguire il comando azd up per avviare il processo di distribuzione:

    azd up

  5. Seleziona la sottoscrizione Azure che dovrebbe ospitare le risorse dell'app.

  6. Selezionare la posizione Azure da usare.

    Il Azure Developer CLI configura e dispone le risorse dell'app. Il completamento del processo potrebbe richiedere alcuni minuti.

  7. Al termine della distribuzione, cliccare sul collegamento del gruppo di risorse nell'output per visualizzare le risorse che sono state create nel portale Azure.

Il processo di distribuzione ha assegnato una risorsa AzureAzure Cache for Redis in base alla configurazione .AppHost che hai fornito.

Screenshot che mostra il AzureAzure Cache for Redisdistribuito.

Pulire le risorse

Esegui il seguente comando CLI di Azure per eliminare il gruppo di risorse quando le risorse Azure create non sono più necessarie. L'eliminazione del gruppo di risorse comporta anche l'eliminazione delle risorse contenute all'interno di essa.

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

Per ulteriori informazioni, vedere Ripulisci le risorse in Azure.

Vedere anche