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

注意

Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。 雖然服務有新的名稱，但在我們努力更新資產，例如螢幕快照、影片和圖表時，您會在某些地方看到舊名稱一段時間。

本文適用於： ✔️ 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 與服務 連線 or。

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

服務 連線 or

注意

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

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 連線 or，請從執行 命令az provider register --namespace Microsoft.ServiceLinker來註冊 Service 連線 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 入口網站 中選取您的 Azure Spring Apps 實例，然後從導覽功能表中選取 [應用程式]。 選擇您要連線的應用程式，然後選取導覽功能表上的服務 連線 or。

   2. 選取 建立。

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

   4. 在 [驗證] 索引標籤上，選擇 [連線 ion 字串]。 服務 連線 or 會自動從您的 Redis 資料庫帳戶擷取存取金鑰。 選取 [下一步：網路]。

   5. 在 [網络] 索引標籤上，選取 [設定防火牆規則] 以啟用目標服務的存取權，然後選取 [檢閱 + 建立]。

   6. 在 [ 檢閱 + 建立] 索引標籤上，等候驗證通過，然後選取 [ 建立]。 建立可能需要幾分鐘的時間才能完成。

   7. 當您的 Spring 應用程式之間產生 Redis 資料庫之間的連線之後，您可以在 [服務 連線 or] 頁面中看到它，然後選取展開按鈕來檢視已設定的連接變數。

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 資料庫 實例。