Připojení Azure Cache for Redis do vaší aplikace v Azure Spring Apps

Poznámka:

Azure Spring Apps je nový název služby Azure Spring Cloud. Přestože má služba nový název, na některých místech uvidíte starý název, protože pracujeme na aktualizaci prostředků, jako jsou snímky obrazovky, videa a diagramy.

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 služby Azure Cache for Redis se službou Připojení or.

Připojení aplikace do služby Azure Cache for Redis

Service Připojení or

Poznámka:

Ve výchozím nastavení se Připojení or služby 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 používáte service Připojení or poprvé, spusťte příkaz az provider register --namespace Microsoft.ServiceLinker pro registraci poskytovatele prostředků Připojení 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 Service Připojení or.

   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řipojení ion řetězec. Služba Připojení or 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 Service Připojení or 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.