Połączenie usługi Azure Cache for Redis do aplikacji w usłudze Azure Spring Apps

Uwaga

Azure Spring Apps to nowa nazwa usługi Azure Spring Cloud. Mimo że usługa ma nową nazwę, stara nazwa będzie widoczna w niektórych miejscach przez pewien czas, ponieważ pracujemy nad aktualizowaniem zasobów, takich jak zrzuty ekranu, filmy wideo i diagramy.

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.

Polyglot

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 usługą Połączenie or.

Połączenie aplikacji do usługi Azure Cache for Redis

Połączenie or usługi

Uwaga

Domyślnie Połączenie 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 usługi Service Połączenie or po raz pierwszy, uruchom polecenie az provider register --namespace Microsoft.ServiceLinker , aby zarejestrować dostawcę zasobów service Połączenie or.

   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ę Usługa Połączenie or 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ę ciąg Połączenie ion. Usługa Połączenie or 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 Usługi Połączenie or i wybierz przycisk rozwinięcia, 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 Połączenie z wystąpieniem usługi Azure Database for MySQL.