Ekstensi Dapr untuk Azure Functions

Artikel
02/06/2024

Penting

Ekstensi Dapr untuk Azure Functions saat ini dalam pratinjau dan hanya didukung di lingkungan Azure Container Apps.

Ekstensi Dapr untuk Azure Functions adalah sekumpulan alat dan layanan yang memungkinkan pengembang untuk dengan mudah mengintegrasikan Azure Functions dengan platform Distributed Application Runtime (Dapr).

Azure Functions adalah layanan komputasi berbasis peristiwa yang menyediakan serangkaian pemicu dan pengikatan untuk terhubung dengan layanan Azure lainnya dengan mudah. Dapr menyediakan serangkaian blok penyusun dan praktik terbaik untuk membangun aplikasi terdistribusi, termasuk layanan mikro, manajemen status, pub/sub olahpesan, dan banyak lagi.

Dengan integrasi antara Dapr dan Functions, Anda dapat membangun fungsi yang bereaksi terhadap peristiwa dari Dapr atau sistem eksternal.

Perbuatan	Arah	Jenis
Pemicu pada pengikatan input Dapr	T/A	daprBindingTrigger
Pemicu pada pemanggilan layanan Dapr	T/A	daprServiceInvocationTrigger
Pemicu pada langganan topik Dapr	T/A	daprTopicTrigger
Tarik dalam status Dapr untuk eksekusi	Masuk	daprState
Menarik rahasia Dapr untuk eksekusi	Masuk	daprSecret
Menyimpan nilai ke status Dapr	Kehabisan	daprState
Memanggil aplikasi Dapr lain	Kehabisan	daprInvoke
Menerbitkan pesan ke topik Dapr	Kehabisan	daprPublish
Mengirim nilai ke pengikatan output Dapr	Kehabisan	daprBinding

Menginstal ekstensi

Paket NuGet ekstensi yang Anda instal tergantung pada mode C# dalam proses atau proses pekerja terisolasi yang Anda gunakan di aplikasi fungsi Anda:

Sedang dalam proses
Proses terisolasi

Ekstensi ini tersedia dengan menginstal paket NuGet, versi 0.17.0-preview01.

Menggunakan CLI .NET:

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

Tambahkan ekstensi ke proyek Anda dengan menginstal paket NuGet, versi 0.17.0-preview01.

Menggunakan CLI .NET:

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

Memasang bundel

Pratinjau Bundel v4.x

Anda dapat menambahkan ekstensi pratinjau dengan menambahkan atau mengganti kode berikut dalam file Anda host.json :

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

Pengaktifan Dapr

Anda dapat mengonfigurasi Dapr menggunakan berbagai [argumen dan anotasi][dapr-args] berdasarkan konteks runtime. Anda dapat mengonfigurasi Dapr untuk Azure Functions melalui dua saluran:

Templat Infrastruktur sebagai Kode (IaC), seperti dalam templat Bicep atau Azure Resource Manager (ARM)
Portal Microsoft Azure

Saat menggunakan templat IaC, tentukan argumen berikut di bagian properties definisi sumber daya aplikasi kontainer.

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
}

Nilai konfigurasi Dapr di atas dianggap sebagai perubahan cakupan aplikasi. Saat Anda menjalankan aplikasi kontainer dalam mode beberapa revisi, perubahan pada pengaturan ini tidak akan membuat revisi baru. Sebagai gantinya, semua revisi yang ada dimulai ulang untuk memastikan revisi dikonfigurasi dengan nilai terbaru.

Saat mengonfigurasi Dapr menggunakan portal Azure, navigasikan ke aplikasi fungsi Anda dan pilih Dapr dari menu sisi kiri:

Screenshot demonstrating where to find Dapr enablement for a Function App in the Azure portal.

Port dapr dan listener

Saat Anda memicu fungsi dari Dapr, ekstensi mengekspos port 3001 secara otomatis untuk mendengarkan permintaan masuk dari sidecar Dapr.

Penting

Port 3001 hanya diekspos dan didengarkan jika pemicu Dapr ditentukan dalam aplikasi fungsi. Saat menggunakan Dapr, sidecar menunggu untuk menerima respons dari port yang ditentukan sebelum menyelesaikan instansiasi. Jangan tentukan dapr.io/port anotasi atau --app-port kecuali Anda memiliki pemicu. Melakukannya dapat mengunci aplikasi Anda dari sidecar Dapr.

Jika Anda hanya menggunakan pengikatan input dan output, port 3001 tidak perlu diekspos atau ditentukan.

Secara default, ketika Azure Functions mencoba berkomunikasi dengan Dapr, Azure Functions memanggil Dapr melalui port yang diselesaikan dari variabel DAPR_HTTP_PORTlingkungan . Jika variabel tersebut null, variabel tersebut default ke port 3500.

Anda dapat mengambil alih alamat Dapr yang digunakan oleh pengikatan input dan output dengan mengatur DaprAddress properti di function.json untuk pengikatan (atau atribut). Secara default, ia menggunakan http://localhost:{DAPR_HTTP_PORT}.

Aplikasi fungsi masih mengekspos port dan titik akhir lain untuk hal-hal seperti pemicu HTTP, yang secara lokal default ke 7071, tetapi dalam kontainer, default ke 80.

Jenis pengikatan

Jenis pengikatan yang didukung untuk .NET bergantung pada versi ekstensi dan mode eksekusi C#, yang dapat menjadi salah satu hal berikut:

Pustaka kelas .NET Framework yang berada dalam proses
Proses terisolasi

Pustaka kelas dalam proses adalah kompilasi fungsi #C yang berjalan pada proses yang sama seperti runtime Functions.

Ekstensi Dapr mendukung jenis parameter sesuai dengan tabel di bawah ini.

Mengikat	Jenis parameter
Pemicu Dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Input Dapr	daprState daprSecret
Output Dapr	daprState daprInvoke daprPublish daprBinding

Untuk contoh penggunaan jenis ini, lihat repositori GitHub untuk ekstensi.