Menyambungkan Azure Cache for Redis ke aplikasi Anda di Azure Spring Apps

1. Tambahkan dependensi berikut ke file pom.xml proyek Anda:

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
   </dependency>
   

2. Menghapus properti apa pun spring.redis.* dari file application.properties

3. Perbarui penyebaran saat ini menggunakan az spring app update atau buat penyebaran baru menggunakan az spring app deployment create.

Semua string koneksi dan kredensial disuntikkan sebagai variabel lingkungan, yang dapat Anda referensikan dalam kode aplikasi Anda.

Untuk nama variabel lingkungan default, lihat Mengintegrasikan Azure Cache for Redis dengan Konektor Layanan.

1. Gunakan Azure CLI untuk mengonfigurasi aplikasi Spring Anda untuk menyambungkan ke database Redis dengan kunci akses menggunakan az spring connection create perintah , seperti yang ditunjukkan dalam contoh berikut.

   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
   

   Catatan

   Jika Anda menggunakan Konektor Layanan untuk pertama kalinya, mulailah dengan menjalankan perintah az provider register --namespace Microsoft.ServiceLinker untuk mendaftarkan penyedia sumber daya Konektor Layanan.

   Jika Anda menggunakan Redis Enterprise, gunakan perintah sebagai gantinya az spring connection create redis-enterprise .

   Tip

   Jalankan perintah az spring connection list-support-types --output table untuk mendapatkan daftar layanan target dan metode autentikasi yang didukung untuk Azure Spring Apps. az spring Jika perintah tidak dikenali oleh sistem, periksa apakah Anda telah menginstal ekstensi yang diperlukan dengan menjalankan az extension add --name spring.

2. Atau, Anda dapat menggunakan portal Azure untuk mengonfigurasi koneksi ini dengan menyelesaikan langkah-langkah berikut. portal Azure menyediakan kemampuan yang sama dengan Azure CLI dan memberikan pengalaman interaktif.

   1. Pilih instans Azure Spring Apps Anda di portal Azure lalu pilih Aplikasi dari menu navigasi. Pilih aplikasi yang ingin Anda sambungkan lalu pilih Konektor Layanan pada menu navigasi.

   2. Pilih Buat.

   3. Pada tab Dasar , untuk jenis layanan, pilih Cache for Redis. Pilih langganan dan server cache Redis. Isi nama database Redis ("0" dalam contoh ini) dan di bawah jenis klien, pilih Java. Pilih Berikutnya: Autentikasi.

   4. Pada tab Autentikasi , pilih String koneksi. Konektor Layanan secara otomatis mengambil kunci akses dari akun database Redis Anda. Pilih Next: Networking.

   5. Pada tab Jaringan , pilih Konfigurasikan aturan firewall untuk mengaktifkan akses ke layanan target, lalu pilih Tinjau + Buat.

   6. Pada tab Tinjau + Buat , tunggu hingga validasi lulus lalu pilih Buat. Pembuatan dapat memakan waktu beberapa menit untuk diselesaikan.

   7. Setelah koneksi antara aplikasi Spring Anda, database Redis Anda dibuat, Anda dapat melihatnya di halaman Konektor Layanan dan memilih tombol buka untuk melihat variabel koneksi yang dikonfigurasi.

Skrip Terraform berikut menunjukkan cara menyiapkan aplikasi Azure Spring Apps dengan Azure Cache for Redis.

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
}