Panduan mulai cepat: Membuat fungsi di Azure dengan Python menggunakan Visual Studio Code

  • Artikel
  • 6 menit untuk membaca

Dalam artikel ini, Anda menggunakan Visual Studio Code untuk membuat fungsi Python yang merespons ke permintaan HTTP. Setelah menguji kode secara lokal, Anda menyebarkannya ke lingkungan tanpa server Azure Functions.

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

Ada juga versi berbasis CLI dari artikel ini.

Konfigurasikan lingkungan Anda

Sebelum memulai, pastikan Anda memiliki persyaratan berikut:

Membuat proyek lokal Anda

Di bagian ini, gunakan Visual Studio Code untuk membuat proyek Azure Functions lokal dalam Python. Nantinya di artikel ini, Anda akan menerbitkan kode fungsi ke Azure.

  1. 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.

    Screenshot of create a new project window.

  2. Pilih lokasi direktori untuk ruang kerja proyek Anda dan klik Pilih. Anda harus membuat folder baru atau memilih folder kosong untuk ruang kerja proyek. Jangan memilih folder proyek yang merupakan bagian dari ruang kerja.

  3. Berikan informasi berikut saat diminta:

    Perintah Pilihan
    Pilih bahasa Pilih Python.
    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.
    Menyediakan nama fungsi Masukkan 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 Add to workspace.

  4. Visual Studio Code menggunakan informasi yang disediakan dan menghasilkan proyek Azure Functions dengan pemicu HTTP. Anda bisa melihat file proyek lokal di Explorer. Untuk informasi selengkapnya tentang file yang dibuat, lihat File proyek yang dihasilkan.

Menjalankan 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.

  1. Untuk memulai fungsi secara lokal, tekan F5 atau ikon putar. 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.

    Screenshot of the Local function VS Code output.

    Jika Anda mengalami masalah saat menjalankan fungsi di Windows, pastikan bahwa terminal default untuk Visual Studio Code tidak diatur ke WSL Bash.

  2. Dengan Core Tools yang masih berjalan di Terminal, pilih ikon Azure di bilah aktivitas. Di area Ruang Kerja, perluas Proyek Lokal>Functions. Klik kanan (Windows) atau Ctrl -klik (macOS) fungsi HttpExample dan pilih Jalankan Fungsi Sekarang... .

    Execute function now from Visual Studio Code

  3. Di Masukkan isi permintaan Anda akan melihat nilai isi pesan permintaan, yaitu { "name": "Azure" }. Tekan Enter untuk mengirim pesan permintaan ini ke fungsi Anda.

  4. Saat fungsi dijalankan secara lokal dan mengembalikan respons, pemberitahuan akan dimunculkan dalam Visual Studio Code. Informasi tentang eksekusi fungsi ditampilkan di panel Terminal.

  5. Dengan panel Terminal terfokus, tekan Ctrl + C untuk menghentikan Core Tools dan memutuskan sambungan debugger.

Setelah memverifikasi bahwa fungsinya berjalan dengan benar di komputer lokal Anda, saatnya menggunakan Visual Studio Code untuk menerbitkan proyek langsung ke Azure.

Masuk ke Azure

Sebelum dapat memublikasikan aplikasi, Anda harus masuk ke Azure.

  1. Jika Anda belum masuk, pilih ikon Azure di bilah Aktivitas. Lalu di area Sumber Daya, pilih Masuk ke Azure....

    Screenshot of the sign-in to Azure window within VS Code.

    Jika Anda sudah masuk dan dapat melihat langganan yang ada, lanjut ke bagian berikutnya. Jika Anda belum memiliki akun Azure, pilih Buat Akun Azure.... Siswa dapat memilih Buat Akun Azure untuk Siswa....

  2. Saat diminta di browser, pilih akun Azure Anda dan masuk menggunakan kredensial akun Azure Anda. Jika membuat akun baru, Anda dapat masuk setelah akun dibuat.

  3. Setelah berhasil masuk, Anda dapat menutup jendela browser baru. Langganan milik 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.

  1. Pilih ikon Azure di bilah Aktivitas. Lalu di area Sumber Daya, klik ikon + dan pilih opsi Buat Aplikasi Fungsi di Azure.

    Create a resource in your Azure subscription

  2. Berikan informasi berikut saat diminta:

    Perintah Pilihan
    Pilih langganan Pilih langganan yang akan digunakan. Anda tidak akan melihat perintah ini jika Anda hanya memiliki satu langganan yang terlihat di 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 unik di Azure Functions.
    Pilih tumpukan runtime Pilih versi bahasa yang Anda jalankan secara lokal.
    Pilih lokasi untuk sumber daya baru Pilih wilayah yang lebih dekat dengan Anda untuk kinerja yang lebih baik.

    Ekstensi ini menampilkan status sumber daya individual saat dibuat di Azure di panel Azure: Log Aktivitas.

    Log of Azure resource creation

  3. Setelah pembuatan selesai, sumber daya Azure berikut ini dibuat di langganan Anda. Sumber daya diberi nama berdasarkan nama aplikasi fungsi Anda:

    • Grup sumber daya, merupakan kontainer logis untuk sumber daya terkait.
    • Akun Azure Storage standar, memelihara status dan informasi lain tentang proyek Anda.
    • Aplikasi fungsi, yang 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 Azure App Service, yang menentukan host yang mendasari untuk aplikasi fungsi Anda.
    • Instans Application Insights terhubung 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 Anda ingin mengkustomisasi nama sumber daya ini atau menggunakan kembali sumber daya yang ada, Anda perlu menerbitkan proyek dengan opsi buat tingkat lanjut.

Menyebarkan proyek ke Azure

Penting

Menyebarkan ke aplikasi fungsi yang sudah ada akan selalu menimpa konten aplikasi tersebut di Azure.

  1. Pilih ikon Azure di bilah Aktivitas, lalu di area Ruang Kerja, pilih folder proyek Anda dan pilih tombol Sebarkan....

    Deploy project from the Visual Studio Code workspace

  2. Setelah penyebaran selesai, pilih Tampilkan Output untuk menampilkan hasil pembuatan dan penyebaran, termasuk sumber daya Azure yang Anda buat. Jika melewatkan pemberitahuan, pilih ikon bel di sudut kanan bawah untuk melihatnya lagi.

    Screenshot of the View Output window.

Menjalankan fungsi di Azure

  1. Kembali di area Sumber Daya di bilah sisi, perluas langganan, aplikasi fungsi baru, dan Functions Anda. Klik kanan (Windows) atau Ctrl -klik (macOS) fungsi HttpExample dan pilih Jalankan Fungsi Sekarang... .

    Screenshot of executing function in Azure from Visual Studio Code.

  2. Di Masukkan isi permintaan Anda akan melihat nilai isi pesan permintaan, yaitu { "name": "Azure" }. Tekan Enter untuk mengirim pesan permintaan ini ke fungsi Anda.

  3. Saat fungsi dijalankan di Azure dan mengembalikan respons, pemberitahuan akan dimunculkan dalam Visual Studio Code.

Menghapus 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.

  1. Di Visual Studio Code, tekan F1 untuk membuka palet perintah. Di palet perintah, cari dan pilih Azure: Open in portal.

  2. Pilih aplikasi fungsi Anda dan tekan Enter. Halaman aplikasi fungsi terbuka di portal Azure.

  3. Di tab Ringkasan, pilih tautan bernama di samping Grup sumber daya.

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

  4. Di halaman Grup sumber daya, tinjau daftar sumber daya yang disertakan, dan verifikasi bahwa sumber daya tersebut adalah sumber daya yang ingin Anda hapus.

  5. Di halaman Grup sumber daya, tinjau daftar sumber daya yang disertakan, dan verifikasi bahwa sumber daya tersebut adalah sumber daya yang ingin Anda hapus.

  6. 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 telah menggunakan Visual Studio Code untuk membuat aplikasi fungsi dengan fungsi sederhana yang dipicu HTTP. Di artikel berikutnya, Anda memperluas fungsi tersebut dengan menyambungkan ke Azure Storage. Untuk mempelajari selengkapnya tentang menyambungkan ke layanan Azure lainnya, lihat Menambahkan pengikatan ke fungsi yang sudah ada di Azure Functions.

Menghubungkan ke antrean Azure Storage

Mengalami masalah? Beri tahu kami.