Az Azure Cache for Redis csatlakoztatása az alkalmazáshoz az Azure Spring Appsben

Feljegyzés

Az Alapszintű, a Standard és a Nagyvállalati csomag 2025. március közepétől megszűnik, 3 éves nyugdíjazási időszakkal. Javasoljuk, hogy váltson az Azure Container Appsre. További információkért lásd az Azure Spring Apps kivonási bejelentését.

A standard felhasználás és a dedikált csomag 2024. szeptember 30-tól megszűnik, hat hónap után pedig teljes leállítással. Javasoljuk, hogy váltson az Azure Container Appsre. További információ: Azure Spring Apps Standard-használat migrálása és dedikált csomag az Azure Container Appsbe.

Ez a cikk a következőre vonatkozik: ✔️ Java ✔️ C#

Ez a cikk a következőre vonatkozik: ✔️ Basic/Standard ✔️ Enterprise

A Spring Boot-alkalmazások manuális konfigurálása helyett automatikusan csatlakoztathatja a kiválasztott Azure-szolgáltatásokat az alkalmazásokhoz az Azure Spring Apps használatával. Ez a cikk bemutatja, hogyan csatlakoztathatja az alkalmazást az Azure Cache for Redishez.

Előfeltételek

• Üzembe helyezett Azure Spring Apps-példány
• Azure Cache for Redis szolgáltatáspéldány
• Az Azure Spring Apps-bővítmény az Azure CLI-hez

Ha nincs üzembe helyezett Azure Spring Apps-példánya, kövesse a rövid útmutató lépéseit: Az első alkalmazás üzembe helyezése az Azure Spring Appsben.

A projekt előkészítése

Java

1. Adja hozzá a következő függőséget a projekt pom.xml fájljához:

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
   </dependency>
   

2. Tulajdonságok spring.redis.* eltávolítása az application.properties fájlból

3. Frissítse az aktuális üzembe helyezést a használatával az spring app update , vagy hozzon létre egy új üzembe helyezést a következő használatával az spring app deployment create: .

Soknyelvű

A rendszer az összes kapcsolati sztring és hitelesítő adatot környezeti változóként injektálja, amelyre az alkalmazáskódban hivatkozhat.

Az alapértelmezett környezeti változóneveket az Azure Cache for Redis Service Connectornal való integrálása című témakörben talál.

Az alkalmazás csatlakoztatása az Azure Cache for Redishez

Szolgáltatás-összekötő

Feljegyzés

Alapértelmezés szerint a szolgáltatás-összekötők az alkalmazás szintjén jönnek létre. A kapcsolatok felülbírálásához újra létrehozhat más kapcsolatokat az üzemelő példányokban.

1. Az Azure CLI használatával úgy konfigurálhatja a Spring-alkalmazást, hogy a parancs használatával az spring connection create hozzáférési kulccsal csatlakozzon egy Redis-adatbázishoz, ahogyan az az alábbi példában látható.

   az spring connection create redis \
       --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
       --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
       --app $APP_NAME \
       --deployment $DEPLOYMENT_NAME \
       --target-resource-group $REDIS_RESOURCE_GROUP \
       --server $REDIS_SERVER_NAME\
       --database $REDIS_DATABASE_NAME \
       --secret
   

   Feljegyzés

   Ha először használja a Service Connectort , először futtassa a parancsot az provider register --namespace Microsoft.ServiceLinker a Service Connector-erőforrás-szolgáltató regisztrálásához.

   Ha Redis Enterprise-t használ, használja inkább a az spring connection create redis-enterprise parancsot.

   Tipp.

   Futtassa a parancsot az spring connection list-support-types --output table az Azure Spring Apps támogatott célszolgáltatásainak és hitelesítési módszereinek listájának lekéréséhez. Ha a az spring rendszer nem ismeri fel a parancsot, ellenőrizze, hogy telepítette-e a szükséges bővítményt a futtatással az extension add --name spring.

2. Másik lehetőségként az Azure Portallal konfigurálhatja ezt a kapcsolatot az alábbi lépések végrehajtásával. Az Azure Portal ugyanazokat a képességeket biztosítja, mint az Azure CLI, és interaktív élményt nyújt.

   1. Válassza ki az Azure Spring Apps-példányt az Azure Portalon, majd válassza az Alkalmazások lehetőséget a navigációs menüből. Válassza ki a csatlakoztatni kívánt alkalmazást, majd a navigációs menüBen válassza a Service Connector lehetőséget.

   2. Válassza a Létrehozás lehetőséget.

   3. Az Alapszintű beállítások lapon a szolgáltatástípushoz válassza a Cache for Redis lehetőséget. Válasszon egy előfizetést és egy Redis cache-kiszolgálót. Adja meg a Redis-adatbázis nevét ("0" ebben a példában), és az ügyféltípus alatt válassza a Java lehetőséget. Válassza a Következő: Hitelesítés lehetőséget.

   4. A Hitelesítés lapon válassza a Kapcsolati sztring lehetőséget. A Service Connector automatikusan lekéri a hozzáférési kulcsot a Redis-adatbázisfiókból. Válassza a Tovább: Hálózatkezelés lehetőséget.

   5. A Hálózatkezelés lapon válassza a Tűzfalszabályok konfigurálása a célszolgáltatáshoz való hozzáférés engedélyezéséhez, majd a Véleményezés + Létrehozás lehetőséget.

   6. A Véleményezés + Létrehozás lapon várja meg, amíg az ellenőrzés sikeres lesz, majd válassza a Létrehozás lehetőséget. A létrehozás eltarthat néhány percig.

   7. Miután létrejött a kapcsolat a Spring-alkalmazás és a Redis-adatbázis között, a Service Connector lapon láthatja, majd a kibontás gombra kattintva megtekintheti a konfigurált kapcsolatváltozókat.

Terraform

Az alábbi Terraform-szkript bemutatja, hogyan állíthat be Azure Spring Apps-alkalmazást az Azure Cache for Redis használatával.

provider "azurerm" {
  features {}
}

variable "application_name" {
  type        = string
  description = "The name of your application"
  default     = "demo-abc"
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_redis_cache" "redis" {
  name                = "redis-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  capacity            = 0
  family              = "C"
  sku_name            = "Standard"
  enable_non_ssl_port = false
  minimum_tls_version = "1.2"
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "${var.application_name}"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
}

resource "azurerm_spring_cloud_app" "example" {
  name                = "${var.application_name}-app"
  resource_group_name = azurerm_resource_group.example.name
  service_name        = azurerm_spring_cloud_service.example.name
  is_public           = true
  https_only          = true
}

resource "azurerm_spring_cloud_java_deployment" "example" {
  name                = "default"
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  quota {
    cpu    = "2"
    memory = "4Gi"
  }
  instance_count      = 2
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.redis.host"     = azurerm_redis_cache.redis.hostname
    "spring.redis.password" = azurerm_redis_cache.redis.primary_access_key
    "spring.redis.port"     = "6380"
    "spring.redis.ssl"      = "true"
  }
}

resource "azurerm_spring_cloud_active_deployment" "example" {
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  deployment_name     = azurerm_spring_cloud_java_deployment.example.name
}

Következő lépések

Ebből a cikkből megtudhatja, hogyan csatlakoztathatja az Azure Spring Appsben lévő alkalmazást az Azure Cache for Redishez. Ha többet szeretne tudni a szolgáltatások alkalmazáshoz való csatlakoztatásáról, olvassa el a Csatlakozás azure Database for MySQL-példányhoz című témakört.