Azure Cache for Redis を Azure Spring Apps のアプリケーションに接続する

Note

Basic、Standard、Enterprise プランは、2025 年 3 月中旬以降非推奨になり、廃止期間は 3 年間です。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の廃止のお知らせ」を参照してください。

Standard 従量課金と専用プランは、2024 年 9 月 30 日以降に非推奨になり、6 か月後に完全にシャットダウンされます。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の Standard 従量課金および専用プランを Azure Container Apps に移行する」を参照してください。

この記事の適用対象: ✔️ Java ✔️ C#

この記事の適用対象: ✔️ Basic または Standard ✔️ Enterprise

Spring Boot アプリケーションを手動で構成するのではなく、選択した Azure サービスを、Azure Spring Apps を使用してアプリケーションに自動的に接続することができます。 この記事では、アプリケーションを 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 を使用して新しいデプロイを作成します。

Polyglot

すべての接続文字列と資格情報は環境変数として挿入され、アプリケーション コードで参照できます。

既定の環境変数の名前については、「サービス コネクタを使用して Azure Cache for Redis を統合する」を参照してください。

アプリを Azure Cache for Redis に接続する

Service Connector

Note

既定では、サービス コネクタはアプリケーション レベルで作成されます。 接続をオーバーライドするには、デプロイで他の接続をもう一度作成します。

1. 次の例に示すように、Azure CLI で az spring connection create コマンドを使用して、アクセス キーを使って Redis データベースに接続するように Spring アプリを構成します。

   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
   

   Note

   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 portal で次の手順を完了することもできます。 Azure portal は、Azure CLI と同じ機能を備えており、対話型エクスペリエンスを提供します。

   1. Azure portal で Azure Spring Apps インスタンスを選択し、ナビゲーション メニューから [アプリ] を選択します。 接続するアプリを選択し、ナビゲーション メニューで [Service Connector] を選択します。

   2. ［作成］ を選択します

   3. [基本] タブの [サービスの種類] で、[Cache for Redis] を選択します。 サブスクリプションと Redis Cache サーバーを選択します。 Redis データベース名 (この例では "0") を入力し、[クライアントの種類] で [Java] を選択します。 [次へ: 認証] を選択します。

   4. [認証] タブで、[接続文字列] を選択します。 サービス コネクタは、Redis データベース アカウントからアクセス キーを自動的に取得します。 [次へ: ネットワーク] を選択します。

   5. [ネットワーク] タブで、[Configure firewall rules to enable access to target service] (ターゲット サービスへのアクセスを有効にするようにファイアウォール規則を構成する) を選択し、次に [確認と作成] を選択します。

   6. [確認と作成] タブで、検証が成功するまで待ってから、 [作成]を選択します。 作成が完了するまでに数分かかることがあります。

   7. Spring アプリと Redis データベース間の接続が生成されると、[Service Connector] ページにそれが表示されます。展開ボタンを選択すると、構成された接続変数を確認できます。

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 インスタンスへの接続に関するページを参照してください。