® integracja buforowania danych wyjściowych .NET AspireRedis^*

Artykuł
12/15/2024

obejmuje:integrację hostingu i integracjęClient

Dowiedz się, jak używać integracji buforowania danych wyjściowych .NET AspireRedis. Integracja Aspire.StackExchange.Redis.OutputCachingclient jest używana do rejestrowania dostawcy ASP.NET Core buforowania danych wyjściowych obsługiwanego przez Redisserver, wykorzystując obraz kontenera docker.io/library/redis.

Dowiedz się, jak używać integracji buforowania danych wyjściowych .NET AspireRedis. Integracja Aspire.StackExchange.Redis.OutputCachingclient służy do rejestrowania dostawcy buforowania danych wyjściowych ASP.NET Core wspieranego przez Garnetserver przy użyciu obrazu kontenera ghcr.io/microsoft/garnet.

Dowiedz się, jak używać integracji buforowania danych wyjściowych .NET AspireRedis. Integracja Aspire.StackExchange.Redis.OutputCachingclient jest używana do rejestrowania dostawcy buforowania danych wyjściowych ASP.NET Core wspieranego przez Valkeyserver z obrazem kontenera docker.io/valkey/valkey.

Integracja hostingu

Integracja hostingu Redis modeluje zasób Redis jako typ RedisResource. Aby uzyskać dostęp do tego typu i interfejsów API, które umożliwiają dodanie go do 📦Aspire.Hosting.Redis pakietu NuGet w projekcie hosta aplikacji .

.NET CLI
PackageReference

dotnet add package Aspire.Hosting.Redis

<PackageReference Include="Aspire.Hosting.Redis"
                  Version="*" />

Aby uzyskać więcej informacji, zobacz dotnet add package lub Zarządzanie zależnościami pakietów w aplikacjach .NET.

Dodawanie zasobu Redis

W projekcie hosta aplikacji wywołaj AddRedis na instancji builder, aby dodać zasób Redis.

var builder = DistributedApplication.CreateBuilder(args);

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

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Gdy .NET.NET Aspire dodaje obraz kontenera do hosta aplikacji, jak pokazano w poprzednim przykładzie z obrazem docker.io/Redis/Redis, tworzy nowe wystąpienie Redis na komputerze lokalnym. Odwołanie do zasobu Redis (zmiennej cache) jest dodawane do ExampleProject.

Metoda WithReference konfiguruje połączenie w ExampleProject o nazwie "cache". Aby uzyskać więcej informacji, zobacz Cykl życia zasobów kontenera.

Napiwek

Jeśli wolisz nawiązać połączenie z istniejącym wystąpieniem Redis, wywołaj AddConnectionString zamiast tego. Aby uzyskać więcej informacji, zobacz Referencje istniejących zasobów.

Dodawanie zasobu Redis za pomocą usługi Redis Insights

Aby dodać Insights do zasobu , wywołaj metodę :

var builder = DistributedApplication.CreateBuilder(args);

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

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Redis Insights to darmowy interfejs graficzny do analizowania danych Redis na wszystkich systemach operacyjnych i wdrożeniach Redis, wspierany przez naszego asystenta sztucznej inteligencji, Redis Copilot. .NET .NET Aspire dodaje kolejny obraz kontenera docker.io/redis/redisinsight do hosta aplikacji, który uruchamia aplikację dowódcy.

Notatka

Aby skonfigurować port hosta dla łańcucha RedisInsightResource, należy wywołać interfejs API WithHostPort i podać żądany numer portu.

Dodawanie zasobu Redis za pomocą dowódcy Redis

Aby dodać Redis Commander do zasobu Redis, wywołaj metodę WithRedisCommander:

var builder = DistributedApplication.CreateBuilder(args);

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

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Redis Commander to aplikacja internetowa Node.js używana do wyświetlania, edytowania i zarządzania bazą danych Redis. .NET .NET Aspire dodaje kolejny obraz kontenera docker.io/rediscommander/redis-commander do hosta aplikacji, który uruchamia aplikację dowódcy.

Napiwek

Aby skonfigurować port hosta dla łańcucha RedisCommanderResource, należy wykonać wywołanie interfejsu API WithHostPort i podać żądany numer portu.

Dodawanie zasobu Redis z woluminem danych

Aby dodać wolumin danych do zasobu Redis, wywołaj metodę WithDataVolume w zasobie Redis:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wolumen danych służy do utrwalania danych Redis poza cyklem życia kontenera. Wolumin danych jest instalowany w ścieżce /data w kontenerze Redis, a gdy nie podano parametru name, nazwa jest generowana losowo. Aby uzyskać więcej informacji na temat woluminów danych i szczegóły dotyczące tego, dlaczego są preferowane zamiast montowań wiązań , zobacz dokumentację Docker: Woluminy.

Dodaj zasób Redis z montowaniem wiążącym danych

Aby dodać powiązanie danych do zasobu Redis, wywołaj metodę WithDataBindMount.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataBindMount(
                       source: @"C:\Redis\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Ważny

Instalacje powiązane danych mają ograniczoną funkcjonalność w porównaniu z woluminami , co zapewnia lepszą wydajność, przenośność i bezpieczeństwo, co czyni je bardziej odpowiednimi dla środowisk produkcyjnych. Jednak punkty wiązania umożliwiają bezpośredni dostęp i modyfikację plików na systemie hosta, co jest idealne do programowania i testowania wymagających zmian w czasie rzeczywistym.

Instalacje powiązania danych polegają na systemie plików maszyny hosta w celu utrwalania Redis danych między ponownymi uruchomieniami kontenera. Powiązanie danych jest montowane w ścieżce C:\Redis\Data w systemie Windows (lub /Redis/Data w Unix) na maszynie hosta w kontenerze Redis. Aby uzyskać więcej informacji na temat instalacji powiązań danych, zobacz Docker docs: Bind mounts.

Dodawanie zasobu Redis z trwałością

Aby dodać trwałość do zasobu Redis, wywołaj metodę WithPersistence za pomocą wolumenu danych lub montowania powiązań danych.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddRedis("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Powyższy kod nadaje trwałość zasobowi Redis przez utworzenie migawek danych Redis w określonych interwałach czasowych i przy określonym progu. interval to czas między eksportami migawek, a keysChangedThreshold to liczba operacji zmiany klucza potrzebnych do wyzwolenia migawki. Aby uzyskać więcej informacji na temat trwałości, zobacz Redis docs: Trwałość.

Integracja hostingu Garnet modeluje zasób Garnet jako typ GarnetResource. Aby uzyskać dostęp do tego typu i interfejsów API, które umożliwiają dodanie go do pakietu NuGet 📦Aspire.Hosting.Garnet w projekcie hosta aplikacji .

.NET interfejsu wiersza polecenia
PackageReference

dotnet add package Aspire.Hosting.Garnet

<PackageReference Include="Aspire.Hosting.Garnet"
                  Version="*" />

Aby uzyskać więcej informacji, zobacz dotnet add package lub Zarządzaj zależnościami pakietów w aplikacjach .NET.

Dodawanie zasobu Garnet

W projekcie hostującym aplikację wywołaj AddGarnet na instancji builder, aby dodać zasób Garnet:

var builder = DistributedApplication.CreateBuilder(args);

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

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Gdy .NET.NET Aspire dodaje obraz kontenera do hosta aplikacji, jak pokazano w poprzednim przykładzie z obrazem ghcr.io/microsoft/garnet, tworzy nowe wystąpienie Garnet na twoim lokalnym komputerze. Odwołanie do zasobu Garnet (zmienna cache) jest dodawane do zmiennej ExampleProject.

Metoda WithReference konfiguruje połączenie w ExampleProject o nazwie "cache". Aby uzyskać więcej informacji, zobacz Cykl życia zasobów kontenera.

Wskazówka

Jeśli wolisz nawiązać połączenie z istniejącym wystąpieniem Garnet, zamiast tego wywołaj AddConnectionString. Aby uzyskać więcej informacji, zobacz Odniesienie do istniejących zasobów.

Dodawanie zasobu Garnet z woluminem danych

Aby dodać wolumin danych do zasobu Garnet, wywołaj metodę AddGarnet w zasobie Garnet:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wolumin danych jest wykorzystywany do przechowywania danych Garnet poza cyklem życia jego kontenera. Wolumin danych jest instalowany w ścieżce /data w kontenerze Garnet i gdy nie podano parametru name, nazwa jest generowana losowo. Aby dowiedzieć się więcej o wolumenach danych i dowiedzieć się, dlaczego są one preferowane zamiast montowań wiązań, zobacz dokumentację Docker: Wolumeny.

Dodaj zasób Garnet z powiązaniem danych poprzez mount

Aby dodać dowiązanie danych do zasobu Garnet, wywołaj metodę WithDataBindMount:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataBindMount(
                       source: @"C:\Garnet\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Ważny

Wiązania montowań danych mają ograniczoną funkcjonalność w porównaniu z woluminami , które oferują lepszą wydajność, przenośność i bezpieczeństwo, czyniąc je bardziej odpowiednimi do środowisk produkcyjnych. Jednak montowanie powiązań umożliwia bezpośredni dostęp i modyfikację plików w systemie hosta, co jest idealne do programowania i testowania, gdzie potrzebne są zmiany na bieżąco.

Montowanie danych przy użyciu powiązań opiera się na systemie plików komputera hosta dla utrwalenia danych Garnet między ponownymi uruchomieniami kontenera. Powiązanie danych jest montowane w ścieżce C:\Garnet\Data w systemie Windows (lub /Garnet/Data w Unix) na maszynie hosta w kontenerze Garnet. Aby uzyskać więcej informacji na temat instalacji powiązań danych, zobacz Docker docs: Bind mounts.

Dodaj zasób Garnet z zachowaniem trwałości

Aby dodać trwałość do zasobu Garnet, wywołaj metodę WithPersistence z użyciem woluminu danych lub montowania powiązań danych.

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddGarnet("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Powyższy kod zapewnia trwałość zasobu Redis, tworząc migawki danych Garnet w określonym interwale i progu. interval to czas między eksportami migawek, a keysChangedThreshold to liczba operacji zmiany klucza potrzebnych do wyzwolenia migawki. Aby uzyskać więcej informacji na temat trwałości, zobacz Redis docs: Trwałość.

Integracja hostingu Valkey modeluje zasób Valkey jako typ ValkeyResource. Aby uzyskać dostęp do tego typu oraz interfejsów API umożliwiających jego dodanie do pakietu NuGet 📦Aspire.Hosting.Valkey w projekcie hosta aplikacji .

.NET interfejsu wiersza poleceń
PackageReference

dotnet add package Aspire.Hosting.Valkey

<PackageReference Include="Aspire.Hosting.Valkey"
                  Version="*" />

Aby uzyskać więcej informacji, zapoznaj się z dotnet add package lub Zarządzanie zależnościami pakietów w aplikacjach .NET.

Dodawanie zasobu Valkey

W projekcie hosta aplikacji wywołaj AddValkey w wystąpieniu builder, aby dodać zasób Valkey:

var builder = DistributedApplication.CreateBuilder(args);

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

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Gdy .NET.NET Aspire dodaje obraz kontenera do hosta aplikacji, jak pokazano na wcześniejszym przykładzie z obrazem docker.io/valkey/valkey, tworzy nowe wystąpienie Valkey na komputerze lokalnym. Odwołanie do twojego zasobu Valkey (zmiennej cache) jest dodawane do ExampleProject.

Metoda WithReference konfiguruje połączenie w ExampleProject o nazwie "cache". Aby uzyskać więcej informacji, zobacz Cykl życia zasobów kontenera.

Napiwek

Jeśli wolisz nawiązać połączenie z istniejącym wystąpieniem Valkey, wywołaj zamiast tego AddConnectionString. Aby uzyskać więcej informacji, odnieś się do istniejących zasobów .

Dodawanie zasobu Valkey z woluminem danych

Aby dodać wolumin danych do zasobu Valkey, wywołaj metodę AddValkey w zasobie Valkey:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataVolume(isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Wolumin danych jest używany do utrwalania danych Valkey poza cyklem życia kontenera. Wolumin danych jest instalowany w ścieżce /data w kontenerze Valkey, a gdy nie podano parametru name, nazwa jest generowana losowo. Aby uzyskać więcej informacji na temat woluminów danych i szczegółów na temat tego, dlaczego są preferowane w przypadku instalacji wiązania, zobacz Docker dokumentacji: woluminy.

Dodaj zasób Valkey z montowaniem wiązania danych

Aby dodać montowanie powiązania danych do zasobu Valkey, wywołaj metodę WithDataBindMount:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataBindMount(
                       source: @"C:\Valkey\Data",
                       isReadOnly: false);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Ważny

Instalacje powiązane danych mają ograniczoną funkcjonalność w porównaniu z woluminami , co zapewnia lepszą wydajność, przenośność i bezpieczeństwo, co czyni je bardziej odpowiednimi dla środowisk produkcyjnych. Jednak montowania wiązań umożliwiają bezpośredni dostęp i modyfikację plików w systemie hosta, idealne do rozwoju oprogramowania i testowania, gdzie potrzebne są zmiany w czasie rzeczywistym.

Podłączenia danych polegają na systemie plików maszyny hosta do zachowania danych Valkey podczas restartów kontenera. Powiązanie danych jest zamontowane w ścieżce C:\Valkey\Data na systemie Windows (lub /Valkey/Data na Unix) na maszynie hosta w kontenerze Valkey. Aby uzyskać więcej informacji na temat montowania bind danych, zobacz dokumentację Docker: Bind mounts.

Dodaj zasób Valkey z trwałością zapisu

Aby dodać trwałość do zasobu Valkey, wywołaj metodę WithPersistence za pomocą woluminu danych lub instalacji powiązania danych:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddValkey("cache")
                   .WithDataVolume()
                   .WithPersistence(
                       interval: TimeSpan.FromMinutes(5),
                       keysChangedThreshold: 100);

builder.AddProject<Projects.ExampleProject>()
       .WithReference(cache);

// After adding all resources, run the app...

Powyższy kod dodaje trwałość zasobu Redis poprzez tworzenie migawek danych Valkey w określonym interwale i progu. interval to czas między eksportami migawek, a keysChangedThreshold oznacza liczbę operacji zmiany klucza wymaganych do wyzwolenia migawki. Aby uzyskać więcej informacji na temat trwałości, zobacz Redis docs: Trwałość.

Przeprowadzanie kontroli stanu integracji

Integracja hostingu Redis automatycznie dodaje monitorowanie stanu dla odpowiedniego typu zasobu. Sprawdzenie stanu weryfikuje, czy server jest uruchomiony i czy można nawiązać z nim połączenie.

Integracja hostingu opiera się na pakiecie NuGet AspNetCore.HealthChecks 📦Redis.

integracja Client

Aby rozpocząć pracę z .NET Aspire Stack Exchange Redis wyjściowe buforowanie client integracji, zainstaluj 📦Aspire. StackExchange.Redis. OutputCaching pakiet NuGet w projekcie korzystającym z client, czyli projektu dla aplikacji korzystającej z buforowania danych wyjściowych client.

.NET interfejs wiersza poleceń
PackageReference

dotnet add package Aspire.StackExchange.Redis.OutputCaching

<PackageReference Include="Aspire.StackExchange.Redis.OutputCache"
                  Version="*" />

Dodawanie buforowania danych wyjściowych

W pliku Program.cs projektu zużywającego clientwywołaj metodę rozszerzenia AddRedisOutputCache na dowolnym IHostApplicationBuilder, aby zarejestrować wymagane usługi na potrzeby buforowania danych wyjściowych.

builder.AddRedisOutputCache(connectionName: "cache");

Napiwek

Parametr connectionName musi być zgodny z nazwą używaną podczas dodawania zasobu Redis w projekcie hosta aplikacji. Aby uzyskać więcej informacji, zobacz Dodaj zasób Redis.

Napiwek

Parametr connectionName musi być zgodny z nazwą używaną podczas dodawania zasobu Garnet w projekcie hosta aplikacji. Aby uzyskać więcej informacji, zobacz Dodawanie zasobu Garnet.

Napiwek

Parametr connectionName musi być zgodny z nazwą używaną podczas dodawania zasobu Valkey w projekcie hosta aplikacji. Aby uzyskać więcej informacji, zobacz Dodawanie zasobu Valkey.

Dodaj międzyoprogramowanie do potoku przetwarzania żądań, wywołując UseOutputCache(IApplicationBuilder):

var app = builder.Build();

app.UseOutputCache();

W przypadku minimalnych aplikacji interfejsu APIskonfiguruj punkt końcowy do buforowania, wywołując CacheOutputlub stosując OutputCacheAttribute, jak pokazano w poniższych przykładach:

app.MapGet("/cached", () => "Hello world!")
   .CacheOutput();

app.MapGet(
    "/attribute",
    [OutputCache] () => "Hello world!");

W przypadku aplikacji z kontrolerami zastosuj atrybut [OutputCache] do metody akcji. W przypadku aplikacji Razor Pages zastosuj atrybut do klasy Razor page.

Konfiguracja

Integracja buforowania wyjściowego w .NET Aspire Stack Exchange Redis oferuje wiele opcji konfigurowania połączenia Redis w oparciu o wymagania i konwencje twojego projektu.

Używanie parametrów połączenia

W przypadku używania parametrów połączenia z sekcji konfiguracji ConnectionStrings można podać nazwę parametrów połączenia podczas wywoływania AddRedisOutputCache:

builder.AddRedisOutputCache(connectionName: "cache");

Następnie parametry połączenia zostaną pobrane z sekcji konfiguracji ConnectionStrings:

{
  "ConnectionStrings": {
    "cache": "localhost:6379"
  }
}

Aby uzyskać więcej informacji na temat formatowania tego łańcucha połączenia, zobacz dokumentację konfiguracjiStack Exchange .

Korzystanie z dostawców konfiguracji

Integracja .NET Aspire Stack Exchange Redis obsługuje Microsoft.Extensions.Configuration. Ładuje StackExchangeRedisSettings z konfiguracji przy użyciu klucza Aspire:StackExchange:Redis. Przykład appsettings.json, który konfiguruje niektóre opcje:

{
  "Aspire": {
    "StackExchange": {
      "Redis": {
        "ConnectionString": "localhost:6379",
        "DisableHealthChecks": true,
        "DisableTracing": false
      }
    }
  }
}

Aby uzyskać pełny schemat integracji RedisclientJSON, zobacz Aspire. StackExchange.Redis/ConfigurationSchema.json.

Używanie delegatów wbudowanych

Możesz również przekazać delegata Action<StackExchangeRedisSettings> configurationSettings, aby skonfigurować niektóre lub wszystkie opcje wbudowane, na przykład w celu wyłączenia kontroli kondycji z kodu:

builder.AddRedisOutputCache(
    "cache",
    static settings => settings.DisableHealthChecks  = true);

Można skonfigurować ConfigurationOptions również przy użyciu parametru delegata Action<ConfigurationOptions> configureOptions metody AddRedisOutputCache. Na przykład aby ustawić limit czasu połączenia:

builder.AddRedisOutputCache(
    "cache",
    static settings => settings.ConnectTimeout = 3_000);

Kontrole kondycji

Domyślnie .NET.NET Aspire integracje umożliwiają sprawdzanie kondycji dla wszystkich usług. Aby uzyskać więcej informacji, zobacz omówienie integracji .NET.NET Aspire.

Integracja buforowania wyjściowego .NET Aspire Stack Exchange Redis obsługuje następujące elementy:

Dodaje StackExchange.Redis sprawdzanie kondycji, próbuje otworzyć połączenie i zgłasza błąd w przypadku niepowodzenia.
Integruje się z /health punktem końcowym HTTP, który określa, że wszystkie zarejestrowane kontrole kondycji muszą zostać zaliczone, aby aplikacja została uznana za gotową do akceptowania ruchu.

Obserwowanie i telemetria

.NET .NET Aspire integracje automatycznie konfigurują rejestrowanie, śledzenie i metryki, które są czasami nazywane filarami obserwowalności. Aby uzyskać więcej informacji na temat możliwości obserwacji integracji i telemetrii, zobacz omówienie integracji .NET.NET Aspire. W zależności od usługi pomocniczej niektóre integracje mogą obsługiwać tylko niektóre z tych funkcji. Na przykład niektóre integracje obsługują rejestrowanie i śledzenie, ale nie metryki. Funkcje telemetrii można również wyłączyć przy użyciu technik przedstawionych w sekcji konfiguracji .

Rejestrowanie

Integracja buforowania danych wyjściowych .NET Aspire Stack Exchange Redis korzysta z następujących kategorii dzienników:

Aspire.StackExchange.Redis
Microsoft.AspNetCore.OutputCaching.StackExchangeRedis

Śledzenie

Integracja systemu buforowania wyjściowego .NET Aspire Stack Exchange z Redis będzie emitować następujące działania śledzenia za pomocą OpenTelemetry.

OpenTelemetry.Instrumentation.StackExchangeRedis

Metryki

Integracja buforowania danych wyjściowych .NET Aspire Stack Exchange Redis obecnie nie obsługuje metryk z powodu ograniczeń biblioteki StackExchange.Redis.

Azure Redis integracji hostingu

Aby wdrożyć zasoby Redis w usłudze Azure, zainstaluj 📦Aspire.Hosting.Azure.Redis pakiet NuGet:

.NET interfejs wiersza poleceń
PackageReference

dotnet add package Aspire.Hosting.Azure.Redis

<PackageReference Include="Aspire.Hosting.Azure.Redis"
                  Version="*" />

Dodawanie zasobu Azure Cache for Redisserver

Po zainstalowaniu pakietu .NET Aspire hostowania AzureRedis wywołaj metodę rozszerzenia AddAzureRedis w projekcie hosta aplikacji:

var builder = DistributedApplication.CreateBuilder(args);

var cache = builder.AddAzureRedis("azcache")

var exampleProject = builder.AddProject<Projects.ExampleProject>()
                            .WithReference(cache);

Poprzednie wywołanie AddAzureRedis konfiguruje zasób Redisserver w celu wdrożenia jako Azure Cache for Redis.

Ważny

Domyślnie AddAzureRedis konfiguruje uwierzytelnianie Microsoft Entra ID. Wymaga to zmian w aplikacjach, które muszą łączyć się z tymi zasobami, na przykład integracji client.

Dodaj Azure Cache for Redis dane wyjściowe client

Domyślnie podczas wywoływania AddAzureRedis w integracji Redis hostingu konfiguruje 📦 Microsoft.Azure. StackExchangeRedis pakiet NuGet w celu włączenia uwierzytelniania:

.NET interfejsu wiersza polecenia
PackageReference

dotnet add package Microsoft.Azure.StackExchangeRedis

<PackageReference Include="Microsoft.Azure.StackExchangeRedis"
                  Version="*" />

Połączenie Redis można używać za pomocą integracji client i Microsoft.Azure.StackExchangeRedis. Rozważmy następujący kod konfiguracji:

var azureOptionsProvider = new AzureOptionsProvider();

var configurationOptions = ConfigurationOptions.Parse(
    builder.Configuration.GetConnectionString("cache") ?? 
    throw new InvalidOperationException("Could not find a 'cache' connection string."));

if (configurationOptions.EndPoints.Any(azureOptionsProvider.IsMatch))
{
    await configurationOptions.ConfigureForAzureWithTokenCredentialAsync(
        new DefaultAzureCredential());
}

builder.AddRedisOutputCache("cache", configureOptions: options =>
{
    options.Defaults = configurationOptions.Defaults;
});

Aby uzyskać więcej informacji, zobacz repozytorium MicrosoftAzureStackExchangeRedis.

Zobacz też

*: Redis jest zastrzeżonym znakiem towarowym Redis Ltd. Wszelkie prawa, które istnieją, są zastrzeżone do Redis Ltd. Każde użycie przez firmę Microsoft jest przeznaczone tylko do celów referentalnych i nie wskazuje żadnych sponsorów, poparcia ani przynależności między Redis a firmą Microsoft. powrócić do góry?

Udostępnij za pośrednictwem

® integracja buforowania danych wyjściowych .NET AspireRedis^*

Integracja hostingu

Dodawanie zasobu Redis

Dodawanie zasobu Redis za pomocą usługi Redis Insights

Dodawanie zasobu Redis za pomocą dowódcy Redis

Dodawanie zasobu Redis z woluminem danych

Dodaj zasób Redis z montowaniem wiążącym danych

Dodawanie zasobu Redis z trwałością

Dodawanie zasobu Garnet

Dodawanie zasobu Garnet z woluminem danych

Dodaj zasób Garnet z powiązaniem danych poprzez mount

Dodaj zasób Garnet z zachowaniem trwałości

Dodawanie zasobu Valkey

Dodawanie zasobu Valkey z woluminem danych

Dodaj zasób Valkey z montowaniem wiązania danych

Dodaj zasób Valkey z trwałością zapisu

Przeprowadzanie kontroli stanu integracji

integracja Client

Dodawanie buforowania danych wyjściowych

Konfiguracja

Używanie parametrów połączenia

Korzystanie z dostawców konfiguracji

Używanie delegatów wbudowanych

Kontrole kondycji

Obserwowanie i telemetria

Rejestrowanie

Śledzenie

Metryki

Azure Redis integracji hostingu

Dodawanie zasobu Azure Cache for Redisserver

Dodaj Azure Cache for Redis dane wyjściowe client

Zobacz też

Dodatkowe zasoby

Udostępnij za pośrednictwem

® integracja buforowania danych wyjściowych .NET AspireRedis*

Integracja hostingu

Dodawanie zasobu Redis

Dodawanie zasobu Redis za pomocą usługi Redis Insights

Dodawanie zasobu Redis za pomocą dowódcy Redis

Dodawanie zasobu Redis z woluminem danych

Dodaj zasób Redis z montowaniem wiążącym danych

Dodawanie zasobu Redis z trwałością

Dodawanie zasobu Garnet

Dodawanie zasobu Garnet z woluminem danych

Dodaj zasób Garnet z powiązaniem danych poprzez mount

Dodaj zasób Garnet z zachowaniem trwałości

Dodawanie zasobu Valkey

Dodawanie zasobu Valkey z woluminem danych

Dodaj zasób Valkey z montowaniem wiązania danych

Dodaj zasób Valkey z trwałością zapisu

Przeprowadzanie kontroli stanu integracji

integracja Client

Dodawanie buforowania danych wyjściowych

Konfiguracja

Używanie parametrów połączenia

Korzystanie z dostawców konfiguracji

Używanie delegatów wbudowanych

Kontrole kondycji

Obserwowanie i telemetria

Rejestrowanie

Śledzenie

Metryki

Azure Redis integracji hostingu

Dodawanie zasobu Azure Cache for Redisserver

Dodaj Azure Cache for Redis dane wyjściowe client

Zobacz też

Dodatkowe zasoby

® integracja buforowania danych wyjściowych .NET AspireRedis^*