Enlace de una base de datos de Azure Cosmos DB a una aplicación en Azure Spring Cloud

Azure Cosmos DB tiene cinco tipos de API diferentes que admiten el enlace. En el procedimiento siguiente se muestra cómo usarlas:

1. Crea una base de datos de Azure Cosmos DB. Consulte el inicio rápido sobre la creación de una base de datos para obtener ayuda.

2. Registre el nombre de la base de datos. En este procedimiento, el nombre de la base de datos es testdb.

3. Vaya a la página del servicio Azure Spring Cloud en Azure Portal. Vaya a Application Dashboard (Panel de la aplicación) y seleccione la aplicación que va a enlazar a Azure Cosmos DB. Esta aplicación es la misma que actualizó o implementó en el paso anterior.

4. Seleccione Service binding (Enlace de servicio) y seleccione Create service binding (Crear enlace de servicio). Para rellenar el formulario, seleccione:

   • El valor de Binding type (Tipo de enlace) de Azure Cosmos DB.
   • El tipo de API.
   • El nombre de la base de datos.
   • La cuenta de Azure Cosmos DB.

   Nota

   Si usa Cassandra, utilice un espacio de claves para el nombre de la base de datos.

5. Seleccione Restart (Reiniciar) en la página de la aplicación para reiniciar la aplicación.

6. Para tener la seguridad de que el servicio esté enlazado correctamente, seleccione el nombre del enlace y compruebe sus detalles. El campo property debe ser parecido a este ejemplo:

   azure.cosmosdb.uri=https://<some account>.documents.azure.com:443
   azure.cosmosdb.key=abc******
   azure.cosmosdb.database=testdb
   

El siguiente script de Terraform muestra cómo configurar una aplicación Azure Spring Cloud con la API de MongoDB de Azure Cosmos DB.

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_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                = "MongoDB"

  consistency_policy {
    consistency_level = "Session"
  }

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

resource "azurerm_cosmosdb_mongo_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
  cpu                 = 2
  memory_in_gb        = 4
  instance_count      = 2
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "azure.cosmosdb.uri" : azurerm_cosmosdb_account.cosmosdb.connection_strings[0]
    "azure.cosmosdb.database" : azurerm_cosmosdb_mongo_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
}