Membuat fungsi di Azure yang dipicu penyimpanan Blob

Mempelajari cara membuat fungsi yang dipicu saat file diunggah atau diperbarui dalam kontainer penyimpanan Blob.

Prasyarat

  • Langganan Azure. Jika Anda tidak memilikinya, buatlah akun gratis sebelum Anda mulai.

Buat aplikasi Azure Function

  1. Pada menu portal Microsoft Azure atau halaman Beranda, pilih Buat sumber daya.

  2. Di halaman Baru, pilih Komputasi>Aplikasi Fungsi.

  3. Di halaman Dasar, gunakan pengaturan aplikasi fungsi seperti ditentukan dalam tabel di bawah:

    Pengaturan Nilai yang disarankan Deskripsi
    Langganan Langganan Anda Langganan tempat Anda akan membuat aplikasi fungsi baru.
    Grup Sumber Daya myResourceGroup Nama untuk grup sumber daya baru tempat Anda akan membuat aplikasi fungsi Anda.
    Nama Aplikasi Fungsi Nama unik global Nama yang mengidentifikasi aplikasi fungsi baru Anda. Karakter yang valid a-z(tidak peka huruf besar/kecil),0-9, dan -.
    Terbitkan Kode Opsi untuk menerbitkan file kode atau kontainer Docker.
    Tumpukan runtime Bahasa pilihan Pilih runtime yang mendukung bahasa pemrograman fungsi favorit Anda. Pengeditan dalam portal hanya tersedia untuk skript C#, JavaScript, PowerShell, dan TypeScript. Fungsi Python, Java, dan pustaka kelas C#, harus dikembangkan secara lokal.
    Versi Nomor Versi Pilih versi runtime yang terpasang.
    Wilayah Wilayah pilihan Pilih wilayah yang ada di dekat Anda atau di dekat layanan lain yang dapat diakses oleh fungsi Anda.
  4. Pilih Berikutnya : Hosting. Pada halaman Hosting, masukkan pengaturan berikut:

    Pengaturan Nilai yang disarankan Deskripsi
    Akun penyimpanan Nama unik global Buat akun penyimpanan yang digunakan oleh aplikasi fungsi Anda. Panjang karakter nama akun penyimpanan harus 3 hingga 24 karakter dan hanya mengandung angka dan huruf kecil saja. Anda juga dapat menggunakan akun yang sudah ada, yang harus memenuhi persyaratan akun penyimpanan.
    Sistem Operasi Windows Sistem operasi telah dipilih untuk Anda sebelumnya berdasarkan pilihan tumpukan runtime, tetapi Anda dapat mengubah pengaturan jika diperlukan. Pengeditan dalam portal hanya didukung di Windows.
    Paket Konsumsi (Tanpa server) Paket hosting yang menentukan bagaimana sumber daya dialokasikan ke aplikasi fungsi Anda. Dalam paket Konsumsi default, sumber daya ditambahkan secara dinamis sebagaimana diperlukan oleh fungsi Anda. Dalam hosting tanpa server ini, Anda cukup membayar durasi waktu saat fungsi Anda berjalan. Saat Anda menjalankan paket Azure App Service, Anda harus mengelola penskalaan aplikasi fungsi Anda.
  5. Pilih Berikutnya : Pemantauan. Pada halaman Pemantauan, masukkan pengaturan berikut:

    Pengaturan Nilai yang disarankan Deskripsi
    Application Insights Default Membuat sumber daya Application Insights dari nama aplikasi yang sama di wilayah terdekat yang didukung. Dengan memperluas pengaturan ini atau memilih Buat baru, Anda dapat mengubah nama Application Insights atau memilih wilayah lain dalam geografi Azure tempat Anda ingin menyimpan data Anda.
  6. Pilih Tinjau + buat untuk meninjau pilihan konfigurasi aplikasi.

  7. Pada halaman Tinjau + buat, tinjau pengaturan Anda, lalu pilih Buat untuk menyediakan dan menerapkan aplikasi fungsi.

  8. Pilih ikon Pemberitahuan di sudut kanan atas portal dan lihat pesan Deployment berhasil.

  9. Pilih Buka sumber daya untuk melihat aplikasi fungsi baru Anda. Anda juga dapat memilih Sematkan ke dasbor. Penyematan ini memudahkan Anda untuk kembali ke sumber daya aplikasi fungsi ini dari dasbor Anda.

    Screenshot of deployment notification.

Anda berhasil membuat aplikasi fungsi baru.

Function app successfully created.

Selanjutnya, buat fungsi di aplikasi fungsi baru.

Membuat fungsi yang dipicu penyimpanan Azure Blob

  1. Pilih Fungsi, lalu pilih + Tambah untuk menambahkan fungsi baru.

    Choose a Function template in the Azure portal.

  2. Pilih templat pemicu Azure Blob Storage.

  3. Gunakan pengaturan dalam tabel di bawah gambar.

    Name and configure the Blob storage triggered function.

    Pengaturan Nilai yang disarankan Deskripsi
    Fungsi baru Unik di aplikasi fungsi Anda Nama fungsi yang dipicu blob ini.
    Jalur sampel-workitems/{name} Lokasi di penyimpanan Blob sedang dipantau. Nama file blob diteruskan dalam pengikatan sebagai nama parameter.
    Koneksi akun Storage AzureWebJobsStorage Anda dapat menggunakan koneksi akun penyimpanan yang sudah digunakan oleh aplikasi fungsi Anda, atau membuat yang baru.
  4. Pilih Buat Fungsi untuk membuat fungsi Anda.

    Create the Blob storage triggered function.

Selanjutnya, buat kontainer samples-workitems.

Membuat kontainer

  1. Di fungsi Anda, pada halaman Gambaran Umum, pilih grup sumber daya Anda.

    Select your Azure portal resource group.

  2. Temukan dan pilih akun penyimpanan grup sumber daya Anda.

    Access the storage account.

  3. Pilih Kontainer, lalu pilih + Kontainer.

    Add container to your storage account in the Azure portal.

  4. Di bidang Nama, ketik samples-workitems, lalu pilih Buat.

    Name the storage container.

Setelah Anda memiliki kontainer blob, Anda dapat menguji fungsi dengan mengunggah file ke kontainer.

Menguji fungsinya

  1. Kembali ke portal Microsoft Azure, telusuri fungsi Anda, perluas Log di bagian bawah halaman dan pastikan streaming log tidak dijeda.

    Expand the log in the Azure portal.

  2. Di jendela browser terpisah, buka grup sumber daya Anda di portal Azure, dan pilih akun penyimpanan.

  3. Pilih Kontainer, lalu pilih kontainer samples-workitems.

    Go to your samples-workitems container in the Azure portal.

  4. Pilih Unggah, lalu pilih ikon folder untuk memilih file yang akan diunggah.

    Upload a file to the blob container.

  5. Telusuri ke file di komputer lokal Anda, seperti file gambar, lalu pilih file tersebut. Pilih Buka lalu Unggah.

  6. Kembali ke log fungsi Anda dan verifikasi bahwa blob telah dibaca.

    View message in the logs.

    Catatan

    Ketika aplikasi fungsi Anda berjalan dalam paket Konsumsi default, mungkin ada keterlambatan hingga beberapa menit antara blob yang ditambahkan atau diperbarui dan fungsi yang dipicu. Jika Anda memerlukan latensi rendah dalam fungsi pemicu blob Anda, pertimbangkan untuk menjalankan aplikasi fungsi Anda dalam paket App Service.

Membersihkan sumber daya

Panduan mulai cepat yang lain dalam koleksi ini dibangun berdasarkan panduan mulai cepat ini. Jika Anda berencana untuk bekerja dengan mulai cepat berikutnya, tutorial, atau dengan salah satu layanan yang telah Anda buat dalam mulai cepat ini, jangan hapus sumber daya.

Di Azure, sumber daya merujuk ke aplikasi fungsi, fungsi, akun penyimpanan, dan sebagainya. Sumber daya tersebut dikelompokkan ke dalamgrup sumber daya, dan Anda dapat menghapus semuanya dalam grup dengan menghapus grup.

Anda telah membuat sumber daya untuk menyelesaikan mulai cepat ini. Anda akan ditagihkan untuk sumber daya ini, tergantung pada status akun dan harga layanan Anda. Jika Anda tidak memerlukan sumber daya lagi, berikut cara menghapusnya:

  1. Di portal Azure, buka halaman Gambaran Umum.

    Untuk masuk ke halaman itu dari halaman aplikasi fungsi, pilih tabGambaran Umum lalu pilih tautan di bawah Grup sumber daya.

    Screenshot that shows select the resource group to delete from the function app page.

    Untuk masuk ke halaman itu dari dasbor, pilih Grup sumber daya, lalu pilih grup sumber daya yang Anda gunakan untuk artikel ini.

  2. Di halamanGrup sumber daya, tinjau daftar sumber daya yang disertakan, dan pastikan bahwa sumber daya tersebut adalah sumber daya yang ingin Anda hapus.

  3. Pilih Hapus grup sumber daya, dan ikuti instruksinya.

    Penghapusan mungkin memakan waktu beberapa menit. Setelah selesai, pemberitahuan akan muncul selama beberapa detik. Anda juga dapat memilih ikon bel di bagian atas halaman untuk melihat pemberitahuan.

Langkah berikutnya

Anda telah membuat fungsi yang berjalan saat blob ditambahkan atau diperbarui dalam penyimpanan Blob. Untuk informasi selengkapnya tentang pemicu penyimpanan Blob, lihat Pengikatan penyimpanan Azure Functions Blob.

Setelah Anda membuat fungsi pertama, mari kita tambahkan pengikatan output ke fungsi yang menulis pesan ke antrean Storage.