Referensi Azure Functions Core Tools

Artikel
08/20/2023

Artikel ini menyediakan dokumentasi referensi untuk Azure Functions Core Tools, yang memungkinkan Anda mengembangkan, mengelola, dan menyebarkan proyek Azure Functions dari komputer lokal Anda. Untuk informasi selengkapnya tentang Azure Functions Core Tools, lihat Bekerja dengan Azure Functions Core Tools.

Perintah Core Tools diatur ke dalam konteks berikut, masing-masing memberikan serangkaian tindakan yang unik.

Konteks perintah	Deskripsi
`func`	Perintah yang digunakan untuk membuat dan menjalankan fungsi di komputer lokal Anda.
`func azure`	Perintah untuk bekerja dengan sumber daya Azure, termasuk penerbitan.
`func azurecontainerapps`	Sebarkan aplikasi fungsi dalam kontainer ke Azure Container Apps.
`func durable`	Perintah untuk bekerja dengan Durable Functions.
`func extensions`	Perintah untuk menginstal dan mengelola ekstensi.
`func kubernetes`	Perintah untuk bekerja dengan Kubernetes dan Azure Functions.
`func settings`	Perintah untuk mengelola pengaturan lingkungan untuk host Functions lokal.
`func templates`	Perintah untuk mencantumkan templat fungsi yang tersedia.

Sebelum menggunakan perintah dalam artikel ini, Anda harus menginstal Core Tools.

func init

Membuat proyek Fungsi baru dalam bahasa tertentu.

func init <PROJECT_FOLDER>

Saat Anda memasok <PROJECT_FOLDER>, proyek dibuat dalam folder baru dengan nama ini. Jika tidak, folder saat ini yang digunakan.

func init mendukung opsi berikut, yang tidak mendukung versi 1.x kecuali dinyatakan lain:

Opsi	Deskripsi
`--csx`	Membuat fungsi .NET seperti skrip C#, yang merupakan perilaku versi 1.x. Hanya berlaku dengan `--worker-runtime dotnet`.
`--docker`	Membuat Dockerfile untuk kontainer menggunakan gambar dasar yang berdasarkan pada `--worker-runtime` yang dipilih. Gunakan opsi ini saat Anda berencana untuk menyebarkan aplikasi fungsi dalam kontainer.
`--docker-only`	Menambahkan Dockerfile ke proyek yang sudah ada. Meminta runtime pekerja jika tidak ditentukan atau diset di local.settings.json. Gunakan opsi ini saat Anda berencana untuk menyebarkan aplikasi fungsi dalam kontainer dan proyek sudah ada.
`--force`	Inisialisasi proyek bahkan ketika ada file yang berada dalam proyek tersebut. Pengaturan ini menimpa berkas yang ada dengan nama yang sama. File lain dalam folder proyek tidak terpengaruh.
`--language`	Menginisialisasi proyek bahasa tertentu. Saat ini didukung ketika `--worker-runtime` diatur ke `node`. Opsinya adalah: `typescript` dan `javascript`. Anda juga dapat menggunakan `--worker-runtime javascript` atau `--worker-runtime typescript`.
`--managed-dependencies`	Menginstal dependensi terkelola. Saat ini, hanya runtime pekerja PowerShell yang mendukung fungsionalitas ini.
`--model`	Mengatur model pemrograman yang diinginkan untuk bahasa target saat lebih dari satu model tersedia. Opsi yang didukung adalah `V1` dan `V2` untuk Python dan `V3` dan `V4` untuk Node.js. Untuk informasi selengkapnya, lihat panduan pengembang Python dan panduan pengembang Node.js.
`--source-control`	Mengontrol apakah repositori git telah dibuat. Secara default, repositori tidak dibuat. Ketika `true`, repositori dibuat.
`--worker-runtime`	Menyetel runtime bahasa untuk proyek. Nilai yang didukung adalah: `csharp`, `dotnet`, `dotnet-isolated`,`javascript`, `node` (JavaScript), `powershell`, `python`, dan `typescript`. Untuk Java, gunakan Maven. Untuk menghasilkan proyek bahasa-agnostik hanya dengan file proyek, gunakan `custom`. Saat tidak diatur, Anda akan diminta untuk memilih runtime selama inisialisasi.
`--target-framework`	Mengatur kerangka kerja target untuk proyek aplikasi fungsi. Hanya berlaku dengan `--worker-runtime dotnet-isolated`. Nilai yang didukung adalah: `net6.0` (default), `net7.0`, `net8.0`, dan `net48` (.NET Framework 4.8).

Catatan

Saat Anda menggunakan salah satu opsi --docker atau --dockerfile, Core Tools secara otomatis membuat fungsi Dockerfile untuk C#, JavaScript, Python, dan PowerShell. Untuk fungsi Java, Anda harus membuat Dockerfile secara manual. Untuk informasi selengkapnya, lihat Membuat aplikasi fungsi dalam kontainer.

func logs

Mendapatkan log untuk fungsi yang berjalan di cluster Kubernetes.

func logs --platform kubernetes --name <APP_NAME>

Tindakan func logs mendukung opsi berikut:

Opsi	Deskripsi
`--platform`	Platform hosting untuk aplikasi fungsi. Opsi yang didukung: `kubernetes`.
`--name`	Nama aplikasi fungsi di Azure.

Untuk mempelajari selengkapnya, lihat Azure Functions di Kubernetes dengan KEDA.

func new

Membuat fungsi baru dalam proyek saat ini berdasarkan templat.

func new

Saat Anda menjalankan func new tanpa --template opsi , Anda diminta untuk memilih templat. Di versi 1.x, Anda juga diharuskan untuk memilih bahasa.

Tindakan func new mendukung opsi berikut:

Opsi	Deskripsi
`--authlevel`	Memungkinkan Anda mengatur tingkat otorisasi untuk pemicu HTTP. Nilai yang didukung adalah: `function`, `anonymous`, `admin`. Otorisasi tidak diberlakukan saat berjalan secara lokal. Untuk informasi selengkapnya, lihat artikel pengikatan HTTP.
`--csx`	(Versi 2.x dan versi yang lebih baru.) Menghasilkan templat skrip C# (.csx) yang sama yang digunakan dalam versi 1.x dan di portal.
`--language`, `-l`	Bahasa pemrograman templat, seperti C#, F#, atau JavaScript. Opsi ini diperlukan dalam versi 1.x. Dalam versi 2.x dan yang lebih baru, Anda tidak menggunakan opsi ini karena bahasa ditentukan oleh runtime pekerja.
`--name`, `-n`	Nama fungsi.
`--template`, `-t`	Gunakan perintah `func templates list` untuk melihat daftar lengkap templat yang tersedia untuk setiap bahasa yang didukung.

Untuk mempelajari selengkapnya, lihat Buat fungsi.

func run

Hanya Versi 1.x.

Memungkinkan Anda untuk menggunakan fungsi secara langsung, yang mana mirip dengan menjalankan fungsi menggunakan tab Uji di portal Microsoft Azure. Tindakan ini hanya didukung dalam versi 1.x. Untuk versi yang lebih baru, gunakan func start dan panggil titik akhir fungsi secara langsung.

func run

Tindakan func run mendukung opsi berikut:

Opsi	Deskripsi
`--content`	Konten sebaris diteruskan ke fungsi.
`--debug`	Lampirkan debugger ke proses host sebelum menjalankan fungsi.
`--file`	Nama berkas yang akan digunakan sebagai konten.
`--no-interactive`	Tidak meminta input, yang mana berguna untuk skenario otomatisasi.
`--timeout`	Waktu untuk menunggu (dalam detik) sampai host Functions lokal siap.

Misalnya, untuk memanggil fungsi yang dipicu HTTP dan melewati isi konten, jalankan perintah berikut:

func run MyHttpTrigger --content '{\"name\": \"Azure\"}'

func start

Memulai host runtime lokal dan memuat proyek fungsi di folder saat ini.

Perintah tertentu bergantung pada versi runtime.

v2.x+
v1.x

func start

func start mendukung opsi berikut:

Opsi	Deskripsi
`--cert`	Jalur ke file .pfx yang berisi kunci privat. Hanya didukung dengan `--useHttps`.
`--cors`	Daftar asal CORS yang dipisahkan koma, tanpa spasi.
`--cors-credentials`	Izinkan permintaan yang diautentikasi asal silang menggunakan cookie dan header Autentikasi.
`--dotnet-isolated-debug`	Ketika diatur ke `true`, menjeda proses pekerja .NET sampai pendebug terpasang dari proyek terisolasi .NET yang terdebug.
`--enable-json-output`	Memancarkan log konsol sebagai JSON, jika memungkinkan.
`--enableAuth`	Aktifkan alur penanganan autentikasi penuh, dengan persyaratan otorisasi.
`--functions`	Daftar fungsi yang dipisahkan spasi untuk dimuat.
`--language-worker`	Argumen untuk mengonfigurasi pekerja bahasa. Misalnya, Anda dapat mengaktifkan penelusuran kesalahan untuk pekerja bahasa dengan menyediakan port debug dan argumen lain yang diperlukan.
`--no-build`	Jangan membangun proyek saat ini sebelum berjalan. Hanya untuk proyek kelas .NET. Default adalah `false`.
`--password`	Baik kata sandi maupun file yang berisi kata sandi untuk file .pfx. Hanya digunakan dengan `--cert`.
`--port`	Port lokal untuk mendengarkan. Nilai default: 7071.
`--timeout`	Batas waktu untuk memulai host Functions, dalam hitungan detik. Default: 20 detik.
`--useHttps`	Mengikat ke `https://localhost:{port}` bukan ke `http://localhost:{port}`. Secara default, opsi ini membuat sertifikat tepercaya pada komputer Anda.

Dengan berjalannya proyek, Anda dapat memverifikasi titik akhir fungsi individu.

func host start

func start mendukung opsi berikut:

Opsi	Deskripsi
`--cors`	Daftar asal CORS yang dipisahkan koma, tanpa spasi.
`--port`	Port lokal untuk mendengarkan. Nilai default: 7071.
`--pause-on-error`	Jeda untuk input tambahan sebelum keluar dari proses. Digunakan hanya saat meluncurkan Core Tools dari lingkungan pengembangan terpadu (IDE).
`--script-root`	Digunakan untuk menentukan jalur ke akar aplikasi fungsi yang akan dijalankan atau digunakan. Ini digunakan untuk proyek terkompilasi yang menghasilkan file proyek ke dalam subfolder. Misalnya, saat Anda membuat proyek pustaka kelas C#, file host.json, local.settings.json, dan function.json dihasilkan dalam subfolder akar dengan jalur seperti `MyProject/bin/Debug/netstandard2.0`. Dalam hal ini, tetapkan prefiks sebagai `--script-root MyProject/bin/Debug/netstandard2.0`. Ini adalah akar aplikasi fungsi saat berjalan di Azure.
`--timeout`	Batas waktu untuk memulai host Functions, dalam hitungan detik. Default: 20 detik.
`--useHttps`	Mengikat ke `https://localhost:{port}` bukan ke `http://localhost:{port}`. Secara default, opsi ini membuat sertifikat tepercaya pada komputer Anda.

Di versi 1.x, Anda juga dapat menggunakan func run perintah untuk menjalankan fungsi tertentu dan meneruskan data pengujian ke dalamnya.

func azure functionapp fetch-app-settings

Mendapatkan pengaturan dari aplikasi fungsi tertentu.

func azure functionapp fetch-app-settings <APP_NAME>

Untuk informasi selengkapnya, lihat Mengunduh pengaturan aplikasi.

Pengaturan diunduh ke file local.settings.json untuk proyek. Nilai di layar ditutupi untuk keamanan. Anda dapat melindungi pengaturan di file local.settings.json dengan mengaktifkan enkripsi lokal.

func azure functionapp list-functions

Mengembalikan daftar fungsi di aplikasi fungsi yang ditentukan.

func azure functionapp list-functions <APP_NAME>

func azure functionapp logstream

Menghubungkan perintah lokal ke log streaming untuk aplikasi fungsi di Azure.

func azure functionapp logstream <APP_NAME>

Batas waktu default untuk koneksi adalah 2 jam. Anda dapat mengubah batas waktu dengan menambahkan pengaturan aplikasi bernama SCM_LOGSTREAM_TIMEOUT, dengan nilai batas waktu dalam satuan detik. Belum didukung untuk aplikasi Linux dalam paket Konsumsi. Untuk aplikasi ini, gunakan opsi --browser untuk menampilkan log di portal.

Tindakan deploy mendukung opsi berikut:

Opsi	Deskripsi
`--browser`	Buka Live Stream Application Insights Azure untuk aplikasi fungsi di browser default.

Untuk informasi selengkapnya, lihat Mengaktifkan log eksekusi streaming di Azure Functions.

func azure functionapp publish

Menyebarkan proyek Functions ke sumber daya aplikasi fungsi yang ada di Azure.

func azure functionapp publish <APP_NAME>

Untuk informasi selengkapnya, lihat Menyebarkan file proyek.

Opsi penerbitan berikut ini berlaku, berdasarkan versi:

v2.x+
v1.x

Opsi	Deskripsi
`--access-token`	Memungkinkan Anda menggunakan token akses tertentu saat melakukan tindakan azure yang diautentikasi.
`--access-token-stdin`	Membaca token akses tertentu dari input standar. Gunakan ini saat membaca token langsung dari perintah sebelumnya seperti `az account get-access-token`.
`--additional-packages`	Daftar paket yang akan diinstal saat membangun dependensi asli. Sebagai contoh: `python3-dev libevent-dev`.
`--build`, `-b`	Melakukan tindakan build saat menerapkan ke aplikasi fungsi Linux. Menerima: `remote` dan `local`.
`--build-native-deps`	Melompati pembuatan folder `.wheels` saat menerbitkan aplikasi fungsi Python.
`--csx`	Menerbitkan proyek skrip C# (.csx).
`--dotnet-cli-params`	Saat menerbitkan fungsi C# (.csproj) yang dikompilasi, alat inti memanggil `dotnet build --output bin/publish`. Parameter apa pun yang diteruskan ke ini ditambahkan ke baris perintah.
`--force`	Abaikan verifikasi prapublikasi dalam skenario tertentu.
`--list-ignored-files`	Menampilkan daftar file yang diabaikan selama penerbitan, yang didasarkan pada file `.funcignore`.
`--list-included-files`	Menampilkan daftar file yang diterbitkan, yang didasarkan pada file `.funcignore`.
`--management-url`	Mengatur URL manajemen untuk cloud Anda. Gunakan ini saat berjalan di sovereign cloud.
`--no-build`	Proyek tidak dibuat selama penerbitan. Untuk Python, `pip install` tidak dilakukan.
`--nozip`	Menonaktifkan mode default `Run-From-Package`.
`--overwrite-settings -y`	Tekan perintah untuk menimpa pengaturan aplikasi saat `--publish-local-settings -i` digunakan.
`--publish-local-settings -i`	Terbitkan pengaturan local.settings.json ke Azure, meminta untuk menimpa jika pengaturan sudah ada. Jika Anda menggunakan emulator penyimpanan lokal, pertama-tama ubah pengaturan aplikasi ke koneksi penyimpanan aktual.
`--publish-settings-only`, `-o`	Hanya terbitkan pengaturan dan lompati kontennya. Defaultnya adalah minta.
`--slot`	Nama opsional dari slot tertentu yang akan dipublikasikan.
`--subscription`	Mengatur langganan default yang akan digunakan.

Opsi	Deskripsi
`--overwrite-settings -y`	Tekan perintah untuk menimpa pengaturan aplikasi saat `--publish-local-settings -i` digunakan.
`--publish-local-settings -i`	Terbitkan pengaturan local.settings.json ke Azure, meminta untuk menimpa jika pengaturan sudah ada. Jika Anda menggunakan Emulator Microsoft Azure Storage, pertama ubah pengaturan aplikasi menjadi koneksi penyimpanan aktual.

func azure storage fetch-connection-string

Mendapatkan string koneksi untuk akun Azure Storage tertentu.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Untuk informasi selengkapnya, lihat Mengunduh string koneksi penyimpanan.

func azurecontainerapps deploy

Menyebarkan aplikasi fungsi dalam kontainer ke lingkungan Azure Container Apps. Akun penyimpanan yang digunakan oleh aplikasi fungsi dan lingkungan harus sudah ada. Untuk informasi selengkapnya, lihat Hosting Azure Container Apps azure Functions.

func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>

Opsi penyebaran berikut berlaku:

Opsi	Deskripsi
`--access-token`	Memungkinkan Anda menggunakan token akses tertentu saat melakukan tindakan azure yang diautentikasi.
`--access-token-stdin`	Membaca token akses tertentu dari input standar. Gunakan ini saat membaca token langsung dari perintah sebelumnya seperti `az account get-access-token`.
`--environment`	Nama lingkungan Container Apps yang ada.
`--image-build`	Saat diatur ke `true`, lewati build Docker lokal.
`--image-name`	Nama gambar kontainer yang ada dalam registri kontainer. Nama gambar menyertakan nama tag.
`--location`	Wilayah untuk penyebaran. Idealnya, ini adalah wilayah yang sama dengan lingkungan dan sumber daya akun penyimpanan.
`--management-url`	Mengatur URL manajemen untuk cloud Anda. Gunakan ini saat berjalan di sovereign cloud.
`--name`	Nama yang digunakan untuk penyebaran aplikasi fungsi di lingkungan Aplikasi Kontainer. Nama yang sama ini juga digunakan saat mengelola aplikasi fungsi di portal. Nama harus unik di lingkungan.
`--registry`	Saat diatur, build Docker dijalankan dan gambar didorong ke registri yang diatur di `--registry`. Anda tidak dapat menggunakan `--registry` dengan `--image-name`. Untuk Docker Hub, gunakan `--registry-username`juga .
`--registry-password`	Kata sandi atau token yang digunakan untuk mengambil gambar dari registri privat.
`--registry-username`	Nama pengguna yang digunakan untuk mengambil gambar dari registri privat.
`--resource-group`	Grup sumber daya untuk membuat sumber daya terkait fungsi.
`--storage-account`	string koneksi untuk akun penyimpanan yang akan digunakan oleh aplikasi fungsi.
`--subscription`	Mengatur langganan default yang akan digunakan.
`--worker-runtime`	Mengatur bahasa runtime aplikasi fungsi. Parameter ini hanya digunakan dengan `--image-name` dan `--image-build`, jika tidak, bahasa ditentukan selama build lokal. Nilai yang didukung adalah: `dotnet`, , `dotnetIsolatednode`, `python`, `powershell`, dan `custom` (untuk penangan pelanggan).

Penting

String koneksi penyimpanan dan kredensial layanan lainnya adalah rahasia penting. Pastikan untuk menyimpan file skrip apa pun dengan aman menggunakan func azurecontainerapps deploy dan tidak menyimpannya di kontrol sumber yang dapat diakses publik.

func deploy

Perintah func deploy tidak digunakan lagi. Alih-alih gunakan func kubernetes deploy.

func durable delete-task-hub

Menghapus semua artefak penyimpanan di hub tugas Durable Functions.

func durable delete-task-hub

Tindakan delete-task-hub mendukung opsi berikut:

Opsi	Deskripsi
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--task-hub-name`	Nama opsional dari Hub Tugas Durable yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable get-history

Menampilkan riwayat instans orkestrasi yang ditentukan.

func durable get-history --id <INSTANCE_ID>

Tindakan get-history mendukung opsi berikut:

Opsi	Deskripsi
`--id`	Menentukan ID dari instans orkestrasi (diperlukan).
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--task-hub-name`	Nama opsional dari Hub Tugas Durable yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable get-instances

Menampilkan status semua instans orkestrasi. Mendukung penomoran menggunakan parameter top.

func durable get-instances

Tindakan get-instances mendukung opsi berikut:

Opsi	Deskripsi
`--continuation-token`	Token opsional yang menunjukkan halaman/bagian tertentu dari permintaan untuk ditampilkan.
`--connection-string-setting`	Nama opsional pengaturan aplikasi yang berisi string koneksi penyimpanan yang akan digunakan.
`--created-after`	Secara opsional, mendapatkan instans yang dibuat setelah tanggal/waktu (UTC) ini. Semua tanggalwaktu dengan format ISO 8601 diterima.
`--created-before`	Secara opsional, mendapatkan instans yang dibuat sebelum tanggal/waktu tertentu (UTC). Semua tanggalwaktu dengan format ISO 8601 diterima.
`--runtime-status`	Secara opsional, mendapatkan instans yang statusnya cocok dengan status tertentu, termasuk `running`, `completed`, dan `failed`. Anda dapat menyediakan satu atau lebih status yang terpisah spasi.
`--top`	Secara opsional membatasi jumlah catatan yang ditampilkan dalam permintaan yang diberikan.
`--task-hub-name`	Nama opsional hub tugas Durable Functions yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable get-runtime-status

Menampilkan status instans orkestrasi tertentu.

func durable get-runtime-status --id <INSTANCE_ID>

Tindakan get-runtime-status mendukung opsi berikut:

Opsi	Deskripsi
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--id`	Menentukan ID dari instans orkestrasi (diperlukan).
`--show-input`	Jika diatur, respons akan berisi input fungsi.
`--show-output`	Jika diatur, respons akan berisi riwayat eksekusi.
`--task-hub-name`	Nama opsional hub tugas Durable Functions yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable purge-history

Penghapusan menyeluruh status instans orkestrasi, riwayat, dan penyimpanan blob untuk orkestrasi yang lebih tua dari ambang batas yang ditentukan.

func durable purge-history

Tindakan purge-history mendukung opsi berikut:

Opsi	Deskripsi
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--created-after`	Secara opsional menghapus riwayat instans yang dibuat setelah tanggal/waktu (UTC) ini. Semua nilai tanggalwaktu dalam format ISO 8601 diterima.
`--created-before`	Secara opsional menghapus riwayat instans yang dibuat sebelum tanggal/waktu (UTC) ini. Semua nilai tanggalwaktu dalam format ISO 8601 diterima.
`--runtime-status`	Secara opsional menghapus riwayat instans yang statusnya sesuai dengan status tertentu, termasuk `completd`, `terminated`, `canceled`, dan `failed`. Anda dapat menyediakan satu atau lebih status yang terpisah spasi. Jika Anda tidak menyertakan `--runtime-status`, riwayat instans dihapus terlepas dari statusnya.
`--task-hub-name`	Nama opsional hub tugas Durable Functions yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable raise-event

Mengangkat peristiwa ke instans orkestrasi yang ditentukan.

func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>

Tindakan raise-event mendukung opsi berikut:

Opsi	Deskripsi
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--event-data`	Data untuk diteruskan ke peristiwa, baik sebaris atau dari file JSON (diperlukan). Untuk file, prefiks jalur ke file dengan ampersand (`@`), seperti `@path/to/file.json`.
`--event-name`	Nama peristiwa yang akan dinaikkan.
`--id`	Menentukan ID dari instans orkestrasi (diperlukan).
`--task-hub-name`	Nama opsional hub tugas Durable Functions yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable rewind

Menggulung balik instans orkestrasi yang ditentukan.

func durable rewind --id <INSTANCE_ID> --reason <REASON>

Tindakan rewind mendukung opsi berikut:

Opsi	Deskripsi
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--id`	Menentukan ID dari instans orkestrasi (diperlukan).
`--reason`	Alasan untuk menggulung balik instans orkestrasi.
`--task-hub-name`	Nama opsional hub tugas Durable Functions yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable start-new

Memulai instans baru dari fungsi orkestrator yang ditentukan.

func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>

Tindakan start-new mendukung opsi berikut:

Opsi	Deskripsi
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--function-name`	Nama fungsi orkestrator untuk memulai (diperlukan).
`--id`	Menentukan ID dari instans orkestrasi (diperlukan).
`--input`	Memasukkan fungsi orkestrator, baik sebaris atau dari file JSON (diperlukan). Untuk file, prefiks jalur ke file dengan ampersand (`@`), seperti `@path/to/file.json`.
`--task-hub-name`	Nama opsional hub tugas Durable Functions yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func durable terminate

Menghentikan instans orkestrasi yang ditentukan.

func durable terminate --id <INSTANCE_ID> --reason <REASON>

Tindakan terminate mendukung opsi berikut:

Opsi	Deskripsi
`--connection-string-setting`	Nama opsional pengaturan aplikasi berisi string koneksi penyimpanan yang akan digunakan.
`--id`	Menentukan ID dari instans orkestrasi (diperlukan).
`--reason`	Alasan untuk menghentikan orkestrasi (diperlukan).
`--task-hub-name`	Nama opsional hub tugas Durable Functions yang akan digunakan.

Untuk mempelajari selengkapnya, lihat dokumentasi Durable Functions.

func extensions install

Menginstal ekstensi Functions secara manual dalam proyek non-.NET atau dalam proyek skrip C#.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>

Tindakan install mendukung opsi berikut:

Opsi	Deskripsi
`--configPath`	Jalur direktori yang berisi file extensions.csproj.
`--csx`	Mendukung proyek C# scripting (.csx).
`--force`	Memperbarui versi ekstensi yang ada.
`--output`	Jalur output untuk ekstensi.
`--package`	Pengidentifikasi untuk paket ekstensi tertentu. Jika tidak ditentukan, semua ekstensi yang dirujuk diinstal, seperti halnya `func extensions sync`.
`--source`	Sumber umpan NuGet saat tidak menggunakan NuGet.org.
`--version`	Versi paket ekstensi.

Contoh berikut menginstal ekstensi Azure Event Hubs versi 5.0.1 di proyek lokal:

func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1

Pertimbangan berikut berlaku saat menggunakan func extensions install:

Untuk proyek C# yang dikompilasi (proses dalam proses dan proses pekerja terisolasi), sebagai gantinya gunakan metode penginstalan paket NuGet standar, seperti dotnet add package.
Untuk menginstal ekstensi secara manual menggunakan Core Tools, Anda harus menginstal .NET 6.0 SDK .
Jika memungkinkan, Anda harus menggunakan bundel ekstensi. Berikut ini adalah beberapa alasan mengapa Anda mungkin perlu menginstal ekstensi secara manual:
- Anda perlu mengakses versi ekstensi tertentu yang tidak tersedia dalam bundel.
- Anda perlu mengakses ekstensi kustom yang tidak tersedia dalam bundel.
- Anda perlu mengakses kombinasi ekstensi tertentu yang tidak tersedia dalam satu bundel.
Sebelum dapat menginstal ekstensi secara manual, Anda harus terlebih dahulu menghapus extensionBundle objek dari file host.json yang menentukan bundel. Tidak ada tindakan yang diambil ketika bundel ekstensi sudah diatur dalam file host.json Anda.
Pertama kali Anda menginstal ekstensi secara eksplisit, file proyek .NET bernama extensions.csproj ditambahkan ke akar proyek aplikasi Anda. File ini mendefinisikan kumpulan paket NuGet yang diperlukan oleh fungsi Anda. Meskipun Anda dapat bekerja dengan referensi paket NuGet dalam file ini, Core Tools memungkinkan Anda menginstal ekstensi tanpa harus mengedit file proyek C# secara manual.

func extensions sync

Menginstal semua ekstensi yang ditambahkan ke aplikasi fungsi.

Tindakan sync mendukung opsi berikut:

Opsi	Deskripsi
`--configPath`	Jalur direktori yang berisi file extensions.csproj.
`--csx`	Mendukung proyek C# scripting (.csx).
`--output`	Jalur output untuk ekstensi.

Meregenerasi file extensions.csproj yang hilang. Tidak ada tindakan yang diambil ketika bundel ekstensi didefinisikan dalam file host.json Anda.

func kubernetes deploy

Menyebarkan proyek Functions sebagai kontainer docker kustom ke kluster Kubernetes.

func kubernetes deploy

Perintah ini membangun proyek Anda sebagai kontainer kustom dan menerbitkannya ke kluster Kubernetes. Kontainer kustom harus memiliki Dockerfile. Untuk membuat aplikasi dengan Dockerfile, gunakan --dockerfile opsi dengan func init perintah .

Opsi penyebaran Kubernetes berikut ini tersedia:

Opsi	Deskripsi
`--dry-run`	Secara opsional menampilkan templat penyebaran, tanpa eksekusi.
`--config-map-name`	Nama opsional pemetaan konfigurasi yang sudah ada dengan pengaturan aplikasi fungsi untuk digunakan saat penyebaran. Memerlukan `--use-config-map`. Perilaku default adalah membuat pengaturan berdasarkan objek `Values` dalam file local.settings.json.
`--cooldown-period`	Periode pendinginan (dalam hitungan detik) setelah semua pemicu tidak lagi aktif sebelum skala penyebaran kembali ke nol, dengan default 300 dtk.
`--ignore-errors`	Melanjutkan penyebaran setelah sumber daya menampilkan kesalahan. Perilaku default adalah berhenti saat kesalahan.
`--image-name`	Nama citra yang digunakan untuk penyebaran pod dan dari mana untuk membaca fungsi.
`--keda-version`	Mengatur versi KEDA untuk diinstal. Opsi yang valid adalah: `v1` dan `v2` (default).
`--keys-secret-name`	Nama koleksi Rahasia Kubernetes untuk digunakan untuk menyimpankunci akses fungsi.
`--max-replicas`	Menetapkan jumlah replika maksimum yang diskalakan Horizontal Pod Autoscaler (HPA).
`--min-replicas`	Menetapkan jumlah replika minimum di bawah HPA mana yang tidak akan diskalakan.
`--mount-funckeys-as-containervolume`	Memasang kunci akses fungsi sebagai volume kotainer.
`--name`	Nama yang digunakan untuk penyebaran dan artefak lainnya di Kubernetes.
`--namespace`	Mengatur namespace Kubernetes yang akan disebarkan, yang default ke namespace default.
`--no-docker`	Functions dibaca dari direktori saat ini, bukan dari citra. Membutuhkan pemasangan filesystem citra.
`--registry`	Ketika diatur, build Docker dijalankan dan citra didorong ke registri nama itu. Anda tidak dapat menggunakan `--registry` dengan `--image-name`. Untuk Docker, gunakan nama pengguna Anda.
`--polling-interval`	Interval polling (dalam hitungan detik) untuk memeriksa pemicu non-HTTP, dengan default 30dtk.
`--pull-secret`	Rahasia yang digunakan untuk mengakses info masuk registri privat.
`--secret-name`	Nama koleksi Rahasia Kubernetes yang ada yang berisi pengaturan aplikasi fungsi untuk digunakan dalam penyebaran. Perilaku default adalah membuat pengaturan berdasarkan objek `Values` dalam file local.settings.json.
`--show-service-fqdn`	Menampilkan URL pemicu HTTP dengan Kubernetes FQDN alih-alih perilaku default menggunakan alamat IP.
`--service-type`	Menetapkan jenis Layanan Kubernetes. Nilai yang didukung adalah `ClusterIP`, `NodePort`, dan `LoadBalancer` (default).
`--use-config-map`	Gunakan objek `ConfigMap` (v1) alih-alih objek `Secret` (v1) untuk mengonfigurasi pengaturan aplikasi fungsi. Nama pemetaan diatur menggunakan `--config-map-name`.

Core Tools akan memanfaatkan CLI Docker lokal untuk membangun dan menerbitkan citra. Pastikan Docker Anda sudah diinstal secara lokal. Jalankan perintah docker login untuk menyambungkan ke akun Anda.

Untuk mempelajari lebih lanjut, lihat Menyebarkan aplikasi fungsi ke Kubernetes.

func kubernetes install

Menginstal KEDA di cluster Kubernetes.

func kubernetes install

Menginstal KEDA ke cluster yang didefinisikan dalam file konfigurasi kubectl.

Tindakan install mendukung opsi berikut:

Opsi	Deskripsi
`--dry-run`	Menampilkan templat penyebaran, tanpa eksekusi.
`--keda-version`	Mengatur versi KEDA untuk diinstal. Opsi yang valid adalah: `v1` dan `v2` (default).
`--namespace`	Mendukung instalasi ke namespace Kubernetes tertentu. Jika tidak ditentukan, namespace default digunakan.

Untuk memperlajari selengkapnya, lihat Mengelola KEDA dan fungsi di Kubernetes.

func kubernetes remove

Menghapus KEDA dari cluster Kubernetes yang didefinisikan dalam file konfigurasi kubectl.

func kubernetes remove

Menghapus KEDA dari cluster yang didefinisikan dalam file konfigurasi kubectl.

Tindakan remove mendukung opsi berikut:

Opsi	Deskripsi
`--namespace`	Mendukung penghapusan instalan dari namespace Kubernetes tertentu. Jika tidak ditentukan, namespace default digunakan.

Untuk mempelajari selengkapnya, lihat Menghapus instalan KEDA dari Kubernetes.

func settings add

Menambahkan pengaturan baru ke kumpulan Values di file local.settings.json.

func settings add <SETTING_NAME> <VALUE>

Mengganti <SETTING_NAME> dengan nama pengaturan aplikasi dan <VALUE> dengan nilai pengaturan.

Tindakan add mendukung opsi berikut:

Opsi	Deskripsi
`--connectionString`	Menambahkan pasangan nama-nilai ke kumpulan `ConnectionStrings` alih-alih kumpulan `Values`. Hanya menggunakan koleksi `ConnectionStrings` saat dibutuhkan oleh kerangka kerja tertentu. Untuk mempelajari lebih lanjut, lihat file local.settings.json.

func settings decrypt

Mendekripsi nilai enkripsi sebelumnya dalam kumpulan Values di file local.settings.json.

func settings decrypt

Nilai string koneksi dalam kumpulan ConnectionStrings juga didekripsi. Dalam local.setting.json, IsEncrypted juga diatur ke false. Mengenkripsi pengaturan lokal untuk mengurangi risiko membocorkan informasi berharga dari local.setting.json. Di Azure, pengaturan aplikasi selalu disimpan terenkripsi.

func settings delete

Menghapus pengaturan yang sudah ada dari kumpulan Values di file local.settings.json.

func settings delete <SETTING_NAME>

Mengganti <SETTING_NAME> dengan nama pengaturan aplikasi dan <VALUE> dengan nilai pengaturan.

Tindakan delete mendukung opsi berikut:

Opsi	Deskripsi
`--connectionString`	Menghapus pasangan nama-nilai ke kumpulan `ConnectionStrings` alih-alih kumpulan `Values`.

func settings encrypt

Mengekripsi nilai item individu dalam kumpulan Values di file local.settings.json.

func settings encrypt

Nilai string koneksi dalam kumpulan ConnectionStrings juga dienkripsi. Dalam local.setting.json, IsEncrypted juga diatur ke true, yang menentukan bahwa runtime lokal akan mendekripsi pengaturan sebelum menggunakannya. Mengenkripsi pengaturan lokal untuk mengurangi risiko membocorkan informasi berharga dari local.setting.json. Di Azure, pengaturan aplikasi selalu disimpan terenkripsi.

func settings list

Output daftar pengaturan dalam kumpulan Values di file local.settings.json.

func settings list

String koneksi dari kumpulan ConnectionStrings juga merupakan output. Secara default, nilai ditutupi untuk keamanan. Anda dapat menggunakan opsi --showValue untuk menampilkan nilai aktual.

Tindakan list mendukung opsi berikut:

Opsi	Deskripsi
`--showValue`	Memperlihatkan nilai tidak ditutupi yang sebenarnya dalam output.

func templates list

Daftar templat fungsi (pemicu) yang tersedia.

Tindakan list mendukung opsi berikut:

Opsi	Deskripsi
`--language`	Bahasa untuk memfilter templat yang ditampilkan. Default menampilkan semua bahasa.

Referensi Azure Functions Core Tools

func init

func logs

func new

func run

func start

func azure functionapp fetch-app-settings

func azure functionapp list-functions

func azure functionapp logstream

func azure functionapp publish

func azure storage fetch-connection-string

func azurecontainerapps deploy

func deploy

func durable delete-task-hub

func durable get-history

func durable get-instances

func durable get-runtime-status

func durable purge-history

func durable raise-event

func durable rewind

func durable start-new

func durable terminate

func extensions install

func extensions sync

func kubernetes deploy

func kubernetes install

func kubernetes remove

func settings add

func settings decrypt

func settings delete

func settings encrypt

func settings list

func templates list

Sumber Daya Tambahan: