你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 Azure Cache for Redis 连接到 Azure Spring Apps 中的应用程序

注意

基本、标准和企业计划将从 2025 年 3 月中旬开始弃用，停用期为 3 年。 建议转换到 Azure 容器应用。 有关详细信息，请参阅 Azure Spring Apps 停用公告。

标准消耗和专用计划将于 2024 年 9 月 30 日开始弃用，并在六个月后完全关闭。 建议转换到 Azure 容器应用。 有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于：✔️ Java ✔️ C#

本文适用于：✔️ 基本版/标准版 ✔️ 企业版

可以通过 Azure Spring Apps 将所选 Azure 服务自动连接到应用程序，而不必手动配置 Spring Boot 应用程序。 本文介绍如何将应用程序连接到 Azure Redis 缓存。

先决条件

• 部署的 Azure Spring Apps 实例
• Azure Redis 缓存服务实例
• 用于 Azure CLI 的 Azure Spring Apps 扩展

如果没有已部署的 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. 从 application.properties 文件中，删除所有 spring.redis.* 属性

3. 使用 az spring app update 更新当前部署，或者使用 az spring app deployment create 创建新的部署。

Polyglot

所有连接字符串和凭据都作为环境变量注入，可以在应用程序代码中引用这些环境变量。

有关默认环境变量名称，请参阅将 Azure Cache for Redis 与服务连接器集成。

将应用连接到 Azure Cache for Redis

服务连接器

注意

默认情况下，服务连接器在应用程序级别创建。 若要替代连接，可以在部署中再次创建其他连接。

1. 使用 Azure CLI，通过 az spring connection create 命令，将 Spring 应用配置为使用访问密钥连接到 Redis 数据库，如以下示例所示。

   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 门户中选择 Azure Spring Apps 实例，然后从导航菜单中选择“应用”。 选择要连接的应用，然后在导航菜单中选择“服务连接器”。

   2. 选择创建。

   3. 在“基本信息”选项卡上，对于“服务类型”，选择“Cache for Redis”。 选择订阅和 Redis 缓存服务器。 填写 Redis 数据库名称（在此示例中为“0”），然后在“客户端类型”下选择“Java”。 选择“下一步: 身份验证”。

   4. 在“身份验证”选项卡上，选择“连接字符串”。 服务连接器会自动从 Redis 数据库帐户检索访问密钥。 选择“下一页:网络”。

   5. 在“网络”选项卡上，选择“配置防火墙规则以启用对目标服务的访问权限”，然后选择“查看 + 创建”。

   6. 在“查看 + 创建”选项卡上，等待验证通过，然后选择“创建”。 完成创建可能需要几分钟时间。

   7. 生成 Spring 应用和 Redis 数据库之间的连接后，可以在服务连接器页中看到该连接，并且可通过选择展开按钮查看配置的连接变量。

Terraform

以下 Terraform 脚本演示如何使用 Azure Cache for Redis 设置 Azure Spring Apps 应用。

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 Cache for Redis。 若要详细了解如何将服务连接到应用程序，请参阅连接到 Azure Database for MySQL 实例。