Azure İşlevleri için Dapr Uzantısı

Makale
05/10/2024

Azure İşlevleri için Dapr Uzantısı, geliştiricilerin Azure İşlevleri Dağıtılmış Uygulama Çalışma Zamanı (Dapr) platformuyla kolayca tümleştirmesini sağlayan bir araç ve hizmet kümesidir.

Azure İşlevleri, diğer Azure hizmetlerine kolayca bağlanmak için bir dizi tetikleyici ve bağlama sağlayan olay temelli bir işlem hizmetidir. Dapr, mikro hizmetler, durum yönetimi, pub/sub mesajlaşması ve daha fazlası dahil olmak üzere dağıtılmış uygulamalar oluşturmaya yönelik bir dizi yapı taşları ve en iyi yöntemleri sağlar.

Dapr ve İşlevler arasındaki tümleştirmeyle, Dapr veya dış sistemlerden gelen olaylara tepki veren işlevler oluşturabilirsiniz.

Eylem	Yön	Tür
Dapr giriş bağlaması üzerinde tetikleyici	Yok	daprBindingTrigger
Bir Dapr hizmeti çağrısında tetikleme	Yok	daprServiceInvocationTrigger
Dapr konu aboneliğinde tetikleme	Yok	daprTopicTrigger
Yürütme için Dapr durumunu çekme	İçinde	daprState
Yürütme için Dapr gizli dizilerini çekme	İçinde	daprSecret
Bir değeri Dapr durumuna kaydetme	Dışarı	daprState
Başka bir Dapr uygulaması çağırma	Dışarı	daprInvoke
Dapr konusuna ileti yayımlama	Dışarı	daprPublish
Dapr çıkış bağlamasına değer gönderme	Dışarı	daprBinding

Uzantıyı yükleme

Yüklediğiniz NuGet uzantısı, işlev uygulamanızda kullandığınız C# moduna veya yalıtılmış çalışan işlemine bağlıdır:

İşlemde
Yalıtılmış işlem

Bu uzantı, NuGet paketi, sürüm 1.0.0 yüklenerek kullanılabilir.

.NET CLI'yi kullanma:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr

NuGet paketi sürüm 1.0.0'ı yükleyerek uzantıyı projenize ekleyin.

.NET CLI'yi kullanma:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr

Paket yükleme

Paket v4.x

Dosyanıza host.json aşağıdaki kodu ekleyerek veya değiştirerek uzantıyı ekleyebilirsiniz:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Dapr etkinleştirme

Dapr'ı, çalışma zamanı bağlamını temel alarak çeşitli [bağımsız değişkenler ve ek açıklamalar][dapr-args] kullanarak yapılandırabilirsiniz. Dapr'ı iki kanal aracılığıyla Azure İşlevleri için yapılandırabilirsiniz:

Bicep veya Azure Resource Manager (ARM) şablonlarında olduğu gibi Kod Olarak Altyapı (IaC) şablonları
Azure portal

IaC şablonu kullanırken, kapsayıcı uygulaması kaynak tanımının properties bölümünde aşağıdaki bağımsız değişkenleri belirtin.

Bicep
ARM

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

Yukarıdaki Dapr yapılandırma değerleri uygulama kapsamı değişiklikleri olarak kabul edilir. Bir kapsayıcı uygulamasını birden çok düzeltme modunda çalıştırdığınızda, bu ayarlarda yapılan değişiklikler yeni bir düzeltme oluşturmaz. Bunun yerine, tüm mevcut düzeltmeler en güncel değerlerle yapılandırıldığından emin olmak için yeniden başlatılır.

Azure portalını kullanarak Dapr'ı yapılandırırken işlev uygulamanıza gidin ve sol taraftaki menüden Dapr'ı seçin:

Azure portalında bir İşlev Uygulaması için Dapr etkinleştirmesinin nerede bulunacağı gösteren ekran görüntüsü.

Dapr bağlantı noktaları ve dinleyiciler

Dapr'dan bir işlevi tetiklerken uzantı, Dapr sepetten gelen istekleri dinlemek için bağlantı noktasını 3001 otomatik olarak kullanıma sunar.

Önemli

Bağlantı noktası 3001 yalnızca işlev uygulamasında bir Dapr tetikleyicisi tanımlandığında kullanıma sunulur ve dinlenilir. Dapr kullanılırken sepet, örneklemeyi tamamlamadan önce tanımlanan bağlantı noktasından yanıt almayı bekler. Ek açıklamayı tanımlamayın dapr.io/port veya --app-port tetikleyiciniz olmadığı sürece. Bunun yapılması uygulamanızı Dapr sepetten kilitler.

Yalnızca giriş ve çıkış bağlamaları kullanıyorsanız bağlantı noktasının 3001 kullanıma sunulması veya tanımlanması gerekmez.

Varsayılan olarak, Azure İşlevleri Dapr ile iletişim kurmaya çalıştığında ortam değişkeninden DAPR_HTTP_PORTçözümlenen bağlantı noktası üzerinden Dapr'ı çağırır. Bu değişken null ise, varsayılan olarak bağlantı noktası 3500olur.

bağlama (veya özniteliği) için özelliğini function.json ayarlayarak DaprAddress giriş ve çıkış bağlamaları tarafından kullanılan Dapr adresini geçersiz kılabilirsiniz. Varsayılan olarak kullanır http://localhost:{DAPR_HTTP_PORT}.

İşlev uygulaması, http tetikleyicileri gibi yerel olarak varsayılan olan ancak kapsayıcıda varsayılan 707180değeri olan başka bir bağlantı noktasını ve uç noktayı kullanıma sunar.

Bağlama türleri

.NET için desteklenen bağlama türleri, aşağıdakilerden biri olabilecek uzantı sürümüne ve C# yürütme moduna bağlıdır:

İşlem içi sınıf kitaplığı
Yalıtılmış işlem

İşlem içi sınıf kitaplığı, İşlevler çalışma zamanıyla aynı işlemde çalıştırılan derlenmiş bir C# işlevidir.

Dapr Uzantısı, aşağıdaki tabloya göre parametre türlerini destekler.

Bağlama	Parametre türleri
Dapr tetikleyicisi	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dapr girişi	daprState daprSecret
Dapr çıkışı	daprState daprInvoke daprPublish daprBinding

Bu türleri kullanan örnekler için uzantının GitHub deposuna bakın.