Verbinden von Azure Cache for Redis mit Ihrer Anwendung in Azure Spring Apps

Hinweis

Die Pläne Basic, Standard und Enterprise gelten ab Mitte März 2025 als veraltet und werden über einen Zeitraum von 3 Jahren eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Der Standardverbrauchs- und dedizierte Plan wird ab dem 30. September 2024 als veraltet gekennzeichnet und nach sechs Monaten vollständig eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie unter Migrieren vom Standardverbrauchs- und dedizierten Plan von Azure Spring Apps zu Azure Container Apps.

Dieser Artikel gilt für: ✔️ Java ✔️ C#

Dieser Artikel gilt für: ✔️ Basic/Standard ✔️ Enterprise

Mit Azure Spring Apps können Sie ausgewählte Azure-Dienste automatisch mit Ihren Anwendungen verbinden, statt Ihre Spring Boot-Anwendungen manuell zu konfigurieren. In diesem Artikel wird gezeigt, wie Sie Ihre Anwendung mit Azure Cache for Redis verbinden.

Voraussetzungen

• Eine bereitgestellte Azure Spring Apps-Instanz
• Eine Azure Cache for Redis-Dienstinstanz
• Die Azure Spring Apps-Erweiterung für die Azure-Befehlszeilenschnittstelle

Wenn Sie nicht über eine bereitgestellte Azure Spring Apps-Instanz verfügen, folgen Sie den Schritten in diesem Schnellstart: Bereitstellen Ihrer ersten Anwendung auf Azure Spring Apps.

Vorbereiten Ihres Projekts

Java

1. Fügen Sie der Datei pom.xml Ihres Projekts die folgende Abhängigkeit hinzu:

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

2. Entfernen Sie in der Datei application.properties alle spring.redis.*-Eigenschaften.

3. Aktualisieren Sie die aktuelle Bereitstellung mit az spring app update, oder erstellen Sie eine neue Bereitstellung mithilfe von az spring app deployment create.

Polyglot

Alle Verbindungszeichenfolgen und Anmeldeinformationen werden als Umgebungsvariablen eingefügt, auf die Sie im Anwendungscode verweisen können.

Weitere Informationen zu Standardumgebungsvariablennamen finden Sie unter Integrieren von Azure Cache for Redis in Service Connector.

Verbinden Ihrer App mit Azure Cache for Redis

Dienstconnector

Hinweis

Standardmäßig werden Dienstconnectors auf Anwendungsebene erstellt. Um die Verbindungen außer Kraft zu setzen, können Sie in den Bereitstellungen wieder andere Verbindungen erstellen.

1. Konfigurieren Sie mit der Azure CLI Ihre Spring-App so, dass sie sich mit einer Redis-Datenbank mit einem Zugriffsschlüssel verbindet. Verwenden Sie dazu den Befehl az spring connection create, wie im folgenden Beispiel gezeigt.

   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
   

   Hinweis

   Wenn Sie den Dienstconnector zum ersten Mal verwenden, führen Sie zunächst den Befehl az provider register --namespace Microsoft.ServiceLinker aus, um den Ressourcenanbieter für den Dienstconnector zu registrieren.

   Wenn Sie Redis Enterprise nutzen, verwenden Sie stattdessen den Befehl az spring connection create redis-enterprise.

   Tipp

   Führen Sie den Befehl az spring connection list-support-types --output table aus, um eine Liste der für Azure Spring Apps unterstützten Zieldienste und Authentifizierungsmethoden abzurufen. Wenn der az spring Befehl vom System nicht erkannt wird, überprüfen Sie, ob Sie die erforderliche Erweiterung installiert haben, indem Sie ausführen az extension add --name spring.

2. Alternativ können Sie diese Verbindung auch im Azure-Portal konfigurieren, indem Sie die folgenden Schritte ausführen. Das Azure-Portal bietet die gleichen Funktionen wie die Azure CLI und dazu eine interaktive Oberfläche.

   1. Wählen Sie im Azure-Portal Ihre Azure Spring Apps-Instanz und dann im Navigationsmenü Apps aus. Wählen Sie die App aus, mit der Sie eine Verbindung herstellen möchten, und dann im Navigationsmenü Dienstconnector aus.

   2. Klicken Sie auf Erstellen.

   3. Wählen Sie auf der Registerkarte Grundlagen unter „Diensttyp“ die Option „Cache for Redis“ aus. Wählen Sie ein Abonnement und einen Redis Cache-Server aus. Geben Sie den Redis-Datenbanknamen (0 in diesem Beispiel) ein, und wählen Sie unter „Clienttyp“ die Option „Java“ aus. Wählen Sie Weiter: Authentifizierung aus.

   4. Wählen Sie auf der Registerkarte Authentifizierungdie Option Verbindungszeichenfolge aus. Der Dienstconnector ruft den Zugriffsschlüssel automatisch aus Ihrem Redis-Datenbankkonto ab. Klicken Sie auf Weiter: Netzwerk.

   5. Wählen Sie auf der Registerkarte Netzwerk die Option Firewallregeln konfigurieren, um den Zugriff auf den Zieldienst zu aktivieren und dann Überprüfen und erstellen aus.

   6. Warten Sie auf der Registerkarte Überprüfen und erstellen, bis die Überprüfung erfolgreich abgeschlossen wurde, und wählen Sie dann Erstellen aus. Die Erstellung kann einige Minuten dauern.

   7. Sobald die Verbindung zwischen Ihrer Spring-App und Redis-Datenbank hergestellt wurde, können Sie sie auf der Seite „Dienstconnector“ sehen und die Schaltfläche „Auffalten“ auswählen, um die konfigurierten Verbindungsvariablen anzuzeigen.

Terraform

Im folgenden Terraform-Skript sehen Sie, wie Sie eine Azure Spring Apps-App mithilfe von Azure Cache for Redis einrichten.

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
}

Nächste Schritte

In diesem Artikel haben Sie erfahren, wie Sie Ihre Anwendung in Azure Spring Apps mit Azure Cache for Redis verbinden. Weitere Informationen zum Verbinden von Diensten mit Ihrer Anwendung finden Sie unter Verbinden mit einer Azure Database for MySQL-Instanz.