Verbinding maken Azure Cache voor Redis met uw toepassing in Azure Spring Apps

Notitie

De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container Apps voor meer informatie.

Dit artikel is van toepassing op: ✔️ Java ✔️ C#

Dit artikel is van toepassing op: ✔️ Basic/Standard ✔️ Enterprise

In plaats van uw Spring Boot-toepassingen handmatig te configureren, kunt u automatisch geselecteerde Azure-services verbinden met uw toepassingen met behulp van Azure Spring Apps. In dit artikel wordt beschreven hoe u uw toepassing verbindt met Azure Cache voor Redis.

Vereisten

• Een geïmplementeerd Azure Spring Apps-exemplaar
• Een exemplaar van de Azure Cache voor Redis-service
• De Azure Spring Apps-extensie voor de Azure CLI

Als u geen geïmplementeerd Azure Spring Apps-exemplaar hebt, volgt u de stappen in de quickstart: Uw eerste toepassing implementeren in Azure Spring Apps.

Uw project voorbereiden

Java

1. Voeg de volgende afhankelijkheid toe aan het pom.xml-bestand van uw project:

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

2. spring.redis.* Alle eigenschappen uit het bestand application.properties verwijderen

3. Werk de huidige implementatie bij met az spring app update of maak een nieuwe implementatie met az spring app deployment create.

Polyglot

Alle verbindingsreeks s en referenties worden geïnjecteerd als omgevingsvariabelen, waarnaar u kunt verwijzen in uw toepassingscode.

Zie Azure Cache voor Redis integreren met Service Connector voor de standaardomgevingsvariabelen.

Uw app verbinden met de Azure Cache voor Redis

Serviceconnector

Notitie

Standaard worden serviceconnectors gemaakt op toepassingsniveau. Als u de verbindingen wilt overschrijven, kunt u andere verbindingen opnieuw maken in de implementaties.

1. Gebruik de Azure CLI om uw Spring-app te configureren om verbinding te maken met een Redis-database met een toegangssleutel met behulp van de az spring connection create opdracht, zoals wordt weergegeven in het volgende voorbeeld.

   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
   

   Notitie

   Als u serviceconnector voor het eerst gebruikt, start u met de opdracht az provider register --namespace Microsoft.ServiceLinker om de serviceconnectorresourceprovider te registreren.

   Als u Redis Enterprise gebruikt, gebruikt u in plaats daarvan de az spring connection create redis-enterprise opdracht.

   Tip

   Voer de opdracht az spring connection list-support-types --output table uit om een lijst met ondersteunde doelservices en verificatiemethoden voor Azure Spring Apps op te halen. Als de az spring opdracht niet wordt herkend door het systeem, controleert u of u de vereiste extensie hebt geïnstalleerd door uit te voeren az extension add --name spring.

2. U kunt azure Portal ook gebruiken om deze verbinding te configureren door de volgende stappen uit te voeren. Azure Portal biedt dezelfde mogelijkheden als de Azure CLI en biedt een interactieve ervaring.

   1. Selecteer uw Azure Spring Apps-exemplaar in Azure Portal en selecteer vervolgens Apps in het navigatiemenu. Kies de app waarmee u verbinding wilt maken en selecteer vervolgens Serviceconnector in het navigatiemenu.

   2. Selecteer Maken.

   3. Selecteer Cache voor Redis op het tabblad Basisinformatie voor servicetype. Kies een abonnement en een Redis-cacheserver. Vul in dit voorbeeld de naam van de Redis-database in en selecteer Java onder clienttype. Selecteer Volgende: Verificatie.

   4. Kies op het tabblad Verificatie de verbindingsreeks. Service Connector haalt automatisch de toegangssleutel op uit uw Redis-databaseaccount. Selecteer Volgende: Netwerken.

   5. Selecteer op het tabblad Netwerken firewallregels configureren om toegang tot de doelservice in te schakelen en selecteer vervolgens Beoordelen en maken.

   6. Wacht op het tabblad Controleren en maken totdat de validatie is geslaagd en selecteer vervolgens Maken. Het maken kan enkele minuten duren.

   7. Zodra de verbinding tussen uw Spring-app uw Redis-database is gegenereerd, kunt u deze zien op de pagina Serviceconnector en de knop Uitvouwen selecteren om de geconfigureerde verbindingsvariabelen weer te geven.

Terraform

Het volgende Terraform-script laat zien hoe u een Azure Spring Apps-app instelt met Azure Cache voor 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
}

Volgende stappen

In dit artikel hebt u geleerd hoe u uw toepassing in Azure Spring Apps verbindt met Azure Cache voor Redis. Zie Verbinding maken met een Azure Database for MySQL-exemplaar voor meer informatie over het verbinden van services met uw toepassing.