Поделиться через

Руководство: развертывание проекта .NET Aspire с помощью кэша Redis в Azure

  • Статья

В этом руководстве описано, как настроить проект .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.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 для нужного хостинг-сервиса.

Добавьте 📦Aspire.Hosting.Azure.Redis пакет NuGet в проект AspireRedis.AppHost:

dotnet add package Aspire.Hosting.Azure.Redis

Настройка проекта AppHost

Настройте проект AspireRedis.AppHost для нужной службы Redis.

Замените содержимое файла Program.cs в проекте AspireRedis.AppHost следующим кодом:

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 во время процесса развертывания.

Развертывание приложения

Такие средства, как Azure Developer CLI (azd) поддерживают конфигурации интеграции .NET AspireRedis для упрощения развертываний. azd использует эти параметры и организует правильно настроенные ресурсы для вас.

Заметка

Вы также можете использовать Azure CLI или Bicep для подготовки и развертывания ресурсов проекта .NET.NET Aspire. Эти параметры требуют дополнительных действий вручную, но обеспечивают более детализированный контроль над развертываниями. .NET Aspire проекты также могут подключаться к существующему экземпляру Redis с помощью конфигураций вручную.

  1. Откройте окно терминала в корне проекта .NET.NET Aspire.

  2. Выполните команду azd init, чтобы инициализировать проект с помощью azd.

    azd init

  3. При появлении запроса на имя среды введите docs-aspireredis.

  4. Выполните команду azd up, чтобы начать процесс развертывания:

    azd up

  5. Выберите подписку Azure, которая должна размещать ресурсы приложения.

  6. Выберите место Azure для использования.

    Azure Developer CLI осуществляет подготовку и развертывание ресурсов приложения. Процесс может занять несколько минут.

  7. По завершении развертывания щелкните ссылку группы ресурсов в выходных данных, чтобы просмотреть созданные ресурсы на портале Azure.

Процесс развертывания создал ресурс AzureAzure Cache for Redis благодаря конфигурации .AppHost, предоставленной вами.

Снимок экрана, показывающий развернутый AzureAzure Cache for Redis.

Очистка ресурсов

Выполните следующую команду Azure CLI, чтобы удалить группу ресурсов, если вам больше не нужны созданные ресурсы Azure. При удалении группы ресурсов также удаляются ресурсы, содержащиеся в нем.

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

Дополнительные сведения см. в разделе Очистка ресурсов в Azure.

См. также