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

Примечание.

Azure Spring Apps — это новое название службы Azure Spring Cloud. Старое название будет еще некоторое время встречаться в наших материалах, пока мы не обновим ресурсы, такие как снимки экрана, видео и схемы.

Эта статья применима к: ✔️ 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 со службой Подключение or".

Подключение приложения в Кэш 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
   

   Примечание.

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

   Если вы используете 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, а затем выберите "Приложения" в меню навигации. Выберите приложение, которое вы хотите подключить, и выберите службу Подключение or в меню навигации.

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

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

   4. На вкладке "Проверка подлинности" выберите строку Подключение ion. Служба Подключение or автоматически извлекает ключ доступа из учетной записи базы данных 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.