Azure Spring Apps'te uygulamanıza bir Azure Cosmos DB veritabanı Bağlan

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

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

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

İ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ğlan veya'yı 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ğlan ion dizesini seçin. Hizmet Bağlan veya erişim anahtarını Cosmos DB 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 İ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ızla Cosmos DB veritabanınız 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, 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ğlan.