教程：将带有 .NET Aspire 缓存的 Redis 项目部署到 Azure

项目
12/18/2024

本教程介绍如何使用 .NET Aspire 缓存配置 Redis 项目，以便部署到 Azure。 .NET Aspire 提供了多个缓存集成配置，用于在 Redis中预配不同的 Azure 服务。你将了解如何：

配置应用以预配 AzureAzure Cache for Redis
配置应用以预配容器化 Redis 缓存

注意

本文档重点介绍 .NET Aspire 配置，用于在 Redis中预配和部署 Azure 缓存资源。有关完整 .NET.NET Aspire 部署过程的详细信息，请参阅 Azure Container Apps 部署教程。

先决条件

若要使用 .NET.NET Aspire，需要在本地安装以下各项：

.NET 8.0 或 .NET 9.0
符合 OCI 的容器运行时，例如：
- Docker 桌面或 Podman。有关详细信息，请参阅容器运行时。
集成开发人员环境（IDE）或代码编辑器，例如：
- Visual Studio 2022 17.9 或更高版本（可选）
- Visual Studio Code （可选）
  - C# Dev Kit：扩展（可选）
- JetBrains Rider 使用 .NET.NET Aspire 插件（可选）

有关详细信息，请参阅 .NET.NET Aspire 设置和工具，以及 .NET.NET Aspire SDK。

创建示例解决方案

按照教程：使用 .NET.NET Aspire 集成实现缓存，创建示例项目。

为 Redis 缓存部署配置应用

.NET Aspire 提供了两个内置配置选项，用于简化 Redis上的 Azure 缓存部署：

使用 Redis 预配容器化 Azure Container Apps 缓存
配置 AzureAzure Cache for Redis 实例

将 .NET.NET Aspire 集成添加到应用

将合适的 .NET.NET Aspire 集成添加到 AspireRedis.AppHost 项目中，以便用于您需要的托管服务。

Azure Cache for Redis
Redis 容器

添加 📦Aspire.Hosting.Azure.Redis NuGet 包到 AspireRedis.AppHost 项目：

dotnet add package Aspire.Hosting.Azure.Redis

添加 📦Aspire.Hosting.Redis NuGet 包到 AspireRedis.AppHost 项目：

dotnet add package Aspire.Hosting.Redis

配置 AppHost 项目

为所需的服务配置 Redis 项目。

Azure Cache for Redis
Redis 容器

将 Program.cs 项目中文件的内容替换为以下代码：

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();

前面的代码将 AzureAzure Cache for Redis 资源添加到应用，并配置名为 cache的连接。 AddAzureRedis 方法可确保 Azure Developer CLI 或 Visual Studio 等工具在部署过程中创建 Azure Cache for Redis 资源。

将 Program.cs 项目中文件的内容替换为以下代码：

var builder = DistributedApplication.CreateBuilder(args);

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

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

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

builder.Build().Run();

前面的代码将 Redis 容器资源添加到应用，并配置名为 cache的连接。此配置还确保部署过程中 Azure Developer CLI 或 Visual Studio 等工具创建容器化 Redis 实例。

部署应用

Azure Developer CLI（azd）等工具支持 .NET AspireRedis 集成配置来简化部署。 azd 处理这些设置并为你提供正确配置的资源。

注意

还可以使用 Azure CLI 或 Bicep 来预配和部署 .NET.NET Aspire 项目资源。这些选项需要更多的手动步骤，但提供对部署的更精细的控制。 .NET Aspire 项目还可以通过手动配置连接到现有 Redis 实例。

在 .NET.NET Aspire 项目的根目录中打开终端窗口。
运行 azd init 命令，使用 azd初始化项目。
```
azd init
```
当系统提示输入环境名称时，输入 docs-aspireredis。
运行 azd up 命令以开始部署过程：
```
azd up
```
选择用于托管应用资源的 Azure 订阅。
选择要使用的 Azure 位置。

Azure Developer CLI 提供和部署应用资源。此过程可能需要几分钟才能完成。
部署完成后，单击输出中的资源组链接，在 Azure 门户中查看已创建的资源。

Azure Cache for Redis
Redis 容器

由于 ，部署过程预配了 AzureAzure Cache for Redis 资源。提供的 AppHost 配置。

显示已部署 AzureAzure Cache for Redis的屏幕截图。

清理资源

运行以下 Azure CLI 命令，在不再需要创建的 Azure 资源时删除资源组。删除资源组也会删除其中包含的资源。

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

有关详细信息，请参阅清理 Azure中的资源。

另请参阅

通过部署
.NET Aspire Azure Container Apps 部署深度解析
GitHub 部署项目

通过