Łą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ąd i tworzenie poczekaj, aż walidacja zostanie pomyślnie przeprowadzona, a następnie wybierz pozycję Utwórz. Tworzenie może potrwać kilka minut.

   7. Po wygenerowaniu połączenia między aplikacją Spring a bazą danych Redis, będzie ono widoczne na stronie z łącznikami usługi. Można wybrać 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
}