Panduan mulai cepat: Membuat fungsi di Azure dengan Python menggunakan Visual Studio Code
Dalam artikel ini, Anda menggunakan Visual Studio Code untuk membuat fungsi Python yang merespons ke permintaan HTTP. Setelah menguji kode secara lokal, sebarkan kode ke lingkungan tanpa server Azure Functions.
Artikel ini menggunakan model pemrograman Python v2 untuk Azure Functions, yang menyediakan pendekatan berbasis dekorator untuk membuat fungsi. Untuk mempelajari selengkapnya tentang model pemrograman Python v2, lihat Panduan Referensi Pengembang
Menyelesaikan panduan mulai cepat ini dikenakan biaya kecil berupa beberapa sen USD atau kurang di akun Azure Anda.
Ada juga versi berbasis CLI dari artikel ini.
Video ini memperlihatkan kepada Anda cara membuat fungsi Python di Azure menggunakan Visual Studio Code.
Langkah-langkah dalam video juga dijelaskan di bagian berikut.
Mengkonfigurasikan lingkungan Anda
Sebelum memulai, pastikan Anda memiliki persyaratan berikut:
Akun Azure dengan langganan aktif. Buat akun secara gratis.
Versi Python yang didukung oleh Azure Functions. Untuk informasi selengkapnya, lihat Cara memasang Phyton.
Visual Studio Code di salah satu platform yang didukung.
Ekstensi Python untuk Visual Studio Code.
Ekstensi Azure Functions untuk Visual Studio Code, versi 1.8.1 atau yang lebih baru.
Emulator penyimpanan lokal ekstensi Azurite V3. Meskipun Anda juga dapat menggunakan akun penyimpanan Azure yang sebenarnya, artikel ini mengasumsikan Anda menggunakan emulator Azurite.
Menginstal atau memperbarui Core Tools
Ekstensi Azure Functions untuk Visual Studio Code terintegrasi dengan Azure Functions Core Tools sehingga Anda dapat menjalankan dan men-debug fungsi Anda secara lokal di Visual Studio Code menggunakan runtime Azure Functions. Sebelum memulai, ada baiknya menginstal Core Tools secara lokal atau memperbarui penginstalan yang ada untuk menggunakan versi terbaru.
Di Visual Studio Code, pilih F1 untuk membuka palet perintah, lalu cari dan jalankan perintah Azure Functions: Instal atau Perbarui Core Tools.
Perintah ini memulai penginstalan berbasis paket dari versi terbaru Core Tools.
Membuat proyek lokal Anda
Di bagian ini, gunakan Visual Studio Code untuk membuat proyek Azure Functions lokal dalam Python. Kemudian dalam artikel ini, Anda menerbitkan kode fungsi Anda ke Azure.
Pilih ikon Azure di bilah Aktivitas. Lalu di area Ruang Kerja (lokal), klik tombol +, pilih Buat Fungsi di dropdown. Saat diminta, pilih Buat proyek baru.
Pilih lokasi direktori untuk ruang kerja proyek Anda dan pilih Pilih. Anda harus membuat folder baru atau memilih folder kosong untuk ruang kerja proyek. Jangan memilih folder proyek yang sudah merupakan bagian dari sebuah ruang kerja.
Berikan informasi berikut pada permintaan:
Prompt Pilihan Pilih Bahasa Pilih Python (Programming Model V2).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 HTTP trigger.Nama fungsi yang ingin Anda buat Memasuki HttpExample.Tingkat otorisasi Pilih ANONYMOUS, yang memungkinkan siapa saja memanggil titik akhir fungsi Anda. Untuk informasi selengkapnya tentang tingkat otorisasi, lihat Kunci otorisasi.Pilih bagaimana Anda ingin membuka proyek Anda Pilih Open in current window.Visual Studio Code menggunakan informasi yang disediakan dan menghasilkan proyek Azure Functions dengan pemicu HTTP. Anda bisa melihat file proyek lokal di Explorer. File proyek yang dihasilkan
function_app.pyberisi fungsi Anda.
Buka file proyek local.settings.json dan verifikasi bahwa
AzureWebJobsFeatureFlagspengaturan memiliki nilaiEnableWorkerIndexing. Ini diperlukan agar Functions menginterpretasikan proyek Anda dengan benar sebagai model Python v2 saat berjalan secara lokal.Dalam file local.settings.json, perbarui
AzureWebJobsStoragepengaturan seperti dalam contoh berikut:"AzureWebJobsStorage": "UseDevelopmentStorage=true",Ini memberi tahu host Functions lokal untuk menggunakan emulator penyimpanan untuk koneksi penyimpanan yang saat ini diperlukan oleh model Python v2. Saat menerbitkan proyek ke Azure, Anda harus menggunakan akun penyimpanan default. Jika Anda menggunakan akun Azure Storage, atur akun penyimpanan Anda string koneksi di sini.
Memulai emulator
Di Visual Studio Code, tekan F1 untuk membuka palet perintah. Di palet perintah, cari dan pilih
Azurite: Start.Periksa bilah bawah dan verifikasi bahwa layanan emulasi Azurite berjalan. Jika demikian, Anda sekarang dapat menjalankan fungsi Anda secara lokal. ::: ujung zona
Jalankan fungsi secara lokal
Visual Studio Code terintegrasi dengan alat Azure Functions Core untuk memungkinkan Anda menjalankan proyek ini di komputer pengembangan lokal sebelum Anda menerbitkan ke Azure.
Untuk memulai fungsi secara lokal, tekan F5 atau ikon Jalankan dan Debug di bilah Aktivitas sisi kiri. Panel Terminal menampilkan Output dari Core Tools. Aplikasi Anda dimulai di panel Terminal. Anda dapat melihat titik akhir URL dari fungsi yang dipicu HTTP berjalan secara lokal.
Jika Anda mengalami masalah saat menjalankan fungsi di Windows, pastikan bahwa terminal default untuk Visual Studio Code tidak diatur ke WSL Bash.
Dengan Core Tools yang masih berjalan di Terminal, pilih ikon Azure di bilah aktivitas. Di area Ruang Kerja, luaskan Proyek Lokal>Functions. Klik kanan (Windows) atau Ctrl - klik (macOS) fungsi baru dan pilih Jalankan Fungsi Sekarang....
Di Masukkan isi permintaan Anda melihat nilai isi pesan permintaan
{ "name": "Azure" }. Tekan Masukkan untuk mengirim pesan permintaan ini ke fungsi Anda.Saat fungsi dijalankan secara lokal dan mengembalikan respons, pemberitahuan akan dimunculkan dalam Visual Studio Code. Informasi tentang eksekusi fungsi ditampilkan di panel Terminal.
Dengan panel Terminal terfokus, tekan Ctrl + C untuk menghentikan Core Tools dan memutuskan sambungan debugger.
Setelah Anda memverifikasi bahwa fungsi berjalan dengan benar di komputer lokal Anda, saatnya untuk menggunakan Visual Studio Code untuk menerbitkan proyek langsung ke Azure.
Masuk ke Azure
Sebelum dapat membuat sumber daya Azure atau menerbitkan aplikasi, Anda harus masuk ke Azure.
Jika Anda belum masuk, pilih ikon Azure di bilah Aktivitas. Lalu, di area Sumber Daya, pilih Masuk ke Azure...
Jika sudah masuk dan dapat melihat langganan Anda yang ada, buka bagian berikutnya. Jika Anda belum memiliki akun Azure, pilih Buat Akun Azure.... Siswa dapat memilih Buat Akun Azure for Students....
Saat diminta di browser, pilih akun Azure Anda dan masuk menggunakan kredensial akun Azure Anda. Jika membuat akun baru, Anda dapat masuk setelah akun berhasil dibuat.
Setelah berhasil masuk, Anda dapat menutup jendela browser baru. Langganan dalam akun Azure Anda ditampilkan di bilah sisi.
Membuat aplikasi fungsi di Azure
Di bagian ini, Anda membuat aplikasi fungsi dan sumber daya terkait di langganan Azure Anda.
Pilih ikon Azure di bilah Aktivitas. Lalu, di area Sumber Daya, pilih ikon + dan pilih opsi Buat Aplikasi Fungsi di Azure.
Berikan informasi berikut pada permintaan:
Prompt Pilihan Pilih langganan Pilih langganan yang akan digunakan. Anda tidak akan melihat permintaan ini jika Anda hanya memiliki satu langganan yang terlihat di bawah Sumber Daya. Masukkan nama unik global untuk aplikasi fungsi Ketik nama yang valid di jalur URL. Nama yang Anda ketik akan divalidasi untuk memastikan bahwa nama tersebut bersifat unik di Azure Functions. Pilih tumpukan runtime Pilih versi bahasa pemrogram yang telah Anda jalankan secara lokal. Pilih lokasi untuk sumber daya baru Pilih wilayah yang lebih dekat dengan Anda untuk kinerja yang lebih baik. Ekstensi tersebut menampilkan status sumber daya individual saat dibuat di Azure pada panel Azure: Log Aktivitas.
Setelah pembuatan selesai, sumber daya Azure berikut dibuat di langganan Anda. Sumber daya dinamai berdasarkan nama aplikasi fungsi Anda:
- Grup sumber daya, yang merupakan kontainer logis untuk sumber daya terkait.
- Akun Azure Storage standar, memelihara status dan informasi lain tentang proyek Anda.
- Aplikasi fungsi, menyediakan lingkungan untuk menjalankan kode fungsi Anda. Aplikasi fungsi memungkinkan Anda mengelompokkan fungsi sebagai unit logis untuk memudahkan pengelolaan, penerapan, dan berbagi sumber daya dalam paket hosting yang sama.
- Paket App Service, menentukan host yang mendasari aplikasi fungsi Anda.
- Instans Application Insights tersambung ke aplikasi fungsi, yang melacak penggunaan fungsi Anda di aplikasi.
Notifikasi ditampilkan setelah aplikasi fungsi Anda dibuat dan paket penyebaran diterapkan.
Tip
Secara default, sumber daya Azure yang diperlukan oleh aplikasi fungsi Anda dibuat berdasarkan nama aplikasi fungsi yang Anda berikan. Secara default, sumber daya ini juga dibuat di grup sumber daya baru yang sama dengan aplikasi fungsi. Jika ingin menyesuaikan nama sumber daya ini atau menggunakan kembali sumber daya yang ada, Anda perlu menerbitkan proyek dengan opsi pembuatan lanjutan.
Menyebarkan proyek ke Azure
Penting
Penyebaran ke aplikasi fungsi yang ada selalu menimpa konten aplikasi tersebut di Azure.
Di area Sumber Daya aktivitas Azure, temukan sumber daya aplikasi fungsi yang baru saja Anda buat, klik kanan sumber daya, dan pilih Sebarkan ke aplikasi fungsi....
Saat diminta untuk menimpa penyebaran sebelumnya, pilih Sebarkan untuk menyebarkan kode fungsi Anda ke sumber daya aplikasi fungsi baru.
Setelah penyebaran selesai, pilih Tampilkan Output untuk melihat hasil pembuatan dan penyebaran, termasuk sumber daya Azure yang Anda buat. Jika melewatkan pemberitahuan, pilih ikon bel di sudut kanan bawah untuk melihatnya lagi.
Menjalankan fungsi di Azure
Kembali di bagian Sumber Daya di bilah samping, perluas langganan, aplikasi fungsi baru, dan Functions Anda. Klik kanan (Windows) atau Ctrl - klik (macOS) fungsi
HttpExampledan pilih Jalankan Fungsi Sekarang....
Di Masukkan isi permintaan Anda melihat nilai isi pesan permintaan
{ "name": "Azure" }. Tekan Masukkan untuk mengirim pesan permintaan ini ke fungsi Anda.Saat fungsi dijalankan di Azure dan mengembalikan respons, pemberitahuan akan dimunculkan dalam Visual Studio Code.
Membersihkan sumber daya
Saat melanjutkan ke langkah berikutnya dan menambahkan antrean Azure Storage yang mengikat ke fungsi, Anda harus menyimpan semua sumber daya untuk membangun apa yang telah Anda lakukan.
Jika tidak, Anda dapat menggunakan langkah-langkah berikut untuk menghapus aplikasi fungsi dan sumber daya terkait untuk menghindari timbulnya biaya lebih lanjut.
Di Visual Studio Code, tekan F1 untuk membuka palet perintah. Di palet perintah, cari dan pilih
Azure: Open in portal.Pilih aplikasi fungsi Anda dan tekan Enter. Halaman aplikasi fungsi terbuka di portal Azure.
Di tab Ringkasan, pilih tautan bernama di samping Grup sumber daya.
Di halaman Grup sumber daya, tinjau daftar sumber daya yang disertakan, dan pastikan sumber daya tersebut adalah sumber daya yang ingin Anda hapus.
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.
Untuk informasi selengkapnya tentang biaya Azure Functions, lihat Memperkirakan biaya rencana Konsumsi.
Langkah berikutnya
Anda membuat dan menyebarkan aplikasi fungsi dengan fungsi sederhana yang dipicu HTTP. Di artikel berikutnya, Anda memperluas fungsi tersebut dengan menyambungkan ke layanan penyimpanan di Azure. Untuk mempelajari selengkapnya tentang menyambungkan ke layanan Azure lainnya, lihat Menambahkan pengikatan ke fungsi yang sudah ada di Azure Functions.