Ansluta Azure Cache for Redis till ditt program i Azure Spring Apps

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här artikeln gäller för:✅ Java ✅ C#

Den här artikeln gäller för:✅ Basic/Standard ✅ Enterprise

I stället för att konfigurera Dina Spring Boot-program manuellt kan du automatiskt ansluta valda Azure-tjänster till dina program med hjälp av Azure Spring Apps. Den här artikeln visar hur du ansluter ditt program till Azure Cache for Redis.

Förutsättningar

• En distribuerad Azure Spring Apps-instans
• En Azure Cache for Redis-tjänstinstans
• Azure Spring Apps-tillägget för Azure CLI

Om du inte har någon distribuerad Azure Spring Apps-instans följer du stegen i snabbstarten : Distribuera ditt första program till Azure Spring Apps.

Förbereda projektet

Java

1. Lägg till följande beroende i projektets pom.xml-fil :

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

2. Ta bort alla spring.redis.* egenskaper från filen application.properties

3. Uppdatera den aktuella distributionen med eller az spring app update skapa en ny distribution med hjälp av az spring app deployment create.

Polyglott

Alla anslutningssträng och autentiseringsuppgifter matas in som miljövariabler, som du kan referera till i programkoden.

Standardnamn för miljövariabler finns i Integrera Azure Cache for Redis med Service Connector.

Ansluta din app till Azure Cache for Redis

Tjänstanslutning

Kommentar

Som standard skapas tjänstanslutningsprogram på programnivå. Om du vill åsidosätta anslutningarna kan du skapa andra anslutningar igen i distributionerna.

1. Använd Azure CLI för att konfigurera Spring-appen för att ansluta till en Redis-databas med en åtkomstnyckel med hjälp av az spring connection create kommandot, som du ser i följande exempel.

   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
   

   Kommentar

   Om du använder Service Connector för första gången börjar du med att köra kommandot az provider register --namespace Microsoft.ServiceLinker för att registrera resursprovidern för Service Connector.

   Om du använder Redis Enterprise använder du az spring connection create redis-enterprise kommandot i stället.

   Dricks

   Kör kommandot az spring connection list-support-types --output table för att hämta en lista över måltjänster och autentiseringsmetoder som stöds för Azure Spring Apps. az spring Om kommandot inte känns igen av systemet kontrollerar du att du har installerat det nödvändiga tillägget genom att köra az extension add --name spring.

2. Du kan också använda Azure Portal för att konfigurera den här anslutningen genom att utföra följande steg. Azure Portal har samma funktioner som Azure CLI och ger en interaktiv upplevelse.

   1. Välj din Azure Spring Apps-instans i Azure Portal och välj sedan Appar på navigeringsmenyn. Välj den app som du vill ansluta till och välj sedan Service Connector på navigeringsmenyn.

   2. Välj Skapa.

   3. På fliken Grundläggande väljer du Cache for Redis för tjänsttyp. Välj en prenumeration och en Redis-cacheserver. Fyll i Redis-databasnamnet ("0" i det här exemplet) och under klienttyp väljer du Java. Välj Nästa: Autentisering.

   4. På fliken Autentisering väljer du Anslutningssträng. Service Connector hämtar automatiskt åtkomstnyckeln från ditt Redis-databaskonto. Välj Nästa: Nätverk.

   5. På fliken Nätverk väljer du Konfigurera brandväggsregler för att aktivera åtkomst till måltjänsten och väljer sedan Granska + Skapa.

   6. På fliken Granska + skapa väntar du tills valideringen har godkänts och väljer sedan Skapa. Det kan ta några minuter att slutföra skapandet.

   7. När anslutningen mellan Spring-appen din Redis-databas har genererats kan du se den på sidan Service Connector och välja knappen för att visa de konfigurerade anslutningsvariablerna.

Terraform

Följande Terraform-skript visar hur du konfigurerar en Azure Spring Apps-app med 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
}

Nästa steg

I den här artikeln har du lärt dig hur du ansluter ditt program i Azure Spring Apps till Azure Cache for Redis. Mer information om hur du ansluter tjänster till ditt program finns i Ansluta till en Azure Database for MySQL-instans.