Mulai Cepat: Membuat fungsi C# pertama Anda di Azure menggunakan Visual Studio

  • Artikel
  • 9 menit untuk membaca

Azure Functions memungkinkan Anda menggunakan Visual Studio untuk membuat proyek fungsi C# lokal dan kemudian dengan mudah menerbitkan proyek ini untuk berjalan di lingkungan tanpa server yang dapat diskalakan di Azure. Jika lebih suka mengembangkan aplikasi C# secara lokal menggunakan Visual Studio Code, Anda harus mempertimbangkan versi berbasis Visual Studio Code artikel ini.

Secara default, artikel ini menunjukkan kepada Anda cara membuat fungsi C# yang berjalan di .NET 6 dalam proses yang sama dengan host Functions. Fungsi C# dalam proses ini hanya didukung pada versi Dukungan Jangka Panjang (LTS) .NET, seperti .NET 6. Untuk membuat fungsi C# di .NET 6 yang juga dapat berjalan di .NET 5.0 dan .NET Framework 4.8 (dalam pratinjau) dalam proses yang terisolasi, lihat versi alternatif artikel ini.

Dalam artikel ini, Anda akan mempelajari cara:

  • Gunakan Visual Studio untuk membuat proyek pustaka kelas C # di .NET 6.0.
  • Membuat sebuah fungsi yang merespon ke permintaan HTTP.
  • Menjalankan kode Anda secara lokal untuk memverifikasi perilaku fungsi.
  • Menyebarkan proyek kode Anda ke Azure Functions.

Menyelesaikan mulai cepat ini dikenakan biaya kecil berupa beberapa sen USD atau kurang di akun Azure Anda.

Prasyarat

Membuat proyek aplikasi fungsi

Templat proyek Azure Functions di Visual Studio membuat proyek pustaka kelas C# yang bisa Anda terbitkan ke aplikasi fungsi di Azure. Aplikasi fungsi memungkinkan Anda mengelompokkan fungsi sebagai unit logis untuk pengelolaan, penyebaran, penskalaan, dan berbagi sumber daya dengan lebih mudah.

  1. Dari menu Visual Studio, pilih File>Baru>Proyek.

  2. Di Buat proyek baru, masukkan fungsi di kotak pencarian, pilih templat Azure Functions, lalu pilih Berikutnya.

  3. Di Konfigurasikan proyek baru Anda, masukkan Nama proyek untuk proyek, lalu pilih Buat. Nama aplikasi fungsi harus valid sebagai namespace layanan C#, jadi jangan gunakan garis bawah, tanda hubung, atau karakter non-alfanumerik lainnya.

  4. Untuk setelan Informasi tambahan, gunakan nilai dalam tabel berikut:

    Pengaturan Nilai Deskripsi
    Pekerja fungsi .NET 6 Saat memilih .NET 6, Anda membuat proyek yang berjalan dalam proses dengan runtime Azure Functions. Gunakan dalam proses kecuali Anda perlu menjalankan aplikasi fungsi Anda di .NET 5.0 atau di .NET Framework 4.8 (pratinjau). Untuk mempelajari selengkapnya, lihat Versi yang didukung.
    Fungsi Pemicu HTTP Nilai ini membuat fungsi yang dipicu oleh permintaan HTTP.
    Gunakan Azurite untuk akun penyimpanan runtime bahasa umum (AzureWebJobsStorage) Aktifkan Karena aplikasi fungsi di Azure memerlukan akun penyimpanan, aplikasi ditetapkan atau dibuat saat Anda memublikasikan proyek Anda ke Azure. Pemicu HTTP tidak menggunakan string koneksi akun Azure Storage; semua jenis pemicu lainnya memerlukan string koneksi akun Azure Storage yang valid. Ketika Anda memilih opsi ini, emulator Azurite digunakan.
    Tingkat otorisasi Anonim Fungsi yang dibuat dapat dipicu oleh klien mana pun tanpa menyediakan kunci. Pengaturan otorisasi ini memudahkan Anda menguji fungsi baru Anda. Untuk informasi selengkapnya tentang kunci dan otorisasi, lihat Kunci otorisasi dan pengikatan HTTP dan webhook.

    Screenshot of Azure Functions project settings.

    Pastikan Anda mengatur Tingkat otorisasi ke Anonim. Ketika Anda memilih tingkat default Fungsi, Anda diharuskan untuk memberikan kunci fungsi dalam permintaan untuk mengakses titik akhir fungsi Anda.

  5. Pilih Buat untuk membuat proyek fungsi dan fungsi pemicu HTTP.

Visual Studio membuat proyek dan kelas yang berisi kode boilerplate untuk jenis fungsi pemicu HTTP. Kode boilerplate mengirimkan respons HTTP yang menyertakan nilai dari isi permintaan atau untai (karakter) kueri. AtributHttpTrigger menentukan bahwa fungsi dipicu oleh permintaan HTTP.

Mengganti nama fungsi

Atribut metodeFunctionNamemenetapkan nama fungsi, yang secara default dinamaiFunction1. Karena alat tidak memungkinkan Anda mengganti nama fungsi default saat membuat proyek, luangkan waktu untuk membuat nama yang lebih baik untuk kelas fungsi, file, dan metadata.

  1. DiFile Explorer, klik kanan file Function1.cs dan ganti namanya menjadi HttpExample.cs.

  2. Dalam kode, ganti nama kelas Function1 menjadi HttpExample.

  3. Dalam metodeHttpTriggerbernamaRun, ganti nama atribut metode FunctionNamekeHttpExample.

Definisi metode fungsi sekarang akan terlihat seperti berikut ini:

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log)

Sekarang setelah mengganti nama fungsi, Anda dapat mengujinya di komputer lokal Anda.

Menjalankan fungsi secara lokal

Visual Studio terintegrasi dengan Azure Functions Core Tools sehingga Anda dapat menguji fungsi Anda secara lokal menggunakan runtime Azure Functions yang lengkap.

  1. Untuk menjalankan fungsi Anda, tekan F5 di Visual Studio. Anda mungkin perlu mengaktifkan pengecualian firewall sehingga alat dapat menangani permintaan HTTP. Tingkat otorisasi tidak pernah diberlakukan saat Anda menjalankan fungsi secara lokal.

  2. Salin URL fungsi Anda dari output runtime bahasa umum Azure Functions.

    Azure local runtime

  3. Tempelkan URL untuk permintaan HTTP ke bar alamat browser Anda. Tambahkan string kueri ?name=<YOUR_NAME> ke URL ini dan jalankan permintaan. Gambar berikut menampilkan respons di browser ke permintaan GET lokal yang dikembalikan oleh fungsi:

    Function localhost response in the browser

  4. Untuk menghentikan penelusuran kesalahan, tekan Shift+F5 di Visual Studio.

Setelah memverifikasi bahwa fungsinya berjalan dengan benar di komputer lokal Anda, saatnya untuk menerbitkan proyek ke Azure.

Menerbitkan proyek ke Azure

Visual Studio dapat menerbitkan proyek lokal Anda ke Azure. Anda harus memiliki aplikasi fungsi di langganan Azure Anda sebelum dapat menerbitkan proyek. Jika Anda belum memiliki aplikasi fungsi di Azure, penerbitan Visual Studio akan membuatnya untuk Anda saat pertama kali menerbitkan proyek. Di artikel ini, Anda membuat aplikasi fungsi dan sumber daya Azure terkait.

  1. Di Penjelajah Solusi, klik kanan proyek dan pilih Terbitkan. Di Target, pilih Azure lalu Berikutnya.

    Screenshot of publish window.

  2. Pilih Aplikasi Azure Function (Windows) untuk Target tertentu, untuk membuat aplikasi fungsi yang berjalan pada Windows, lalu pilih Berikutnya.

    Screenshot of publish window with specific target.

  3. Pada Instans Fungsi, pilih Buat Fungsi Azure baru...

    Screenshot of create a new function app instance.

  4. Buat instans baru menggunakan nilai yang ditentukan dalam tabel berikut:

    Pengaturan Nilai Deskripsi
    Nama Nama unik global Nama yang mengidentifikasi secara unik aplikasi fungsi baru Anda. Terima nama ini atau masukkan nama baru. Karakter yang valid adalah: a-z, 0-9, dan -.
    Langganan Langganan Anda Langganan Azure yang akan digunakan. Terima langganan ini atau pilih yang baru dari daftar menurun.
    Grup sumber daya Nama grup sumber daya Anda Grup sumber daya untuk membuat aplikasi fungsi Anda. Pilih grup sumber daya yang sudah ada dari daftar menurun atau pilih Baru untuk membuat grup sumber daya baru.
    Jenis Paket Consumption Saat Anda menerbitkan proyek Anda ke aplikasi fungsi yang berjalan dalam Paket konsumsi, Anda hanya membayar untuk menjalankan aplikasi fungsi Anda. Paket hosting lain dikenakan biaya yang lebih tinggi.
    Lokasi Lokasi app service Pilih Lokasi pada wilayah di dekat Anda atau layanan lain yang diakses fungsi Anda.
    Azure Storage Akun penyimpanan serba guna Akun Azure Storage diperlukan oleh runtime Fungsi. Pilih Baru untuk mengonfigurasi akun penyimpanan serba guna. Anda juga dapat memilih akun yang ada yang memenuhi persyaratan akun penyimpanan.

    Screenshot of Create App Service dialog.

  5. Pilih Buat untuk membuat aplikasi fungsi dan sumber daya terkait di Azure. Status pembuatan sumber daya ditampilkan di kiri bawah jendela.

  6. Dalam Instans fungsi, pastikan bahwa Jalankan dari file paket telah dicentang. Aplikasi fungsi Anda disebarkan menggunakan Zip Deploy dengan mode Run-From-Package diaktifkan. Penyebaran Zip adalah metode penyebaran yang direkomendasikan untuk proyek fungsi Anda karena menghasilkan performa yang lebih baik.

    Screenshot of Finish profile creation.

  7. Pilih Selesai, dan pada halaman Terbitan, pilih Terbitkan untuk menyebarkan paket yang berisi file proyek Anda ke aplikasi fungsi baru di Azure.

    Setelah penyebaran selesai, URL akar aplikasi fungsi di Azure diperlihatkan di tab Terbitkan.

  8. Di tab Terbitkan, di bagian Hosting, pilih Buka di portal Azure. Ini membuka sumber daya aplikasi fungsi baru Azure di portal Azure.

    Screenshot of Publish success message.

Verifikasi fungsi Anda di Azure

  1. Di Cloud Explorer, aplikasi fungsi baru Anda harus dipilih. Jika tidak, perluas >App Services langganan Anda, dan pilih aplikasi fungsi baru Anda.

  2. Klik kanan aplikasi fungsi dan pilih Buka di Browser. Langkah ini akan membuka root aplikasi fungsi Anda di browser web default Anda dan menampilkan halaman yang menunjukkan bahwa aplikasi fungsi Anda sedang berjalan.

    Function app running

  3. Di bilah alamat di browser, tambahkan untai (karakter) /api/HttpExample?name=Functions ke kolom URL dan jalankan permintaan.

    URL yang memanggil fungsi pemicu HTTP Anda berada dalam format berikut:

    http://<APP_NAME>.azurewebsites.net/api/HttpExample?name=Functions

  4. Buka URL ini dan lihat respons di browser ke permintaan GET jarak jauh yang dikembalikan oleh fungsi, yang terlihat seperti contoh berikut:

    Function response in the browser

Membersihkan 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 membuat sumber daya Azure untuk menyelesaikan mulai cepat ini. Anda akan ditagihkan untuk sumber daya ini, tergantung pada status akun dan harga layanan Anda. 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.

Gunakan langkah-langkah berikut untuk menghapus aplikasi fungsi dan sumber daya terkait untuk menghindari timbulnya biaya lebih lanjut.

  1. Dalam dialog Visual Studio Publish, di bagian Hosting, pilih Buka di portal Azure.

  2. Di halaman aplikasi fungsi, pilih tabGambaran Umumlalu pilih tautan di bawahGrup sumber daya.

    Select the resource group to delete from the function app page

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

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

    Penghapusan mungkin perlu 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

Dalam mulai cepat ini, gunakan Visual Studio untuk membuat dan menerbitkan aplikasi fungsi C# di Azure dengan fungsi pemicu HTTP sederhana.

Untuk mempelajari selengkapnya tentang bekerja dengan fungsi C# yang berjalan dalam proses dengan host Functions, lihat Mengembangkan fungsi pustaka kelas C# menggunakan Azure Functions.

Lanjutkan ke artikel berikutnya untuk mempelajari cara menambahkan pengikatan antrean Azure Storage ke fungsi Anda:

Menambahkan pengikatan antrean Azure Storage ke fungsi Anda