Azure Spring Apps'te uygulamanıza Bağlan Redis için Azure Cache

Not

Azure Spring Apps, Azure Spring Cloud hizmetinin yeni adıdır. Hizmetin yeni bir adı olsa da, ekran görüntüleri, videolar ve diyagramlar gibi varlıkları güncelleştirmek için çalışırken bazı yerlerde eski adı bir süre görürsünüz.

Bu makale şunlar için geçerlidir: ✔️ Java ✔️ C#

Bu makale şunlar için geçerlidir: ✔️ Temel/Standart ✔️ Kurumsal

Spring Boot uygulamalarınızı el ile yapılandırmak yerine, Azure Spring Apps'i kullanarak seçili Azure hizmetlerini uygulamalarınıza otomatik olarak bağlayabilirsiniz. Bu makalede uygulamanızın Redis için Azure Cache nasıl bağlanacakları gösterilmektedir.

Önkoşullar

• Dağıtılan bir Azure Spring Apps örneği
• Redis için Azure Cache hizmet örneği
• Azure CLI için Azure Spring Apps uzantısı

Dağıtılan bir Azure Spring Apps örneğiniz yoksa Hızlı Başlangıç: İlk uygulamanızı Azure Spring Apps'e dağıtma bölümünde yer alan adımları izleyin.

Projenizi hazırlama

Java

1. Projenizin pom.xml dosyasına aşağıdaki bağımlılığı ekleyin:

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

2. Application.properties dosyasından tüm spring.redis.* özellikleri kaldırma

3. kullanarak az spring app update geçerli dağıtımı güncelleştirin veya kullanarak az spring app deployment createyeni bir dağıtım oluşturun.

Polyglot

Tüm bağlantı dizesi ve kimlik bilgileri, uygulama kodunuzda başvurabileceğiniz ortam değişkenleri olarak eklenir.

Varsayılan ortam değişkeni adları için bkz. Redis için Azure Cache Service Bağlan or ile tümleştirme.

Uygulamanızı Redis için Azure Cache Bağlan

Hizmet Bağlan veya

Not

Varsayılan olarak, Hizmet Bağlan or'ları uygulama düzeyinde oluşturulur. Bağlantıları geçersiz kılmak için dağıtımlarda yeniden başka bağlantılar oluşturabilirsiniz.

1. Aşağıdaki örnekte gösterildiği gibi, Spring uygulamanızı komutunu kullanarak az spring connection create bir Redis veritabanına erişim anahtarıyla bağlanacak şekilde yapılandırmak için Azure CLI'yi kullanın.

   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
   

   Not

   Service Bağlan or'ı ilk kez kullanıyorsanız, Service Bağlan veya kaynak sağlayıcısını kaydetmek için komutunu az provider register --namespace Microsoft.ServiceLinker çalıştırarak başlayın.

   Redis Enterprise kullanıyorsanız, bunun yerine komutunu kullanın az spring connection create redis-enterprise .

   İpucu

   Azure Spring Apps için desteklenen hedef hizmetlerin ve kimlik doğrulama yöntemlerinin listesini almak için komutunu az spring connection list-support-types --output table çalıştırın. az spring Komut sistem tarafından tanınmıyorsa komutunu çalıştırarak az extension add --name springgerekli uzantıyı yükleyip yüklemediğinize bakın.

2. Alternatif olarak, aşağıdaki adımları tamamlayarak bu bağlantıyı yapılandırmak için Azure portalını kullanabilirsiniz. Azure portalı, Azure CLI ile aynı özellikleri sağlar ve etkileşimli bir deneyim sunar.

   1. Azure portalında Azure Spring Apps örneğinizi ve ardından gezinti menüsünden Uygulamalar'ı seçin. Bağlanmak istediğiniz uygulamayı seçin ve ardından gezinti menüsünden Hizmet Bağlan veya'yı seçin.

   2. Oluştur'u belirleyin.

   3. Temel Bilgiler sekmesinde, hizmet türü için Redis için Önbellek'i seçin. Bir abonelik ve redis önbellek sunucusu seçin. Redis veritabanı adını ("bu örnekte 0" girin) ve istemci türü altında Java'yı seçin. İleri: Kimlik Doğrulaması'ı seçin.

   4. Kimlik Doğrulaması sekmesinde Bağlan ion dizesini seçin. Hizmet Bağlan veya erişim anahtarını Redis veritabanı hesabınızdan otomatik olarak alır. İleri: Ağ'ı seçin.

   5. Ağ sekmesinde Hedef hizmete erişimi etkinleştirmek için Güvenlik duvarı kurallarını yapılandır'ı ve ardından Gözden Geçir + Oluştur'u seçin.

   6. Gözden Geçir + Oluştur sekmesinde doğrulamanın geçmesini bekleyin ve Oluştur'u seçin. Oluşturma işleminin tamamlanması birkaç dakika sürebilir.

   7. Redis veritabanınızın Spring uygulaması arasındaki bağlantı oluşturulduktan sonra, bunu Hizmet Bağlan veya sayfasında görebilir ve yapılandırılan bağlantı değişkenlerini görüntülemek için açılır düğmeyi seçebilirsiniz.

Terraform

Aşağıdaki Terraform betiğinde Redis için Azure Cache ile bir Azure Spring Apps uygulamasının nasıl ayarlanacağı gösterilmektedir.

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
}

Sonraki adımlar

Bu makalede, Azure Spring Apps'teki uygulamanızı Redis için Azure Cache bağlamayı öğrendiniz. Hizmetleri uygulamanıza bağlama hakkında daha fazla bilgi edinmek için bkz. MySQL için Azure Veritabanı örneğine Bağlan.