Подключение Кэш Azure для Redis к приложению в Azure Spring Apps

Примечание.

Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.

Эта статья относится к:✅ Java ✅ C#

Эта статья относится к:✅ Basic/Standard ✅ Enterprise

Вместо ручной настройки приложений Spring Boot вы можете автоматически подключать выбранные службы Azure к приложениям с помощью Azure Spring Apps. В этой статье показано, как подключить приложение к Кэш Azure для Redis.

Необходимые компоненты

• Развернутый экземпляр Azure Spring Apps.
• Экземпляр службы кэша Azure для Redis
• Расширение Azure Spring Apps для Azure CLI.

Если у вас нет развернутого экземпляра Azure Spring Apps, выполните действия, описанные в кратком руководстве. Развертывание первого приложения в Azure Spring Apps.

Подготовка проекта

Java

1. Добавьте следующую зависимость в файл pom.xml проекта:

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

2. Удаление любых spring.redis.* свойств из файла application.properties

3. Обновите текущую развернутую службу с помощью az spring app update или создайте новое развертывание с помощью az spring app deployment create.

Многоязычный

Все строка подключения и учетные данные внедряются в виде переменных среды, на которые можно ссылаться в коде приложения.

Имена переменных среды по умолчанию см. в разделе "Интеграция Кэш Azure для Redis с соединителем службы".

Подключение приложения к Кэш Azure для Redis

Соединитель служб

Примечание.

По умолчанию соединители служб создаются на уровне приложения. Чтобы переопределить подключения, можно снова создать другие подключения в развертываниях.

1. Используйте Azure CLI для настройки приложения Spring для подключения к базе данных Redis с ключом доступа с помощью az spring connection create команды, как показано в следующем примере.

   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
   

   Примечание.

   Если вы впервые используете соединитель служб, начните с выполнения команды az provider register --namespace Microsoft.ServiceLinker , чтобы зарегистрировать поставщика ресурсов соединителя службы.

   Если вы используете Redis Enterprise, используйте az spring connection create redis-enterprise команду.

   Совет

   Выполните команду az spring connection list-support-types --output table , чтобы получить список поддерживаемых целевых служб и методов проверки подлинности для Azure Spring Apps. az spring Если команда не распознается системой, убедитесь, что вы установили необходимое расширение, выполнив командуaz extension add --name spring.

2. Кроме того, можно использовать портал Azure для настройки этого подключения, выполнив следующие действия. Портал Azure предоставляет те же возможности, что и Azure CLI, и предоставляет интерактивный интерфейс.

   1. Выберите экземпляр Azure Spring Apps в портал Azure, а затем выберите "Приложения" в меню навигации. Выберите приложение, которое требуется подключить, и выберите "Соединитель службы" в меню навигации.

   2. Нажмите кнопку создания.

   3. На вкладке "Основные сведения" для типа службы выберите "Кэш для Redis". Выберите подписку и сервер кэша Redis. Введите имя базы данных Redis ("0" в этом примере) и в разделе "Тип клиента" выберите Java. Выберите Далее: проверка подлинности.

   4. На вкладке "Проверка подлинности" выберите строку подключения. Соединитель служб автоматически получает ключ доступа из учетной записи базы данных Redis. Выберите Далее: сеть.

   5. На вкладке "Сеть" выберите "Настроить правила брандмауэра", чтобы включить доступ к целевой службе, а затем нажмите кнопку "Проверить и создать".

   6. На вкладке "Рецензирование и создание " дождитесь прохождения проверки и нажмите кнопку "Создать". Создание может занять несколько минут.

   7. После создания подключения между приложением Spring база данных Redis вы увидите его на странице соединителя службы и нажмите кнопку развертывания, чтобы просмотреть настроенные переменные подключения.

Terraform

В следующем сценарии Terraform показано, как настроить приложение Azure Spring Apps с Кэшем Azure для 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
}

Следующие шаги

Из этой статьи вы узнали, как подключить приложение в Azure Spring Apps к Кэш Azure для Redis. Дополнительные сведения о подключении служб к приложению см. в статье "Подключение к экземпляру База данных Azure для MySQL".