Mengembangkan Azure Functions secara lokal dengan menggunakan CLI Azure Functions (pratinjau)

Azure Functions CLI adalah versi mayor berikutnya (v5) dari runtime pengembangan lokal dan alat bantu untuk Azure Functions. Versi func.exe ini menampilkan arsitektur berbasis beban kerja, sehingga Anda hanya mengunduh apa yang Anda butuhkan untuk tumpukan yang Anda kembangkan.

Important

Azure Functions CLI (v5) saat ini dalam pratinjau. Versi pratinjau ini belum mendukung Java dan PowerShell. Untuk bekerja dengan bahasa yang saat ini tidak didukung, terus gunakan Azure Functions Core Tools v4.

Ada dua alat baris perintah yang disertakan sebagai func.exe untuk Azure Functions:

Azure Functions Core Tools Azure Functions CLI
versi func.exe v4 v5
Tingkat dukungan Ketersediaan umum (GA) Tinjauan
Ukuran instalasi Biner lengkap yang mencakup semua perintah dan kemampuan untuk semua bahasa asli. Penginstalan dasar kecil, ditambah beban kerja per bahasa dan fitur lain yang Anda tambahkan sesuai kebutuhan. Host didistribusikan sebagai workload tersendiri, sehingga Anda bisa mendapatkan versi host terbaru tanpa mengunduh ulang CLI.
Gunakan saat... Anda memerlukan dukungan GA penuh untuk semua alur kerja pengembangan. Anda menginginkan pengalaman berbasis beban kerja yang ringan dengan fitur baru seperti templat mulai cepat dan profil yang menjaga lingkungan lokal Anda tetap sinkron dengan konfigurasi paket hosting Azure Anda.

Untuk referensi perintah, lihat referensi CLI Azure Functions.

Contoh saat ini tidak tersedia karena tidak adanya dukungan stack bahasa.

Instal Azure Functions CLI

CLI Azure Functions didistribusikan sebagai instalasi dasar kecil ditambah beban kerja yang Anda tambahkan untuk tumpukan yang Anda kembangkan. Setelah instalasi, berkas biner func ada di PATH.

Note

Metode penginstalan mungkin berubah antara pratinjau dan rilis umum.

iex "& { $(irm https://aka.ms/func-cli/install.ps1) } -Prerelease"

Jika Anda memutakhirkan dari penginstalan sebelumnya, tambahkan -Force (PowerShell) atau --force (Bash) ke perintah .

Verifikasi penginstalan:

func --version

Setelah Anda menginstal CLI dasar, instal workload untuk stack Anda. Cara tercepat adalah func setup, yang menginstal host, pekerja bahasa, bundel ekstensi (jika diperlukan), beban kerja tumpukan, dan beban kerja templat dalam satu langkah.

Contohnya:

func setup --features dotnet

func setup --features node

func setup --features python

func setup --features go

Anda juga dapat menginstal beban kerja satu per satu dengan menggunakan func workload install. Bagaimanapun, pertama kali Anda menjalankan func init, , func newatau func run tanpa beban kerja yang diperlukan diinstal, CLI meminta Anda untuk menginstalnya.

Workloads

CLI Azure Functions menggunakan model workload. Instalasi dasar func berukuran kecil dan tidak bergantung pada bahasa. Anda menginstal workload sesuai kebutuhan untuk mendapatkan alat khusus untuk stack tertentu, host Functions, pekerja bahasa, bundel ekstensi, dan templat.

Beban kerja termasuk dalam kategori ini:

  • Host: Runtime host Azure Functions yang digunakan oleh func run.
  • Bundles: Artefak bundel ekstensi siap pakai agar pemicu dan binding langsung berfungsi (diperlukan untuk stack non-.NET).
  • Stack: Perkakas proyek khusus bahasa (misalnya, python, node, dotnet).
  • Pekerja: Pekerja bahasa yang digunakan host pada waktu proses (misalnya, python-worker, node-worker).
  • Templat: Templat fungsi muncul oleh func new (misalnya, python-templates, node-templates).

Untuk daftar lengkap beban kerja yang tersedia dan deskripsinya, lihat Beban kerja yang tersedia dalam referensi CLI.

Pengalaman penggunaan pertama

Pertama kali Anda menjalankan func init, , func newatau func run, CLI memeriksa apakah beban kerja yang diperlukan untuk skenario Anda diinstal. Jika tidak, CLI meminta Anda untuk menginstalnya. Menerima prompt tersebut akan menginstal kumpulan yang direkomendasikan untuk stack yang Anda pilih. Anda dapat menolak perintah dan menginstal beban kerja secara manual dengan menggunakan func workload install, atau menjalankan func setup untuk memprovisikan set standar secara non-interaktif.

Pembaruan beban kerja

Jalankan func workload search secara berkala untuk memeriksa beban kerja yang baru tersedia. Lanjutkan menggunakan Core Tools (v4) untuk tumpukan yang tidak didukung atau saat Anda memerlukan fitur GA tertentu dari Core Tools.

Membuat proyek lokal

Untuk membuat proyek Functions baru, gunakan func init perintah .

func init MyProjFolder --stack dotnet

func init MyProjFolder --stack node --language javascript

func init MyProjFolder --stack node --language typescript

func init MyProjFolder --stack python

func init MyProjFolder --stack go

Opsi --stack menentukan tumpukan bahasa mana yang akan digunakan. Workload yang diinstal untuk stack tersebut menyediakan kerangka.

Membuat fungsi

Untuk menambahkan fungsi dari templat, gunakan func new perintah .

func new --template "HTTP trigger" --name MyHttpTrigger

Jalankan fungsi secara lokal

Untuk memulai host Functions dan menjalankan proyek Anda, gunakan func run:

func run

func start dipertahankan sebagai alias yang kompatibel dengan versi sebelumnya. Host secara otomatis mengelola Azurite (emulator penyimpanan lokal) kecuali jika Anda meneruskan --no-azurite.

Perancah dari templat mulai cepat

Untuk menelusuri dan membuat kerangka contoh aplikasi lengkap (API HTTP, pekerja antrean, orkestrasi Durable Functions), gunakan func quickstart:

func quickstart --stack dotnet --resource http

func quickstart --stack node --resource http

func quickstart --stack python --resource http

func quickstart --stack go --resource http

Mengelola beban kerja

Gunakan func workload untuk menginstal, memperbarui, dan menghapus beban kerja. Untuk daftar lengkap sub-perintah dan opsi, lihat func workload di referensi CLI.

Profiles

Profil mengodekan batasan versi untuk host, bundel ekstensi, dan pekerja. Terapkan profil saat runtime dengan menggunakan func run --profile <name>. Untuk daftar lengkap sub-perintah dan opsi, lihat func profile di referensi CLI.

Konten terkait

  • Last updated on