Připojení Azure Cache for Redis k aplikaci v Azure Spring Apps

Poznámka:

Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.

Tento článek se vztahuje na:✅ Java ✅ C#

Tento článek se vztahuje na:✅ Basic/Standard ✅ Enterprise

Místo ruční konfigurace aplikací Spring Boot můžete k aplikacím automaticky připojit vybrané služby Azure pomocí Azure Spring Apps. Tento článek ukazuje, jak připojit aplikaci ke službě Azure Cache for Redis.

Požadavky

• Nasazená instance Azure Spring Apps
• Instance služby Azure Cache for Redis
• Rozšíření Azure Spring Apps pro Azure CLI

Pokud nemáte nasazenou instanci Azure Spring Apps, postupujte podle kroků v rychlém startu : Nasazení první aplikace do Azure Spring Apps.

Příprava projektu

Java

1. Do souboru pom.xml projektu přidejte následující závislost:

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

2. Odebrání všech spring.redis.* vlastností ze souboru application.properties

3. Aktualizujte aktuální nasazení pomocí az spring app update nebo vytvořte nové nasazení pomocí az spring app deployment create.

Polyglot

Všechny připojovací řetězec a přihlašovací údaje se vloží jako proměnné prostředí, na které můžete odkazovat v kódu aplikace.

Výchozí názvy proměnných prostředí najdete v tématu Integrace azure Cache for Redis s konektorem služby.

Připojení aplikace ke službě Azure Cache for Redis

Service Connector

Poznámka:

Ve výchozím nastavení se konektory služeb vytvářejí na úrovni aplikace. Pokud chcete přepsat připojení, můžete v nasazeních znovu vytvořit další připojení.

1. Pomocí Azure CLI nakonfigurujte aplikaci Spring tak, aby se připojila k databázi Redis pomocí přístupového klíče pomocí az spring connection create příkazu, jak je znázorněno v následujícím příkladu.

   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
   

   Poznámka:

   Pokud konektor Service Connector používáte poprvé, spusťte příkaz az provider register --namespace Microsoft.ServiceLinker pro registraci poskytovatele prostředků konektoru služby.

   Pokud používáte Redis Enterprise, použijte az spring connection create redis-enterprise místo toho příkaz.

   Tip

   Spuštěním příkazu az spring connection list-support-types --output table získejte seznam podporovaných cílových služeb a metod ověřování pro Azure Spring Apps. az spring Pokud systém příkaz nerozpozná, zkontrolujte, jestli jste nainstalovali požadované rozšíření spuštěním az extension add --name springpříkazu .

2. Alternativně můžete toto připojení nakonfigurovat pomocí webu Azure Portal provedením následujících kroků. Azure Portal poskytuje stejné funkce jako Azure CLI a poskytuje interaktivní prostředí.

   1. Na webu Azure Portal vyberte instanci Azure Spring Apps a pak v navigační nabídce vyberte Aplikace . Zvolte aplikaci, kterou chcete připojit, a pak v navigační nabídce vyberte Konektor služby.

   2. Vyberte Vytvořit.

   3. Na kartě Základy jako typ služby vyberte Mezipaměť for Redis. Zvolte předplatné a server mezipaměti Redis. Vyplňte název databáze Redis (v tomto příkladu 0) a v části typ klienta vyberte Javu. Vyberte Další: Ověřování.

   4. Na kartě Ověřování zvolte Připojovací řetězec. Service Connector automaticky načte přístupový klíč z účtu databáze Redis. Vyberte Další: Sítě.

   5. Na kartě Sítě vyberte Konfigurovat pravidla brány firewall pro povolení přístupu k cílové službě a pak vyberte Zkontrolovat a vytvořit.

   6. Na kartě Zkontrolovat a vytvořit počkejte, až ověření projde, a pak vyberte Vytvořit. Vytvoření může trvat několik minut.

   7. Po vygenerování připojení mezi vaší aplikací Spring se databáze Redis zobrazí na stránce Konektor služby a výběrem tlačítka rozbalení zobrazíte nakonfigurované proměnné připojení.

Terraform

Následující skript Terraformu ukazuje, jak nastavit aplikaci Azure Spring Apps se službou Azure Cache for Redis.

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
}

Další kroky

V tomto článku jste zjistili, jak připojit aplikaci v Azure Spring Apps ke službě Azure Cache for Redis. Další informace o připojování služeb k aplikaci najdete v tématu Připojení k instanci Azure Database for MySQL.