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

Not

Temel, Standardve Enterprise planları 17 Mart 2025'te kullanımdan kaldırma dönemine girdi. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

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.

Projenizi hazırlama

Java

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

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

Çokdilli

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 aşağıdaki makalelere bakın:

• Tablo için Azure Cosmos DB
• NoSQL için Azure Cosmos DB
• MongoDB için Azure Cosmos DB
• Gremlin için Azure Cosmos DB
• Cassandra için Azure Cosmos DB

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

Hizmet Bağlayıcısı

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, --key_space yerine --database kullanın. Cosmos Tablosu kullanıyorsanız, --table yerine --database kullanın. 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.

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

2. Oluştur'u belirleyin.

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

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

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

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

Terraform

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ım

Azure Spring Apps için uygulama gözlemlenebilirliğini iyileştirme