Ekstensi Dapr untuk Azure Functions

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.

Tindakan	Arah	Tipe
Pemicu pada pengikatan input Dapr	N/A	daprBindingTrigger
Pemicu pada pemanggilan layanan Dapr	N/A	daprServiceInvocationTrigger
Pemicu pada langganan topik Dapr	N/A	daprTopicTrigger
Tarik dalam status Dapr untuk eksekusi	In	daprState
Menarik rahasia Dapr untuk eksekusi	In	daprSecret
Menyimpan nilai ke status Dapr	Out	daprState
Memanggil aplikasi Dapr lain	Out	daprInvoke
Menerbitkan pesan ke topik Dapr	Out	daprPublish
Mengirim nilai ke pengikatan output Dapr	Out	daprBinding

Pasang 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 1.0.0.

Menggunakan .NET CLI:

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

Tambahkan ekstensi ke proyek Anda dengan menginstal paket NuGet, versi 1.0.0.

Menggunakan .NET CLI:

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

Menginstal bundel

Agar dapat menggunakan ekstensi pengikatan ini di aplikasi Anda, pastikan file host.json di akar proyek Anda berisi referensi ini extensionBundle :

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

Dalam contoh ini, version nilai [4.0.0, 5.0.0) menginstruksikan host Functions untuk menggunakan versi bundel yang setidaknya 4.0.0 tetapi kurang dari 5.0.0, yang mencakup semua versi potensial 4.x. Notasi ini secara efektif mempertahankan aplikasi Anda pada versi minor terbaru yang tersedia dari bundel ekstensi v4.x.

Jika memungkinkan, Anda harus menggunakan versi utama bundel ekstensi terbaru dan memungkinkan runtime untuk secara otomatis mempertahankan versi minor terbaru. Anda dapat melihat konten bundel terbaru pada halaman rilis bundel ekstensi. Untuk informasi selengkapnya, lihat Bundel ekstensi Azure Functions.

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.

Bisep
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 -tanggal yang paling up-to.

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

Cuplikan layar yang menunjukkan tempat menemukan pengaktifan Dapr untuk Aplikasi Fungsi di portal Microsoft Azure.

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 dalam proses
Proses terisolasi

Pustaka kelas dalam proses adalah fungsi C# yang dikompilasi berjalan dalam proses yang sama dengan runtime Functions.

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

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

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