Conectar um banco de dados do Azure Cosmos DB ao aplicativo no Azure Spring Apps

1. Adicione uma das seguintes dependências ao arquivo pom.xml do aplicativo. Escolha a dependência apropriada para o tipo de API.

   • Tipo de API: NoSQL

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

   • Tipo de API: MongoDB

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

   • Tipo de API: Cassandra

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

2. Atualize o aplicativo atual executando az spring app deploy ou crie uma nova implantação para essa alteração executando az spring app deployment create.

Todas as cadeias de conexão e credenciais são injetadas como variáveis de ambiente e é possível referenciar isso no código do aplicativo.

Para obter os nomes de variáveis de ambiente padrão, confira os seguintes artigos:

• Azure Cosmos DB for Table
• Azure Cosmos DB para NoSQL
• Azure Cosmos DB for MongoDB
• Azure Cosmos DB for Gremlin
• Azure Cosmos DB for Cassandra

Usar a CLI do Azure

Use a CLI do Azure para configurar seu aplicativo do Spring para se conectar a um Banco de Dados NoSQL do Cosmos usando o comando az spring connection create, conforme mostrado no exemplo a seguir. Substitua as variáveis no exemplo por valores reais.

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

Use o Portal do Azure

Como alternativa, use o portal do Azure para configurar essa conexão, concluindo as etapas a seguir. O portal do Azure fornece os mesmos recursos que a CLI do Azure e oferece uma experiência interativa.

1. Escolha sua instância do Aplicativos Spring do Azure no portal do Azure e selecione Aplicativos no menu de navegação. Escolha o aplicativo que você deseja conectar e selecione Conector de Serviço no menu de navegação.

2. Selecione Criar.

3. Na guia Básico, para tipo de serviço, selecione Cosmos DB e escolha uma assinatura. Para o tipo de API, selecione Core (SQL), escolha uma conta do Cosmos DB e um banco de dados. Para o tipo de cliente, selecione Java e, em seguida, selecione Avançar: Autenticação. Se você ainda não criou seu banco de dados, consulte Início Rápido: Criar uma conta do Azure Cosmos DB, um banco de dados, um contêiner e itens do portal do Azure.

4. Na guia Autenticação, escolha Cadeia de conexão. O Conector de Serviço recupera automaticamente a chave de acesso da sua conta do Cosmos DB. Selecione Avançar: Rede.

5. Na guia Rede, selecione Configurar regras de firewall para habilitar o acesso ao serviço de destino e, em seguida, selecione Em seguida: Examinar + Criar.

6. Na guia Examinar + Criar, aguarde a validação ser aprovada e selecione Criar. A criação do registro pode levar alguns minutos para ser concluída.

7. Depois que a conexão entre os aplicativos Spring e o banco de dados Cosmos DB tiver sido gerada, você poderá vê-la na página Conector de Serviço e selecionar o botão desdobrar para exibir as variáveis de conexão configuradas.

O script do Terraform a seguir mostra como configurar um aplicativo implantado nos Aplicativos Spring do Azure com uma conta do Azure Cosmos DB.

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
}