Azure Spring Apps'te bir Azure Cosmos DB veritabanını uygulamanıza bağlama

Makale
11/20/2024

Not

Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.

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ı bir Azure Cosmos DB veritabanına nasıl bağlayacağınız gösterilmektedir.

Önkoşullar

Azure Spring Apps'e dağıtılan bir uygulama. Daha fazla bilgi için bkz . Hızlı Başlangıç: İlk uygulamanızı Azure Spring Apps'e dağıtma.
Azure Cosmos DB veritabanı örneği.
Azure CLI sürüm 2.45.0 veya üzeri.

Uygulamanızın pom.xml dosyasına aşağıdaki bağımlılıklardan birini ekleyin. API türünüz için uygun bağımlılığı seçin.

API türü: NoSQL

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId>
</dependency>

API türü: MongoDB

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

API türü: Cassandra

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

komutunu çalıştırarak geçerli uygulamayı güncelleştirin veya komutunu çalıştırarak az spring app deployaz spring app deployment createbu değişiklik için yeni bir dağıtım oluşturun.

Uygulamanızı Azure Cosmos DB'ye bağlama

Hizmet Bağlayıcısı
Terraform

Not

Varsayılan olarak, Hizmet Bağlayıcı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.

Azure CLI'yi kullanma

Aşağıdaki örnekte gösterildiği gibi Komutunu kullanarak az spring connection create Spring uygulamanızı Cosmos No SQL Veritabanı'ya bağlanacak şekilde yapılandırmak için Azure CLI'yi kullanın. Örnekteki değişkenleri gerçek değerlerle değiştirmeyi unutmayın.

Not

Azure Cosmos DB veritabanı ayarlarının güncelleştirilmesi birkaç dakika sürebilir.

Not

Cosmos Cassandra kullanıyorsanız yerine kullanın --key_space --database. Cosmos Tablosu kullanıyorsanız yerine kullanın --table --database. Daha fazla bilgi için bkz . Hızlı Başlangıç: Azure CLI ile Azure Spring Apps'te hizmet bağlantısı oluşturma.

az spring connection create cosmos-sql \
    --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
    --app $APP_NAME \
    --target-resource-group $COSMOSDB_RESOURCE_GROUP \
    --account $COSMOSDB_ACCOUNT_NAME \
    --database $DATABASE_NAME \
    --secret

Not

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

İ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.

Azure portal’ı kullanma

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.

Azure portalında Azure Spring Apps örneğinizi seçin ve gezinti menüsünden Uygulamalar'ı seçin. Bağlanmak istediğiniz uygulamayı seçin ve gezinti menüsünden Hizmet Bağlayıcısı'nı seçin.
Oluştur'u belirleyin.
Temel Bilgiler sekmesinde, hizmet türü için Cosmos DB'yi ve ardından bir abonelik seçin. API türü için Çekirdek (SQL) öğesini seçin, bir Cosmos DB hesabı ve bir veritabanı seçin. İstemci türü için Java'yı ve ardından İleri: Kimlik doğrulaması'yı seçin. Veritabanınızı henüz oluşturmadıysanız bkz . Hızlı Başlangıç: Azure portalından Azure Cosmos DB hesabı, veritabanı, kapsayıcı ve öğeler oluşturma.
Kimlik Doğrulaması sekmesinde Bağlantı dizesi'ni seçin. Hizmet Bağlayıcısı, Cosmos DB hesabınızdan erişim anahtarını otomatik olarak alır. İleri: Ağ'ı seçin.
Ağ sekmesinde Hedef hizmete erişimi etkinleştirmek için Güvenlik duvarı kurallarını yapılandır'ı ve ardından İleri: Gözden Geçir + Oluştur'u seçin.
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.
Spring uygulamalarınız ve Cosmos DB veritabanınız arasındaki bağlantı oluşturulduktan sonra, bunu Hizmet Bağlayıcısı sayfasında görebilir ve yapılandırılan bağlantı değişkenlerini görüntülemek için açılma düğmesini seçebilirsiniz.

Aşağıdaki Terraform betiğinde, Azure Cosmos DB hesabıyla Azure Spring Apps'e dağıtılan bir uygulamanın nasıl ayarlanacağı gösterilmektedir.

provider "azurerm" {
  features {}
}

variable "application_name" {
  type        = string
  description = "The name of your application"
  default     = "demo-cosmosdb"
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_cosmosdb_account" "cosmosdb" {
  name                = "cosmosacct-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  offer_type          = "Standard"
  kind                = "GlobalDocumentDB"

  consistency_policy {
    consistency_level = "Session"
  }

  geo_location {
    failover_priority = 0
    location          = azurerm_resource_group.example.location
  }
}

resource "azurerm_cosmosdb_sql_database" "cosmosdb" {
  name                = "cosmos-${var.application_name}-001"
  resource_group_name = azurerm_cosmosdb_account.cosmosdb.resource_group_name
  account_name        = azurerm_cosmosdb_account.cosmosdb.name
}

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      = 1
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.cloud.azure.cosmos.endpoint" : azurerm_cosmosdb_account.cosmosdb.endpoint
    "spring.cloud.azure.cosmos.key" : azurerm_cosmosdb_account.cosmosdb.primary_key
    "spring.cloud.azure.cosmos.database" : azurerm_cosmosdb_sql_database.cosmosdb.name
  }
}

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ı bir Azure Cosmos DB veritabanına bağlamayı öğrendiniz. Hizmetleri uygulamanıza bağlama hakkında daha fazla bilgi edinmek için bkz. Redis için Azure Cache önbelleğine bağlanma.

Aracılığıyla paylaş