Azure SDK istemcilerini otomatik yapılandırma

Spring Boot, Spring Cloud Azure geliştirme deneyimini basitleştirir. Spring Cloud Azure başlatıcıları, uygulamanıza dahil etmek için kullanışlı bağımlılık tanımlayıcıları kümesidir. Başlatıcılar nesne örnekleme ve yapılandırma mantığını işler, bu nedenle bunu yapmak zorunda değilsiniz. Her starter, Azure bulut ortamı ve kimlik doğrulama bilgileri gibi kritik yapılandırma öğelerini sağlamak için spring-cloud-azure-starter öğesine bağlıdır. Bunları, aşağıdaki örnekte gösterildiği gibi bir YAML dosyasındaki özellikler olarak yapılandırabilirsiniz:

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

Not

cloud özelliği isteğe bağlıdır.

tenant-id için izin verilen değerler şunlardır: common, organizations, consumersveya kiracı kimliği. Bu değerler hakkında daha fazla bilgi için, Hata AADSTS50020 - Kimlik sağlayıcısındaki kullanıcı hesabı kiracıda mevcut değil başlıklı konunun Yanlış uç nokta kullanıldı (kişisel ve kuruluş hesapları) bölümüne bakın. Tek kiracılı uygulamanızı dönüştürme hakkında bilgi için bkz. Tek kiracılı uygulamayı Microsoft Entra IDüzerinde çok kiracılıya dönüştürme.

Bu özellikler isteğe bağlıdır. Bunları belirtmezseniz Spring Boot bunları sizin için otomatik olarak bulmaya çalışır. Spring Boot'un bu özellikleri nasıl bulduğuyla ilgili ayrıntılar için belgelere bakın.

Bağımlılık kurulumu

Spring Cloud Azure başlangıçlarını iki şekilde kullanabilirsiniz. İlk yol, aşağıdaki örnekte gösterildiği gibi Azure SDK'larını spring-cloud-azure-starter bağımlılığıyla kullanmaktır:

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

İkinci yol, Azure SDK bağımlılıkları eklemekten kaçınmak ve bunun yerine doğrudan her hizmet için Spring Cloud Azure Starter'ı eklemektir. Örneğin, Azure Cosmos DB ile aşağıdaki bağımlılığı eklersiniz:

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

İpucu

Desteklenen başlatıcıların listesi için Spring Cloud Azure geliştirici kılavuzununStarter bağımlılıkları bölümüne bakın.

Konfigürasyon

Not

Azure bir kaynağa erişim için Microsoft Entra ID kimlik doğrulaması yapmak ve yetkilendirmek için bir güvenlik sorumlusu kullanıyorsanız, güvenlik sorumlusunun Azure kaynağına erişmek için yeterli izne sahip olduğundan emin olun. Daha fazla bilgi için bkz. Microsoft Entra ID ile erişimi yetkilendirme.

Her Azure hizmeti için yapılandırma özellikleri ön ekinin spring.cloud.azure.<azure-service>altındadır.

İpucu

Tüm Spring Cloud Azure yapılandırma özelliklerinin listesi için bkz. Spring Cloud Azure yapılandırma özellikleri.

Temel kullanım

Azure Cosmos DB istemcisini otomatik olarak yapılandırmak için application.yaml dosyanıza aşağıdaki özellikleri ekleyin.

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

Ardından, hem hem CosmosClient de CosmosAsyncClient bağlam içinde kullanılabilir ve aşağıdaki örnekte gösterildiği gibi bunları otomatik olarak bağlayabilirsiniz:

class Demo {
@Autowired
private CosmosClient cosmosClient;

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

Örnekler

GitHub'daki azure-spring-boot-samples depoya bakın.