Tutorial: Fungsi Python dengan Azure Queue Storage sebagai pemicu

Dalam tutorial ini, Anda mempelajari cara mengonfigurasi fungsi Python dengan Antrean Penyimpanan sebagai pemicu dengan menyelesaikan tugas berikut.

  • Gunakan Visual Studio Code untuk membuat proyek fungsi Python.
  • Gunakan Visual Studio Code untuk menjalankan fungsi secara lokal.
  • Gunakan Azure CLI untuk membuat koneksi antara Azure Function dan Storage Queue dengan Konektor Layanan.
  • Gunakan Visual Studio untuk menyebarkan fungsi Anda.

Gambaran umum komponen proyek fungsi dalam tutorial ini:

Komponen Proyek Pilihan / Solusi
Layanan Sumber Fungsi Azure
Layanan Target Antrean Penyimpanan Azure
Pengikatan Fungsi Antrean Penyimpanan sebagai Pemicu
Jenis Autentikasi Proyek Lokal String Koneksi
Jenis Autentikasi Fungsi Cloud String Koneksi

Peringatan

Microsoft menyarankan agar Anda menggunakan alur autentikasi paling aman yang tersedia. Alur autentikasi yang dijelaskan dalam prosedur ini memerlukan tingkat kepercayaan yang tinggi pada aplikasi, dan membawa risiko yang tidak ada di alur lain. Anda hanya boleh menggunakan alur ini ketika alur lain yang lebih aman, seperti identitas terkelola, tidak layak.

Prasyarat

Membuat proyek fungsi Python

Ikuti tutorial untuk membuat proyek Azure Functions lokal. Berikan informasi berikut pada permintaan:

Prompt Pilihan
Pilih Bahasa Pilih Python. (model bahasa pemrograman v1)
Pilih interpreter Python untuk membuat lingkungan virtual Pilih interpreter Python pilihan Anda. Jika opsi tidak ditampilkan, ketik jalur lengkap ke biner Python Anda.
Pilih templat untuk fungsi pertama proyek Anda Pilih Azure Queue Storage trigger.
Berikan nama fungsi Memasuki QueueStorageTriggerFunc.
Pilih pengaturan dari "local.setting.json" Pilih Create new local app settings, yang memungkinkan Anda memilih Akun Penyimpanan dan memberikan nama antrean yang berfungsi sebagai pemicu.

Dengan informasi ini, Visual Studio Code menghasilkan proyek fungsi Python dengan Azure Storage Queue sebagai pemicunya. Proyek lokal tersambung ke Azure Storage menggunakan string koneksi disimpan ke local.settings.json dalam file. Terakhir, main fungsi dalam __init__.py file fungsi dapat menggunakan string koneksi dengan bantuan Pengikatan Fungsi yang ditentukan dalam function.json file.

Jalankan fungsi secara lokal

Ikuti tutorial untuk menjalankan fungsi secara lokal dan memverifikasi pemicunya.

  1. Jika Anda diminta untuk menyambungkan ke penyimpanan, pilih akun penyimpanan yang Anda pilih saat membuat sumber daya Azure Function. Nilai ini digunakan untuk runtime Azure Function, dan tidak selalu sama dengan akun penyimpanan yang Anda gunakan untuk pemicu.
  2. Untuk memulai fungsi secara lokal, tekan <kbd>F5 </kbd> atau pilih ikon Jalankan dan Debug di bilah Aktivitas sisi kiri.
  3. Untuk memverifikasi bahwa pemicu berfungsi dengan baik, jaga agar fungsi tetap berjalan secara lokal dan buka panel Antrean Penyimpanan di portal Microsoft Azure. Pilih Tambahkan pesan, dan berikan pesan pengujian. Anda akan melihat fungsi dipicu dan diproses sebagai item antrean di terminal Visual Studio Code Anda.

Membuat koneksi menggunakan Konektor Layanan

Pada langkah terakhir, Anda memverifikasi proyek fungsi secara lokal. Selanjutnya, Anda mempelajari cara mengonfigurasi koneksi antara Azure Function dan Azure Storage Queue. Setelah fungsi Anda disebarkan ke cloud, koneksi ini memungkinkan fungsi Anda menerima pemicu dari antrean penyimpanan.

  1. function.json Buka file di proyek lokal Anda, dan ubah nilai connection properti bindings menjadi AZURE_STORAGEQUEUE_CONNECTIONSTRING.
  2. Jalankan perintah Azure CLI berikut untuk membuat koneksi antara Azure Function dan akun penyimpanan Azure Anda.
az functionapp connection create storage-queue --source-id "<your-function-resource-id>" --target-id "<your-storage-queue-resource-id>" --secret
  • --source-id Format: /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
  • --target-id Format: /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/queueServices/default

Langkah ini membuat sumber daya Konektor Layanan yang mengonfigurasi AZURE_STORAGEQUEUE_CONNECTIONSTRING variabel di Pengaturan Aplikasi fungsi. Runtime pengikatan fungsi menggunakannya untuk terhubung ke penyimpanan, sehingga fungsi dapat menerima pemicu dari antrean penyimpanan. Untuk informasi selengkapnya, buka bagaimana Konektor Layanan membantu Azure Functions tersambung ke layanan.

Menyebarkan fungsi Anda ke Azure

Sekarang Anda dapat menyebarkan fungsi Anda ke Azure dan memverifikasi bahwa pemicu antrean penyimpanan berfungsi.

  1. Ikuti tutorial Azure Functions ini untuk menyebarkan fungsi Anda ke Azure.
  2. Buka panel Antrean Penyimpanan di portal Azure. Pilih Tambahkan pesan, dan berikan pesan pengujian. Anda akan melihat fungsi dipicu dan diproses sebagai item antrean di log fungsi Anda.

Pecahkan masalah

Jika ada kesalahan yang terkait dengan host penyimpanan, seperti No such host is known (<account-name>.queue.core.windows.net:443), periksa apakah string koneksi yang Anda gunakan untuk menyambungkan ke Azure Storage berisi titik akhir antrean atau tidak. Jika tidak, buka Azure Storage di portal Azure, salin string koneksi dari panelAccess keys, dan ganti nilai.

Jika kesalahan ini terjadi saat Anda memulai proyek secara lokal, periksa local.settings.json file.

Jika kesalahan ini terjadi saat Anda menyebarkan fungsi Anda ke cloud (dalam hal ini, penyebaran Fungsi biasanya gagal ), Syncing triggers periksa Pengaturan Aplikasi Fungsi Anda.

Membersihkan sumber daya

Jika Anda tidak akan terus menggunakan proyek ini, hapus sumber daya Aplikasi Fungsi yang Anda buat sebelumnya.

  1. Di portal Azure, buka sumber daya Aplikasi Fungsi dan pilih Hapus.
  2. Masukkan nama aplikasi dan pilih Hapus untuk mengonfirmasi.

Langkah berikutnya

Baca artikel berikut untuk mempelajari selengkapnya tentang konsep Konektor Layanan dan caranya membantu Azure Functions terhubung ke layanan.

Mempelajari tentang konsep Konektor Layanan

Menggunakan Konektor Layanan untuk menyambungkan Azure Functions ke layanan cloud lainnya

  • Last updated on