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

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.

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.

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.

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
}