Dapr tarafından desteklenen mikro hizmet API'leri

Azure Container Apps basit, taşınabilir, dayanıklı ve güvenli mikro hizmetler yazmanıza ve uygulamanıza yardımcı olan Dağıtılmış Uygulama Çalışma Zamanı (Dapr) tarafından desteklenen API'ler sağlar. Dapr, azure container apps ile birlikte bir soyutlama katmanı olarak çalışarak düşük bakım ve ölçeklenebilir bir platform sağlar.

Azure Container Apps, özellikle mikro hizmet senaryolarına yönelik, tam olarak yönetilen Dapr API'leri, bileşenleri ve özellikleri sunar. Kapsayıcı uygulaması ortamınızda Dapr'ı her zamanki gibi etkinleştirmeniz ve yapılandırmanız yeterlidir.

Not

GitHub'daki Azure Container Apps'te Dapr güncelleştirmelerini ve yayın duyurularını bulun.

Mikro hizmetler API'leri kapsayıcı uygulamanızla nasıl çalışır?

Kapsayıcı uygulamaları ortamınız için mikro hizmet API'lerini Dapr özellikli bir kapsayıcı uygulaması, çözümünüz için yapılandırılmış bir Dapr bileşeni ve aralarındaki iletişimi çağıran bir Dapr sepet ile yapılandırın. Aşağıdaki diyagramda, örnek olarak pub/sub API'sini kullanarak bu temel kavramlar gösterilmektedir.

Etiket	Dapr ayarları	Açıklama
1	Dapr etkinleştirilmiş Kapsayıcı Uygulamalar	Dapr, bir dizi Dapr bağımsız değişkeni yapılandırılarak kapsayıcı uygulama düzeyinde etkinleştirilir. Bu değerler, birden çok düzeltme modunda çalışırken belirli bir kapsayıcı uygulamasının tüm düzeltmelerine uygulanır.
2	Dapr	Tam yönetilen Dapr API'leri, bir Dapr yan araba aracılığıyla her kapsayıcı uygulamaya sunulur. Dapr API'leri kapsayıcı uygulamanızdan HTTP veya gRPC aracılığıyla çağrılabilir. Dapr yan araba HTTP Port 3500 ve gRPC Port 50001 üzerinde çalışır.
3	Dapr bileşen yapılandırması	Dapr, işlevselliğin bileşen olarak sunulduğu modüler bir tasarım kullanır. Dapr bileşenleri birden çok kapsayıcı uygulamasında paylaşılabilir. Kapsamlar dizisinde sağlanan Dapr uygulama tanımlayıcıları, çalışma zamanında belirli bir bileşeni hangi dapr özellikli kapsayıcı uygulamalarının yükleyileceğini belirler.

Sürüm oluşturma

Azure Container Apps'teki Dapr, sabit bir sürüm zamanlamasını izlemek yerine, Dapr ikili dosyalarının öncelik belirlemesine ve kararlılığına göre yeni özellikler ve işlevler yayınlar. Azure Container Apps'teki Dapr sürümleri hakkında daha fazla bilgi edinmek için bkz. Dapr sürümleri ne sıklıkta yayınlanır?

Azure Container Apps'teki Dapr sürümleri şunlardır:

• İlgili OSS Dapr çalışma zamanı sürümü API'leri ve SDK'lar ve CLI gibi ilgili araçlarla uyumluluğu belirten gibi bir anlamsal sürüm oluşturma ön eki 1.13.6.
• -msft.<number> Gelişmiş güvenlik ve üretim hazırlığı için Azure'a özgü özelleştirmelerin dahil olduğunu belirten bir sonek.

Azure Container Apps'te Dapr için tam sürüm formatı şöyle görünebilir: 1.13.6-msft.1.

Not

<number> Son ekteki değeri her zaman sıralı olarak artmayabilir. Örneğin, 1.13.6-msft.3 sürümü 1.13.6-msft.2 atlayabilir.

Desteklenen Dapr API'leri, bileşenleri ve araçları

Yönetilen API'ler

Azure Container Apps, yönetilen genel kullanıma açık Dapr API'leri (yapı taşı API'leri ve operasyonel API'ler) sunar. Bu API'ler tam olarak yönetilir ve üretim ortamlarında kullanılmak üzere desteklenir.

Alfa Dapr API'lerini ve özelliklerini kullanma hakkında daha fazla bilgi edinmek için Bkz. Dapr SSS.

Yapı taşı API'leri

Yapı taşı API'si	Çalıştırma Durumu	Açıklama
Hizmetler arası çağrı	Georgia	Hizmetleri keşfedin ve otomatik mTLS kimlik doğrulaması ve şifreleme ile güvenilir, doğrudan hizmet-hizmet çağrıları gerçekleştirin. Bkz. Azure Container Apps'te Dapr hizmeti çağırma için bilinen sınırlamalar.
Durum yönetimi	Georgia	İşlemler ve CRUD işlemleri için durum yönetimi özellikleri sağlar.
Pub/sub	Georgia	Yayımcı ve abone kapsayıcı uygulamalarının aracı bir ileti aracısı aracılığıyla etkileşime girmelerine izin verir. Dış bileşen JSON dosyası kullanarak bir konuya bildirim temelli abonelikler de oluşturabilirsiniz. Bildirim temelli pub/alt API hakkında daha fazla bilgi edinin.
Bağlamalar	Georgia	Uygulamalarınızı olaylara göre tetikleme.
Aktör	Georgia	Dapr aktörleri, hızla ölçeklendirilmek üzere tasarlanmış, ileti temelli ve tek iş parçacığı ile çalışan iş birimleridir. Örneğin, yoğun iş yükü durumlarında.
Sırlar	Georgia	Uygulama kodunuzdan gizli dizilere erişin veya Dapr bileşenlerinizdeki güvenli değerlere başvurun.
Yapılandırma	Georgia	Desteklenen yapılandırma depoları için uygulama yapılandırma öğelerini alın ve bu öğelere abone olun.

İşletimsel API'ler

İşlem API'si	Çalıştırma Durumu	Açıklama
Sağlık	Georgia	Dapr'ın hazır olma durumunu veya canlılığını ve SDK'ların başlatma hazırlığını izleyen sistem durumu denetimi yoklamaları. Sistem durumu API'si yalnızca HTTP için kullanılabilir. Kapsayıcı uygulamanızda Dapr etkinleştirildiğinde Dapr sepet durumu denetimleri otomatik olarak yapılandırılır.
Meta veriler	Georgia	Sidecar hakkında bilgi verir ve çalışma zamanında keşfedilebilirlik sağlar.

Uyumlu SDK'lar

Dapr'ın en son istemci SDK paketleri Azure Container Apps ile uyumludur. Dapr SDK'larını desteklenen GA Dapr v1.12 çalışma zamanı API'lerinden herhangi biriyle kullanabilirsiniz.

Not

Şu anda Dapr sunucu uzantıları, aktör ve iş akışı SDK'sı paketleri Azure Container Apps ile uyumlu değildir. Tüm Dapr SDK paketleri hakkında daha fazla bilgi edinmek için bkz. SDK'lar.

Dapr bileşenleri

Katman 1 ile Katman 2 bileşenleri karşılaştırması

Dapr bileşenlerinin bir alt kümesi desteklenir. Bu alt kümede Dapr bileşenleri iki destek kategorisine ayrılır: Katman 1 veya Katman 2.

• Katman 1 bileşenleri: Kritik (güvenlik veya ciddi regresyon) senaryolarında anında araştırma alan kararlı bileşenler. Microsoft, aksi durumda, açık kaynak ile işbirliği yaparak bu sorunu bir düzeltme veya bir sonraki düzenli sürümde ele alır.
• Katman 2 bileşenleri: Kararlı durumda olmadığı veya üçüncü taraf sağlayıcıyla birlikte oldukları için daha az öncelikli olarak araştırılan bileşenler.

Katman 1 bileşenleri

Uygulama Programlama Arayüzü (API)	Bileşen	Tür
Durum yönetimi	Azure Cosmos DB veritabanı Azure Blob Depolama v1 Azure Tablo Depolama Sistemi Microsoft SQL Server	state.azure.cosmosdb state.azure.blobstorage state.azure.tablestorage state.sqlserver
Yayımla ve abone ol	Azure Service Bus Kuyrukları Azure Service Bus Konuları Azure Event Hubs	pubsub.azure.servicebus.queues pubsub.azure.servicebus.topics pubsub.azure.eventhubs
Bağlama	Azure Depolama Kuyrukları Azure Service Bus Kuyrukları Azure Blob Saklama Alanı Azure Event Hubs	bindings.azure.storagequeues bindings.azure.servicebusqueues bindings.azure.blobstorage bindings.azure.eventhubs
Gizli bilgi yönetimi	Azure Key Vault	secretstores.azure.keyvault

Katman 2 bileşenleri

Uygulama Programlama Arayüzü (API)	Bileşen	Tür
Durum yönetimi	PostgreSQL MySQL & MariaDB Redis	state.postgresql state.mysql state.redis
Yayımla ve abone ol	Apache Kafka Redis Akışları	pubsub.kafka pubsub.redis
Bağlama	Azure Event Grid Azure Cosmos DB veritabanı Apache Kafka PostgreSQL Redis Cron	bindings.azure.eventgrid bindings.azure.cosmosdb bindings.kafka bindings.postgresql bindings.redis bindings.cron
Yapılandırma	PostgreSQL Redis	configuration.postgresql configuration.redis

Desteklenen Dapr bileşenlerini kullanma hakkında daha fazla bilgi edinmek için bkz. Azure Container Apps'te Dapr bileşenleri.

Takım Tezgahları

Azure Container Apps, SDK'lar ve CLI gibi Dapr açık kaynak araçlarıyla uyumluluk sağlar.

Sınırlamalar

• Dapr Yapılandırma belirtimi: Dapr yapılandırma belirtiminin kullanılmasını gerektiren tüm özellikler.
• Dapr etkinleştirme kılavuzunda listelenmeyen herhangi bir Dapr yan araba ek açıklamaları.
• API'ler ve bileşenler desteği: Azure Container Apps'te yalnızca Ga, Katman 1 veya Katman 2 olarak listelenen Dapr API'leri ve bileşenleri desteklenir.
• Aktör anımsatıcıları: Anımsatıcıların her zaman etkin olduğundan ve doğru şekilde tetiklendiğinden emin olmak için minimum kopya sayısının 1+ olması gerekir.
• İşler: İşler için Dapr desteklenmez.

İlgili içerik

• Aşağıdakini kullanarak bir Dapr uygulaması dağıtın:
  • Azure CLI
  • ARM veya Bicep dosyaları
• Mevcut kapsayıcı uygulamasında Dapr'i etkinleştirme