Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tutorial, se aprenderá a configurar un Aspire proyecto con una Redis memoria caché para la implementación en Azure. Aspire proporciona varias configuraciones de integración de almacenamiento en caché que aprovisionan servicios diferentes Redis en Azure. Aprenderá a:
- Configurar la aplicación para aprovisionar una AzureAzure Cache for Redis
- Configuración de la aplicación para aprovisionar una caché en Redis contenedor
Nota:
Este documento se centra específicamente en Aspire las configuraciones para aprovisionar e implementar Redis recursos de caché en Azure. Para obtener más información y obtener más información sobre el proceso de implementación completo Aspire , consulte el Azure Container Apps tutorial de implementación .
Prerrequisitos
Para trabajar con Aspire, necesita lo siguiente instalado localmente:
-
.NET 8.0 o .NET 9.0.
- Aspire A partir de la versión 9.4, .NET se admite la versión preliminar 5 o posterior de 10.
- Un entorno de ejecución de contenedor compatible con OCI, como:
- Docker Escritorio o Podman. Para obtener más información, consulte container runtime.
- Un entorno para desarrolladores integrado (IDE) o un editor de código, como:
- Visual Studio 2022 versión 17.9 o posterior (opcional)
-
Visual Studio Code (opcional)
- C# Dev Kit: extensión (opcional)
- JetBrains Rider con Aspire complemento (opcional)
Para obtener más información, consulte Aspire configuración y herramientas y Aspire SDK.
Configuración de la aplicación para la Redis implementación de caché
Aspire proporciona dos opciones de configuración integradas para simplificar la Redis implementación de caché en Azure:
- Aprovisionar una caché contenedorizada Redis usando Azure Container Apps
- Aprovisionamiento de una AzureAzure Cache for Redis instancia
Incorporación de la Aspire integración a la aplicación
Agregue la integración adecuada Aspire al proyecto AspireRedis.AppHost para el servicio de hospedaje deseado.
Agregue el 📦Aspire.Hosting.Azure.Redis paquete NuGet al proyecto AspireRedis.AppHost:
dotnet add package Aspire.Hosting.Azure.Redis
Configuración del proyecto AppHost
Configure el proyecto AspireRedis.AppHost para el servicio deseado Redis .
Reemplace el contenido del Program.cs archivo en el proyecto AspireRedis.AppHost por el código siguiente:
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();
El código anterior agrega un AzureAzure Cache for Redis recurso a la aplicación y configura una conexión denominada cache. El método AddAzureRedis garantiza que herramientas como Azure Developer CLI o Visual Studio creen un recurso Azure Cache for Redis durante el proceso de implementación.
Implementación de la aplicación
El aspire deploy comando admite AspireRedis configuraciones de integración para simplificar las implementaciones. El comando consume estas configuraciones y aprovisiona los recursos configurados adecuadamente para ti.
Nota:
También puede usar la Azure CLI o Bicep para aprovisionar e implementar Aspire recursos del proyecto. Estas opciones requieren más pasos manuales, pero proporcionan un control más pormenorizado sobre las implementaciones. Aspire Los proyectos también se pueden conectar a una instancia existente Redis a través de configuraciones manuales.
Para implementar la aplicación en Azure Container Apps, ejecute el siguiente comando desde el directorio AspireRedis.AppHost :
aspire deploy
Al ejecutar el aspire deploy comando por primera vez, se le pedirá que:
- Inicie sesión en Azure: siga las indicaciones de autenticación para iniciar sesión en su Azure cuenta.
- Seleccione una suscripción: elija la Azure suscripción que desea usar para la implementación.
- Seleccione o cree un grupo de recursos: elija un grupo de recursos existente o cree uno nuevo.
- Seleccione una ubicación: elija la región en la Azure que desea implementar los recursos.
El proceso de implementación aprovisionará los recursos necesarios Azure e implementará la Aspire aplicación. El proceso puede tardar unos minutos en completarse.
Cuando finalice la implementación, la salida del comando proporcionará información sobre los recursos implementados que puede ver en el Azure portal.
Limpieza de recursos
Ejecute el siguiente comando Azure CLI para eliminar el grupo de recursos cuando ya no necesite los recursos de Azure que creó. Al eliminar el grupo de recursos también se eliminan los recursos contenidos en él.
az group delete --name <your-resource-group-name>
Para obtener más información, consulte el apartado Limpieza de recursos en Azure.