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

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 與服務連接器。

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 腳本示範如何使用 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
}