Łączenie usługi Azure Cache for Redis z aplikacją w usłudze Azure Spring Apps

Uwaga

Plany Podstawowa, Standardowa i Enterprise zostaną wycofane od połowy marca 2025 r. z 3-letnim okresem emerytalnym. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Zużycie standardowe i dedykowany plan zostaną wycofane od 30 września 2024 r. z całkowitym zamknięciem po sześciu miesiącach. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu do usługi Azure Container Apps.

Ten artykuł dotyczy:✅ Java ✅ C#

Ten artykuł dotyczy:✅ Podstawowa/Standardowa ✅ Enterprise

Zamiast ręcznie konfigurować aplikacje Spring Boot, możesz automatycznie łączyć wybrane usługi platformy Azure z aplikacjami przy użyciu usługi Azure Spring Apps. W tym artykule pokazano, jak połączyć aplikację z usługą Azure Cache for Redis.

Wymagania wstępne

• Wdrożone wystąpienie usługi Azure Spring Apps
• Wystąpienie usługi Azure Cache for Redis
• Rozszerzenie Azure Spring Apps dla interfejsu wiersza polecenia platformy Azure

Jeśli nie masz wdrożonego wystąpienia usługi Azure Spring Apps, wykonaj kroki opisane w przewodniku Szybki start: wdrażanie pierwszej aplikacji w usłudze Azure Spring Apps.

Przygotowywanie projektu

Java

1. Dodaj następującą zależność do pliku pom.xml projektu:

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

2. Usuń wszystkie spring.redis.* właściwości z pliku application.properties

3. Zaktualizuj bieżące wdrożenie przy użyciu polecenia az spring app update lub utwórz nowe wdrożenie przy użyciu polecenia az spring app deployment create.

Poliglota

Wszystkie parametry połączenia i poświadczenia są wstrzykiwane jako zmienne środowiskowe, do których można się odwołać w kodzie aplikacji.

Aby uzyskać domyślne nazwy zmiennych środowiskowych, zobacz Integrowanie usługi Azure Cache for Redis z łącznikiem usługi Service Connector.

Łączenie aplikacji z usługą Azure Cache for Redis

Łącznik usługi

Uwaga

Domyślnie łączniki usługi są tworzone na poziomie aplikacji. Aby zastąpić połączenia, możesz ponownie utworzyć inne połączenia we wdrożeniach.

1. Użyj interfejsu wiersza polecenia platformy Azure, aby skonfigurować aplikację Spring w celu nawiązania połączenia z bazą danych Redis przy użyciu klucza dostępu przy użyciu az spring connection create polecenia , jak pokazano w poniższym przykładzie.

   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
   

   Uwaga

   Jeśli używasz łącznika usługi po raz pierwszy, uruchom polecenie az provider register --namespace Microsoft.ServiceLinker , aby zarejestrować dostawcę zasobów łącznika usług.

   Jeśli używasz usługi Redis Enterprise, zamiast tego użyj az spring connection create redis-enterprise polecenia .

   Napiwek

   Uruchom polecenie az spring connection list-support-types --output table , aby uzyskać listę obsługiwanych usług docelowych i metod uwierzytelniania dla usługi Azure Spring Apps. az spring Jeśli polecenie nie jest rozpoznawane przez system, sprawdź, czy zainstalowano wymagane rozszerzenie, uruchamiając polecenie az extension add --name spring.

2. Alternatywnie możesz użyć witryny Azure Portal do skonfigurowania tego połączenia, wykonując następujące kroki. Witryna Azure Portal udostępnia te same możliwości co interfejs wiersza polecenia platformy Azure i zapewnia interaktywne środowisko.

   1. Wybierz wystąpienie usługi Azure Spring Apps w witrynie Azure Portal, a następnie wybierz pozycję Aplikacje z menu nawigacji. Wybierz aplikację, którą chcesz połączyć, a następnie wybierz pozycję Łącznik usługi w menu nawigacji.

   2. Wybierz pozycję Utwórz.

   3. Na karcie Podstawowe w polu Typ usługi wybierz pozycję Pamięć podręczna dla usługi Redis. Wybierz subskrypcję i serwer pamięci podręcznej Redis. Wypełnij nazwę bazy danych Redis ("0" w tym przykładzie) i w obszarze Typ klienta wybierz pozycję Java. Wybierz pozycję Dalej: Uwierzytelnianie.

   4. Na karcie Uwierzytelnianie wybierz pozycję Parametry połączenia. Łącznik usługi automatycznie pobiera klucz dostępu z konta bazy danych Redis. Wybierz pozycję Dalej: Sieć.

   5. Na karcie Sieć wybierz pozycję Konfiguruj reguły zapory, aby włączyć dostęp do usługi docelowej, a następnie wybierz pozycję Przejrzyj i utwórz.

   6. Na karcie Przeglądanie + tworzenie poczekaj na przekazanie walidacji, a następnie wybierz pozycję Utwórz. Tworzenie może potrwać kilka minut.

   7. Po wygenerowaniu połączenia między aplikacją Spring baza danych Redis będzie widoczna na stronie Łącznik usługi i wybierz przycisk rozwijania, aby wyświetlić skonfigurowane zmienne połączenia.

Terraform

Poniższy skrypt narzędzia Terraform pokazuje, jak skonfigurować aplikację Usługi Azure Spring Apps za pomocą usługi 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
}

Następne kroki

W tym artykule przedstawiono sposób łączenia aplikacji w usłudze Azure Spring Apps z usługą Azure Cache for Redis. Aby dowiedzieć się więcej na temat łączenia usług z aplikacją, zobacz Nawiązywanie połączenia z wystąpieniem usługi Azure Database for MySQL.