Configurazione automatica dei client dell'SDK di Azure

Spring Boot semplifica l'esperienza di sviluppo di Spring Cloud Azure. Spring Cloud Azure Starters è un set di utili descrittori di dipendenze da includere nell'applicazione. Gli starter si occupano dell'istanziazione degli oggetti e della logica di configurazione, quindi non devi farlo tu. Ogni avvio dipende da spring-cloud-azure-starter per fornire bit critici di configurazione, ad esempio l'ambiente cloud di Azure e le informazioni di autenticazione. È possibile configurare queste proprietà come proprietà in, ad esempio un file YAML, come illustrato nell'esempio seguente:

spring:
  cloud:
    azure:
      profile:
        tenant-id: <tenant>
        cloud-type: Azure
      credential:
        client-id: ${AZURE_CLIENT_ID}

Nota

La proprietà cloud è facoltativa.

I valori consentiti per tenant-id sono: common, organizations, consumerso l'ID tenant. Per altre informazioni su questi valori, vedere la sezione Usato l'endpoint errato (account personali e dell'organizzazione) di Errore AADSTS50020 - L'account utente del provider di identità non esiste nel tenant. Per informazioni sulla conversione dell'app a tenant singolo, vedere Convertire l'app a tenant singolo in multi-tenant in Microsoft Entra ID.

Queste proprietà sono facoltative. Se non vengono specificati, Spring Boot tenta di trovarli automaticamente. Per informazioni dettagliate su come Spring Boot trova queste proprietà, vedere la documentazione.

Configurazione delle dipendenze

È possibile usare spring cloud Azure starter in due modi. Il primo modo consiste nell'usare gli SDK di Azure con la dipendenza spring-cloud-azure-starter, come illustrato nell'esempio seguente:

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

Il secondo modo consiste nell'evitare di aggiungere Azure SDK dipendenze e includere invece Spring Cloud Azure Starter per ogni servizio direttamente. Ad esempio, con Azure Cosmos DB, si aggiunge la dipendenza seguente:

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

Suggerimento

Per l'elenco degli starter supportati, consultare la sezione Dipendenze degli starter della guida per gli sviluppatori di Spring Cloud Azure.

Configurazione

Nota

Se si usa un'entità di sicurezza per eseguire l'autenticazione e l'autorizzazione con Microsoft Entra ID per accedere a una risorsa Azure, assicurarsi che l'entità di sicurezza disponga di autorizzazioni sufficienti per accedere alla risorsa Azure. Per altre informazioni, vedere Autorizzare l'accesso con Microsoft Entra ID.

Le proprietà di configurazione per ogni servizio Azure si trovano sotto il prefisso spring.cloud.azure.<azure-service>.

Suggerimento

Per l'elenco di tutte le proprietà di configurazione di Spring Cloud Azure, vedere proprietà di configurazione di Spring Cloud Azure.

Utilizzo di base

Aggiungere le proprietà seguenti al file application.yaml per configurare automaticamente il client Azure Cosmos DB.

spring:
  cloud:
    azure:
      cosmos:
        database: ${AZURE_COSMOS_DATABASE_NAME}
        endpoint: ${AZURE_COSMOS_ENDPOINT}
        consistency-level: eventual
        connection-mode: direct

Quindi, sia CosmosClient che CosmosAsyncClient sono disponibili nel contesto ed è possibile cablarli automaticamente, come illustrato nell'esempio seguente:

class Demo {
@Autowired
private CosmosClient cosmosClient;

    @Override
    public void run() {
        User item = User.randomUser();
        CosmosContainer container = cosmosClient.getDatabase(databaseName).getContainer(containerName);
        container.createItem(item);
    }
}

Campioni

Consulta il repository azure-spring-boot-samples su GitHub.