Megosztás:

Spring Cloud Azure Redis-támogatás

  • Alkalmazandó: ✅ Version 4.20.0, ✅ Version 5.24.1, ✅ Version 6.1.0, ✅ Version 7.0.0

Ez a cikk azt ismerteti, hogyan használhatja együtt a Spring Cloud Azure-t és a Spring Data Redist, és hogyan adhat meg különböző típusú hitelesítő adatokat az Azure Cache for Redishez való hitelesítéshez.

Azure Cache for Redis a Redis szoftveren alapuló memóriabeli adattárat biztosít. A Redis javítja a háttéradattárakat nagymértékben használó alkalmazások teljesítményét és méretezhetőségét.

Támogatott Redis-verziók

A támogatott verziókról Aktuális verziókcímű témakörben olvashat.

Alapvető funkciók

Jelszó nélküli kapcsolat

A jelszó nélküli kapcsolat Microsoft Entra-hitelesítést használ az Azure-szolgáltatásokhoz való csatlakozáshoz anélkül, hogy hitelesítő adatokat tárolnál az alkalmazásban, annak konfigurációs fájljaiban vagy környezeti változókban. A Microsoft Entra-hitelesítés az Azure Cache for Redishez való csatlakozás mechanizmusa a Microsoft Entra ID-ban meghatározott identitások használatával. A Microsoft Entra-hitelesítéssel központi helyen kezelheti a gyorsítótár-identitásokat és más Microsoft-szolgáltatásokat, ami leegyszerűsíti az engedélykezelést.

Hogyan működik?

A Spring Cloud Azure az alkalmazáshitelesítés konfigurációjától függően először a következő típusú hitelesítő adatok egyikét hozza létre:

  • ClientSecretCredential
  • ClientCertificateCredential
  • UsernamePasswordCredential
  • ManagedIdentityCredential

Ha az ilyen típusú hitelesítő adatok egyike sem található, a hitelesítő adatok DefaultTokenCredential keresztüli lánca az alkalmazástulajdonságokból, környezeti változókból, felügyelt identitásokból vagy azonosítókból származó hitelesítő adatok lekérésére szolgál. További információ: Spring Cloud Azure-hitelesítési.

Konfiguráció

Konfigurálható tulajdonságok a Redis-támogatás használatakor:

Ingatlan Leírás Alapértelmezett érték Szükséges
spring.cloud.azure.redis.enabled Engedélyezve van-e az Azure Cache for Redis. igaz Nem
spring.cloud.azure.redis.name Az Azure Cache for Redis-példány neve. Igen
spring.cloud.azure.redis.resource.resource-group Az Azure Cache for Redis erőforráscsoportja. Igen
spring.cloud.azure.profile.subscription-id Az előfizetés azonosítója. Igen
spring.data.redis.azure.passwordless-enabled Az Azure Cache for Redis jelszó nélküli engedélyezése. téves Nem

Alapszintű használat

Az alábbi szakaszok a klasszikus Spring Boot-alkalmazáshasználati forgatókönyveket mutatják be.

Csatlakozás az Azure Cache for Redishez jelszó nélküli használatával

  1. Adja hozzá a következő függőséget a projekthez. Ez a konfiguráció automatikusan tartalmazza a spring-boot-starter projekt függőségét tranzitív módon.

    <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-data-redis-lettuce</artifactId>
</dependency>

    Jegyzet

    Ne felejtse el hozzáadni a spring-cloud-azure-dependencies BOM-t ezzel a függőséggel együtt. További információt a Spring Cloud Azure fejlesztői útmutatójánakElső lépések című szakaszában talál.

  2. Konfigurálja a következő tulajdonságokat a application.yml fájlban:

    spring:
  data:
    redis:
      host: ${AZURE_CACHE_REDIS_HOST}
      username: ${AZURE_CACHE_REDIS_USERNAME}
      port: 6380
      ssl:
        enabled: true
      azure:
        passwordless-enabled: true

    Fontos

    A jelszó nélküli kapcsolat Microsoft Entra-hitelesítést használ. A Microsoft Entra-hitelesítés használatához engedélyeznie kell a Microsoft Entra-hitelesítést, és user(managed identity/service principal) kell választania a Data Owner Access Policyhozzárendeléséhez.

    További információkért és a usernameértékének lekéréséhez tekintse meg a A Microsoft Entra-azonosító hitelesítésének engedélyezése a gyorsítótárA Microsoft Entra-azonosító használata gyorsítótár-hitelesítésicímű szakaszában.

Csatlakozás az Azure Cache for Redishez felügyelt identitással

  1. A felügyelt identitás használatához engedélyeznie kell a szolgáltatás felügyelt identitását, és engedélyeznie kell a Microsoft Entra-hitelesítést a gyorsítótár.

  2. Ezután adja hozzá a következő tulajdonságokat a application.yml fájlhoz:

    spring:
  cloud:
    azure:
      credential:
        managed-identity-enabled: true

    Fontos

    A redis.username a felügyelt identitásobjektum (egyszerű) azonosítóra kell váltania.

    Ha felhasználó által hozzárendelt felügyelt identitást használ, a spring.cloud.azure.credential.client-id tulajdonságot is hozzá kell adnia a felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítójához.

Csatlakozás az Azure Cache for Redishez az Azure Resource Manageren keresztül

Az Alábbi lépésekkel csatlakozhat az Azure Cache for Redishez:

  1. Adja hozzá a következő függőséget a projekthez. Ez a konfiguráció automatikusan tartalmazza a spring-boot-starter projekt függőségét tranzitív módon.

    <dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-data-redis-lettuce</artifactId>
</dependency>
<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-resourcemanager</artifactId>
</dependency>
<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

    Jegyzet

    Ne felejtse el hozzáadni a spring-cloud-azure-dependencies BOM-t ezzel a függőséggel együtt. További információt a Spring Cloud Azure fejlesztői útmutatójánakElső lépések című szakaszában talál.

  1. Konfigurálja a következő tulajdonságokat a application.yml fájlban:

    spring:
  cloud:
    azure:
      profile:
        subscription-id: ${AZURE_SUBSCRIPTION_ID}
      redis:
        name: ${AZURE_CACHE_REDIS_NAME}
        resource:
          resource-group: ${AZURE_RESOURCE_GROUP}

Minták

Tekintse meg az azure-spring-boot-samples GitHub-adattárat.

  • Last updated on