次の方法で共有

チュートリアル: .NET Aspire プロジェクトを Redis キャッシュを使用して Azure に配置する

  • [アーティクル]

このチュートリアルでは、.NET Aspireへのデプロイ用に Redis Cache を使用して Azure プロジェクトを構成する方法について説明します。 .NET Aspire では、Redisで異なる Azure サービスをプロビジョニングする複数のキャッシュ統合構成が提供されます。 次の方法について学習します。

  • Azure Azure Cache for Redis をプロビジョニングするようにアプリを構成する
  • コンテナー化された Redis Cache をプロビジョニングするようにアプリを構成する

手記

このドキュメントは、特に.NET Aspire 構成に注目し、RedisでAzure キャッシュ リソースをプロビジョニングおよびデプロイする方法について説明します。 詳細と、完全な .NET.NET Aspire 展開プロセスの詳細については、Azure Container Apps 展開 チュートリアルを参照してください。

前提 条件

.NET .NET Aspireを使用するには、次のものがローカルにインストールされている必要があります。

詳細については、 セットアップとツールの、および SDK を参照してください。

サンプル ソリューションを作成する

「チュートリアル: .NET.NET Aspire 統合 を使用してキャッシュを実装してサンプル プロジェクトを作成する」に従います。

Redis キャッシュのデプロイ用にアプリを構成する

.NET Aspire には、Redisでの Azure キャッシュのデプロイを効率化するための 2 つの組み込み構成オプションが用意されています。

  • Redis を使用してコンテナー化された Azure Container Apps Cache をプロビジョニングする
  • Azure Azure Cache for Redis インスタンスをプロビジョニングする

.NET .NET Aspire 統合をアプリに追加する

目的のホスティング サービスの .NET プロジェクトに適切な .NET Aspire 統合を追加します。

📦 Aspireの.Hosting.Azure.NuGetパッケージを、Redis を使って AspireRedis.AppHost プロジェクトに追加します。

dotnet add package Aspire.Hosting.Azure.Redis

AppHost プロジェクトを構成する

目的の サービスの 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 リソースが作成されます。

アプリをデプロイする

Azure Developer CLI (azd) などのツールは、デプロイを効率化するための .NET AspireRedis 統合構成をサポートします。 azd は、これらの設定を活用して、適切に構成されたリソースを提供します。

手記

CLI または Bicep を して、プロジェクト リソース プロビジョニングおよびデプロイすることもできます。 これらのオプションでは、より多くの手動手順が必要になりますが、デプロイをより細かく制御できます。 .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 リソースが不要になったら、次の Azure CLI コマンドを実行してリソース グループを削除します。 リソース グループを削除すると、その中に含まれるリソースも削除されます。

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

詳細については、「リソースをクリーンアップする」に関して、Azureを参照してください。

参照