將 Azure Cache for Redis 連線至 Azure Spring 應用程式中的應用程式

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。 建議您轉換至 Azure Container Apps。 如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。 建議您轉換至 Azure Container Apps。 如需詳細資訊，請參閱 將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container Apps。

本文適用於：✅ Java ✅ C#

本文適用於：✅ 基本/標準 ✅ 企業

您可以使用 Azure Spring Apps 自動將選取的 Azure 服務連線到您的應用程式，而不是手動設定 Spring Boot 應用程式。 本文說明如何將應用程式連線到 Azure Cache for Redis。

必要條件

• 已部署的 Azure Spring Apps 實例
• Azure Cache for 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。

通數國語文的人

所有 連接字串 和認證都會插入為環境變數，您可以在應用程式程式代碼中參考這些變數。

如需默認環境變數名稱，請參閱 整合 Azure Cache for Redis 與服務連接器。

將您的應用程式連線至 Azure Cache for Redis

服務連接器

注意

根據預設，服務連接器會在應用層級建立。 若要覆寫連線，您可以在部署中再次建立其他連線。

1. 使用 Azure CLI 來設定 Spring 應用程式，以使用 az spring connection create 命令來連線到具有存取密鑰的 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
   

   注意

   如果您是第一次使用 Service Connector，請從執行 命令az provider register --namespace Microsoft.ServiceLinker來註冊 Service Connector 資源提供者開始。

   如果您使用 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. 在 [ 基本] 索引 標籤上，針對服務類型，選取 [Redis 快取]。 選擇訂用帳戶和 Redis 快取伺服器。 在此範例中填入 Redis 資料庫名稱 （“0”），然後在用戶端類型下選取 [Java]。 選取 [下一步：驗證]。

   4. 在 [驗證] 索引標籤上，選擇 [連接字串]。 Service Connector 會自動從 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。 若要深入瞭解如何將服務連線到您的應用程式，請參閱連線到 適用於 MySQL 的 Azure 資料庫 實例。