integracja .NET AspireRedis®^*

obejmuje:integrację hostingu oraz Client integrację

Redis to najszybsza na świecie platforma danych do buforowania, wyszukiwania wektorów i baz danych NoSQL. Integracja .NET AspireRedis umożliwia łączenie się z istniejącymi wystąpieniami Redis lub tworzenie nowych wystąpień z .NET za pomocą obrazu kontenera docker.io/library/redis.

Garnet jest magazynem pamięci podręcznej o wysokiej wydajności firmy Microsoft Research i jest zgodny z protokołem serializacji Redis (RESP). Integracja .NET AspireRedis umożliwia łączenie się z istniejącymi wystąpieniami Garnet lub tworzenie nowych wystąpień z .NET, korzystając z obrazu kontenera ghcr.io/microsoft/garnet.

valkey jest rozwidleniem i jest zgodny z (RESP) protokołu serializacji. Jest to wysokowydajny magazyn danych klucz/wartość, który obsługuje różnorodne zadania obliczeniowe, takie jak buforowanie, kolejki wiadomości i może pełnić rolę głównej bazy danych. Integracja .NET AspireRedis umożliwia łączenie się z istniejącymi wystąpieniami Valkey lub tworzenie nowych wystąpień z .NET przy użyciu obrazu 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 pakietu NuGet 📦Aspire.HostingRedis w projekcie hosta aplikacji .

.NET CLI

dotnet add package Aspire.Hosting.Redis

PackageReference

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

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

Dodawanie zasobu Redis

W projekcie hosta aplikacji użyj 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 Odniesienie się do istniejących zasobów.

Dodawanie zasobu Redis za pomocą usługi Redis Insights

Aby dodać informacje Redis do zasobu Redis, wywołaj metodę WithRedisInsight:

var builder = DistributedApplication.CreateBuilder(args);

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

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

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

Insights Redis to darmowy graficzny interfejs pozwalający na analizę danych Redis na wszystkich systemach operacyjnych oraz w środowiskach wdrożeniowych Redis przy wsparciu naszego asystenta AI, 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, wykonaj wywołanie do interfejsu API WithHostPort i podaj żą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, wywołaj interfejs API WithHostPort i podaj żą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 przechowywania danych Redis poza cyklem życia jego kontenera. Wolumin danych jest instalowany w ścieżce /data w kontenerze Redis, a gdy nie podano parametru name, nazwa jest generowana losowo. Aby dowiedzieć się więcej na temat woluminów danych i szczegółów, dlaczego są preferowane nad montowanie zewnętrzne , zobacz Docker docs: Volumes.

Dodawanie zasobu Redis z instalacją powiązania danych

Aby dodać punkt montowania 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

Montaże powiązane danych mają ograniczoną funkcjonalność w porównaniu z woluminami , które oferują lepszą wydajność, przenośność i bezpieczeństwo, dzięki czemu są bardziej odpowiednie dla środowisk produkcyjnych. Jednak spięcia montażowe umożliwiają bezpośredni dostęp i modyfikację plików w systemie hosta, co jest idealne do rozwoju i testowania, gdzie potrzebne są zmiany w czasie rzeczywistym.

Powiązania danych bazują na systemie plików maszyny hosta, aby utrwalać dane Redis podczas restartów kontenera. Powiązanie danych jest zamontowane w C:\Redis\Data na Windows (lub /Redis/Data na Unix) na ścieżce maszyny hosta w ramach kontenera Redis. Aby uzyskać więcej informacji na temat montowania powiązań danych, zobacz dokumentację Docker: Montowanie powiązań.

Dodawanie zasobu Redis z trwałością

Aby dodać trwałość do zasobu Redis, wywołaj metodę WithPersistence za pomocą woluminu danych lub instalacji powiązania 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 dodaje trwałość do zasobu Redis przez utworzenie migawek danych Redis w określonym interwale i progu. interval to czas między eksportami migawek a keysChangedThreshold jest liczbą operacji zmiany klucza wymaganych 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 📦Aspire.Hosting.Garnet pakietu NuGet w projekcie hosta aplikacji .

.NET CLI

dotnet add package Aspire.Hosting.Garnet

PackageReference

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

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

Dodawanie zasobu Garnet

W projekcie hosta aplikacji, użyj 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 nową instancję Garnet na komputerze lokalnym. Odwołanie do zasobu Garnet (zmienna cache) zostaje dodane 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 Garnet, zadzwoń pod AddConnectionString zamiast tego. Aby uzyskać więcej informacji, odwołaj się do Istniejące zasoby.

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...

Wolumen danych służy do przechowywania danych Garnet poza cyklem życia kontenera. Wolumin danych jest instalowany w ścieżce /data w kontenerze Garnet i 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 Garnet z mocowaniem danych typu bind

Aby dodać punkt montowania 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

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 montowanie wiążące umożliwia bezpośredni dostęp i modyfikację plików w systemie gospodarza, co jest idealne do rozwoju i testowania, gdzie potrzebne są zmiany w czasie rzeczywistym.

Montowanie z powiązaniem danych polega na systemie plików komputera hosta, aby zapewnić trwałość danych Garnet podczas ponownych uruchomień kontenera. Powiązanie danych jest montowane na C:\Garnet\Data w systemie Windows (lub /Garnet/Data w Unix) w ścieżce na maszynie hosta w kontenerze Garnet. Aby uzyskać więcej informacji na temat instalacji powiązań danych, zobacz Docker docs: Bind mounts.

Dodawanie zasobu Garnet z zachowaniem trwałości

Aby dodać trwałość do zasobu Garnet, wywołaj metodę WithPersistence za pomocą woluminu danych lub instalacji powiązania 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...

Kod powyżej dodaje persystencję do zasobu Redis poprzez wykonywanie migawek danych Garnet w określonym przedziale czasowym i progu. interval to czas pomię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 i interfejsów API, które umożliwiają dodanie go do pakietu NuGet 📦Aspire.Hosting.Valkey w projekcie hosta aplikacji .

.NET CLI

dotnet add package Aspire.Hosting.Valkey

PackageReference

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

Aby uzyskać więcej informacji, zobacz dotnet add package or Manage package dependencies in .NET applications.

Dodawanie zasobu Valkey

W projekcie hosta aplikacji wywołaj AddValkey na instancji 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 w poprzednim przykładzie z obrazem docker.io/valkey/valkey, tworzy nowe wystąpienie Valkey na lokalnym komputerze. Odwołanie do zasobu Valkey (zmiennej cache) dodawane jest 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, zamiast tego wywołaj AddConnectionString. Aby uzyskać więcej informacji, zobacz Odwołaj 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 wolumenów danych i szczegółów na temat tego, dlaczego są one preferowane w instalacjach z użyciem montowań , zobacz dokumentację Docker: Wolumeny.

Dodawanie zasobu Valkey z instalacją powiązania danych

Aby dodać punkt montowania z powiązaniem 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 montowanie wiążące umożliwia bezpośredni dostęp i modyfikację plików w systemie hosta, idealne w sytuacjach rozwoju i testowania, gdzie potrzebne są zmiany w czasie rzeczywistym.

Instalacje powiązania danych polegają na systemie plików maszyny hosta, aby utrwalić dane Valkey między ponownymi uruchomieniami kontenera. Punkt montowania powiązania danych jest zamontowany w C:\Valkey\Data w systemie Windows (lub /Valkey/Data na ścieżce Unix) na maszynie hosta w kontenerze Valkey. Aby uzyskać więcej informacji na temat powiązań montowania danych, zobacz dokumentację Docker: Bind mounts.

Dodawanie zasobu Valkey z trwałością

Aby przypisać trwałość zasobowi Valkey, wywołaj metodę WithPersistence przy użyciu woluminu danych lub powiązania wolumenu 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 persistentność do zasobu Redis poprzez migawkowanie danych Valkey w określonym interwale i progu. interval to czas między eksportami migawek a keysChangedThreshold jest liczbą operacji zmiany klucza wymaganych do wyzwolenia migawki. Aby uzyskać więcej informacji na temat trwałości, zobacz Redis docs: Trwałość.

Hostowanie kontroli kondycji integracji

Integracja hostingu Redis automatycznie dodaje sprawdzenie kondycji dla odpowiedniego typu zasobu. Kontrola kondycji sprawdza, czy server działa i czy można nawiązać z nim połączenie.

Integracja hostingu polega na wykorzystaniu pakietu NuGet 📦 AspNetCore.HealthChecks.Redis.

integracja Client

Aby rozpocząć pracę z integracją Redisclient.NET Aspire Stack Exchange, zainstaluj 📦Aspire.StackExchange.Redis pakiet NuGet w projekcie wykorzystującym client, czyli projekcie aplikacji korzystającego z Redisclient. Integracja Redisclient rejestruje wystąpienie IConnectionMultiplexer, które można użyć do interakcji z Redis.

.NET CLI

dotnet add package Aspire.StackExchange.Redis

PackageReference

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

Dodaj Redisclient

W pliku Program.cs projektu używającym client, wywołaj metodę rozszerzenia AddRedisClient na dowolnym IHostApplicationBuilder, aby zarejestrować IConnectionMultiplexer do użycia za pośrednictwem kontenera do wstrzykiwania zależności. Metoda przyjmuje parametr nazwy połączenia.

builder.AddRedisClient(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 Dodaj zasób 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.

Następnie można pobrać wystąpienie IConnection przy użyciu wstrzykiwania zależności. Aby na przykład pobrać połączenie z przykładowej usługi:

public class ExampleService(IConnectionMultiplexer connectionMux)
{
    // Use connection multiplexer...
}

Aby uzyskać więcej informacji na temat wstrzykiwania zależności, zobacz .NET wstrzykiwanie zależności.

Dodaj klucz Redisclient

Mogą wystąpić sytuacje, w których chcesz zarejestrować wiele wystąpień IConnectionMultiplexer z różnymi nazwami połączeń. Aby zarejestrować klientów kluczowych Redis, wywołaj metodę AddKeyedRedisClient.

builder.AddKeyedRedisClient(name: "chat");
builder.AddKeyedRedisClient(name: "queue");

Następnie można pobrać instancje IConnectionMultiplexer za pomocą wstrzykiwania zależności. Aby na przykład pobrać połączenie z przykładowej usługi:

public class ExampleService(
    [FromKeyedServices("chat")] IConnectionMultiplexer chatConnectionMux,
    [FromKeyedServices("queue")] IConnectionMultiplexer queueConnectionMux)
{
    // Use connections...
}

Aby uzyskać więcej informacji na temat usług kluczy, zobacz .NET wstrzykiwanie zależności: usługi kluczy.

Konfiguracja

Integracja .NET Aspire Stack Exchange Redisclient udostępnia wiele opcji konfigurowania połączenia Redis na podstawie wymagań i konwencji 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 AddRedis:

builder.AddRedis("cache");

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

builder.AddGarnet("cache");

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

builder.AddValkey("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 ciągu połączenia, zobacz dokumentację konfiguracji Stack Exchange Redis.

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żyj delegatów wewnętrznych

Możesz również przekazać delegata Action<StackExchangeRedisSettings>, aby skonfigurować niektóre lub wszystkie opcje bezpośrednio, na przykład w celu skonfigurowania DisableTracing.

builder.AddRedisClient(
    "cache",
    static settings => settings.DisableTracing = true);

Client kontrola zdrowia integracji

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 .NET Aspire Stack Exchange Redis obsługuje następujące elementy:

• Dodaje sprawdzenie kondycji, gdy StackExchangeRedisSettings.DisableHealthChecks jest false, próbujące nawiązać połączenie z instancją kontenera.
• Integruje się z punktem końcowym HTTP /health, który określa, że wszystkie zarejestrowane kontrole kondycji muszą przejść, aby aplikacja została uznana za gotową do akceptowania ruchu.

Obserwowanie i telemetria

.NET .NET Aspire integracje automatycznie konfigurują ustawienia rejestrowania, śledzenia i metryk, 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 .

Rejestracja

Integracja .NET Aspire Stack Exchange Redis używa następujących kategorii dzienników:

• Aspire.StackExchange.Redis

Śledzenie

Integracja .NET Aspire Stack Exchange Redis spowoduje emitowanie następujących działań śledzenia przy użyciu OpenTelemetry:

• OpenTelemetry.Instrumentation.StackExchangeRedis

Metryki

Integracja z .NET Aspire Stack Exchange Redis obecnie nie obsługuje domyślnie metryk z powodu ograniczeń biblioteki StackExchange.Redis.

Azure Redis integracja hostingu

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

.NET CLI

dotnet add package Aspire.Hosting.Azure.Redis

PackageReference

<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 w integracjach client.

Dodaj Azure Cache for Redisclient

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

.NET CLI

dotnet add package Microsoft.Azure.StackExchangeRedis

PackageReference

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

Połączenie Redis można wykorzystać przy użyciu 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.AddRedisClient("cache", configureOptions: options =>
{
    options.Defaults = configurationOptions.Defaults;
});

Aby uzyskać więcej informacji, zobacz repozytorium Microsoft.Azure.StackExchangeRedis.

Zobacz też

• Stack Exchange Redis docs
• .NET .NET Aspire integracje
• .NET Aspire GitHub repozytorium

*: 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?