Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 mempelajari selengkapnya tentang menggunakan Core Tools, lihat Work 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 untuk membuat dan menjalankan fungsi di komputer lokal Anda. |
func azure |
Perintah untuk bekerja dengan sumber daya Azure, termasuk penerbitan. |
func azurecontainerapps |
Perintah untuk menyebarkan aplikasi fungsi dalam kontainer ke Azure Container Apps. |
func bundles |
Perintah untuk mengelola bundel ekstensi. |
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, instal 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 Perintah ini mendukung opsi ini, yang tidak didukung dalam versi 1.x, kecuali dinyatakan lain:
| Opsi | Deskripsi |
|---|---|
--bundles-channel, -c |
Saluran rilis bundel ekstensi. Nilai yang didukung adalah: GA (default), Preview, dan Experimental. Hanya berlaku untuk proyek non-.NET. |
--configuration-profile |
Menginisialisasi proyek dengan profil konfigurasi host. Opsi --configuration-profile saat ini dalam pratinjau. Untuk informasi selengkapnya, lihat Profil konfigurasi. |
--csx |
Membuat fungsi .NET sebagai skrip C#, yang merupakan perilaku versi 1.x. Hanya berlaku dengan --worker-runtime dotnet. |
--docker |
Membuat Dockerfile untuk kontainer menggunakan gambar dasar berdasarkan yang dipilih --worker-runtime. 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 diatur dalam 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, -l |
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 fitur ini. |
--model, -m |
Mengatur model pemrograman 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. |
--no-bundle |
Jangan konfigurasikan bundel ekstensi di host.json. Hanya berlaku untuk proyek non-.NET. |
--no-docs |
Melompati pembuatan file dokumentasi "Memulai". Berlaku untuk proyek Python. |
--skip-npm-install |
Lewati berjalan npm install setelah pembuatan proyek. Berlaku untuk proyek Node.js. |
--source-control |
Mengontrol apakah repositori Git dibuat. Secara default, repositori tidak dibuat. Ketika true, repositori dibuat. |
--worker-runtime |
Menyetel runtime bahasa untuk proyek. Nilai yang didukung adalah: csharp, , dotnetdotnet-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: net10.0 (pratinjau), net9.0, net8.0 (default), net6.0, dan net48 (.NET Framework 4.8). |
Catatan
Saat Anda menggunakan opsi --docker atau --docker-only, 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.
Profil konfigurasi
Penting
Dukungan untuk profil konfigurasi saat ini dalam pratinjau.
Saat Anda menggunakan opsi , --configuration-profile sekumpulan konfigurasi dan pengaturan proyek yang telah ditentukan dibuat. Saat Anda menentukan profil konfigurasi, inisialisasi mungkin melewati semua langkah inisialisasi lainnya.
| Nilai profil | Deskripsi | Tindakan tertentu |
|---|---|---|
mcp-custom-handler |
Membuat proyek yang menggunakan handler kustom untuk menghosting server MCP (Model Context Protocol) yang dapat disambungkan oleh agen AI dan klien MCP lainnya. | • Mengonfigurasi "configurationProfile": "mcp-custom-handler" elemen dalam file host.json dengan pengaturan handler kustom tertentu.• Diatur MCP_EXTENSION_ENABLED ke true dalam local.settings.json. |
func logs
Mendapatkan log untuk fungsi yang berjalan di cluster Kubernetes.
func logs --platform kubernetes --name <APP_NAME>
func logs Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--platform |
Platform hosting untuk aplikasi fungsi. Opsi yang valid: kubernetes. |
--name |
Nama aplikasi fungsi di Azure. |
Untuk informasi 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 perlu memilih bahasa.
func new Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--authlevel, -a |
Mengatur tingkat otorisasi untuk pemicu HTTP. Nilai yang didukung adalah: function, anonymous, admin. Otorisasi tidak diberlakukan saat berjalan secara lokal. Untuk informasi selengkapnya, lihat Tingkat otorisasi. |
--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. |
--file, -f |
File target untuk fungsi baru. Untuk proyek Python v2, menentukan file untuk menambahkan fungsi ke (default ke function_app.py). Untuk proyek Node.js v4, menentukan nama file output di src/functions folder . Tidak berlaku untuk proyek .NET yang dikompilasi. |
--language, -l |
Bahasa pemrograman templat, seperti C# atau JavaScript. Opsi ini diperlukan dalam versi 1.x. Di versi 2.x dan versi yang lebih baru, jangan gunakan opsi ini karena bahasa didefinisikan 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 informasi lebih lanjut, lihat Membuat fungsi.
func pack
Membuat paket penyebaran yang berisi kode proyek Anda dalam status dapat dijalankan. Gunakan metode ini saat Anda perlu membuat paket penyebaran secara manual untuk aplikasi Anda di komputer lokal Anda di luar func azure functionapp publish perintah. Secara default, func pack membangun proyek Anda saat diperlukan.
func pack [<FOLDER_PATH>]
Secara default, func pack mengemas direktori saat ini, dan file .zip output memiliki nama yang sama dengan folder akar proyek Anda. Jalankan func pack di direktori yang berisi file proyek host.json Anda. Jika Anda perlu menjalankan func pack di direktori lain, atur <FOLDER_PATH> sebagai jalur ke akar proyek, seperti func pack ./myprojectroot. Jika file .zip tertentu sudah ada, file tersebut pertama kali dihapus lalu diganti dengan versi yang diperbarui.
func pack Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--output, -o |
Mengatur jalur ke lokasi tempat penyebaran .zip file paket dibuat. |
--no-build |
Project tidak dibangun sebelum pengemasan. Untuk aplikasi C#, gunakan hanya saat Anda sudah membuat biner Anda. Untuk aplikasi Node.js, baik npm install dan npm run build dilewati. |
--skip-install |
Melompati berjalan npm install saat mengemas aplikasi fungsi berbasis Node.js. Digunakan untuk menghindari penimpaan modul npm kustom. |
--build-native-deps |
Menginstal dependensi Python secara lokal dengan menggunakan gambar yang cocok dengan lingkungan yang digunakan dalam Azure. Saat diaktifkan, Core Tools memulai kontainer Docker, membangun aplikasi di dalam kontainer tersebut, dan membuat file .zip dengan semua dependensi yang dipulihkan di .python_packages. Gunakan opsi ini saat berjalan di Windows untuk menghindari potensi masalah pustaka saat Anda menyebarkan ke Linux di Azure. |
func run
Hanya Versi 1.x.
Memungkinkan Anda memanggil fungsi secara langsung, yang mirip dengan menjalankan fungsi menggunakan tab Test di portal 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
func run Perintah mendukung opsi ini:
| 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 meneruskan isi konten, jalankan perintah ini:
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.
func start
func start Perintah mendukung opsi ini:
| 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 |
Memungkinkan permintaan terautentikasi lintas asal yang menggunakan cookie dan header Autentikasi. |
--dotnet-isolated-debug |
Saat diatur ke true, jeda proses pekerja .NET hingga debugger dilampirkan dari proyek terisolasi .NET sedang di-debug. |
--enable-json-output |
Memancarkan log konsol sebagai JSON jika memungkinkan. |
--enableAuth |
Mengaktifkan alur penanganan autentikasi penuh dengan persyaratan otorisasi. |
--functions |
Daftar fungsi yang dipisahkan spasi untuk dimuat. |
--json-output-file |
Jika disediakan, jalur ke file yang digunakan untuk menulis output saat menggunakan --enable-json-output. |
--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. Defaultnya adalah false. |
--password |
Baik kata sandi maupun file yang berisi kata sandi untuk file .pfx. Hanya digunakan dengan --cert. |
--port, -p |
Port lokal untuk mendengarkan. Nilai default: 7071. |
--runtime |
Mengatur versi host mana yang akan dimulai. Nilai yang diizinkan adalah: inproc6, inproc8, dan default (yang menjalankan host di luar proses). |
--timeout, -t |
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. |
--user-log-level |
Mengatur tingkat log minimum untuk log pengguna. Nilai yang valid adalah: Trace, , DebugInformation, Warning, Error, Critical, dan None. Pengaturan ini tidak memengaruhi log sistem. Untuk proyek terisolasi .NET, atur juga tingkat minimum di Program.cs dengan menggunakan builder.Logging.SetMinimumLevel(LogLevel.Debug) agar opsi ini berlaku. |
Dengan proyek berjalan, verifikasi titik akhir fungsi individual.
func azure functionapp
Konteks func azure functionapp berisi perintah berikut:
func azure functionapp fetch-app-settingsfunc azure functionapp list-functionsfunc azure functionapp logstreamfunc azure functionapp publish
Semua func azure functionapp perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--slot |
Menargetkan slot penyebaran bernama tertentu, jika dikonfigurasi. |
--access-token |
Menyediakan token akses, selain token default, untuk digunakan untuk melakukan tindakan terautentikasi di Azure. |
--access-token-stdin |
Membaca token akses tertentu dari input standar. Gunakan opsi ini saat membaca token langsung dari perintah sebelumnya seperti az account get-access-token. |
--management-url |
Mengatur URL manajemen untuk cloud Azure, yang defaultnya https://management.azure.com. Gunakan opsi ini saat aplikasi fungsi Anda berjalan di sovereign cloud. |
--subscription |
Mengatur langganan Azure default. |
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 unduhan 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
Mencantumkan fungsi dalam aplikasi fungsi yang ditentukan.
func azure functionapp list-functions <APP_NAME>
Perintah func azure functionapp list-functions mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--show-keys |
Sertakan nilai kunci akses tingkat fungsi dalam URL titik akhir fungsi yang dikembalikan. |
func azure functionapp logstream
Menyambungkan prompt perintah lokal ke log streaming untuk aplikasi fungsi di Azure.
func azure functionapp logstream <APP_NAME>
Batas waktu default untuk koneksi adalah 2 jam. Ubah batas waktu dengan menambahkan pengaturan aplikasi bernama SCM_LOGSTREAM_TIMEOUT, dengan nilai batas waktu dalam detik. Belum didukung untuk Linux dalam paket Konsumsi atau KonsumsiFlex. Untuk aplikasi ini, gunakan opsi --browser untuk menampilkan log di portal.
Perintah func azure functionapp logstream mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--browser |
Buka Azure Application Insights Live Stream untuk aplikasi fungsi di browser default. |
Untuk informasi selengkapnya, lihat log eksekusi streaming Enable 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 berlaku, berdasarkan versi:
| Opsi | Deskripsi |
|---|---|
--additional-packages |
Daftar paket yang akan diinstal saat membangun dependensi asli. Misalnya: python3-dev libevent-dev. |
--build, -b |
Melakukan tindakan build saat menyebarkan ke aplikasi fungsi Linux. Menerima: remote dan local. |
--build-native-deps |
Melompati pembuatan folder .wheels saat Anda menerbitkan aplikasi fungsi Python. |
--csx |
Menerbitkan proyek skrip C# (.csx). |
--dotnet-cli-params |
Saat Anda menerbitkan fungsi C# (.csproj) yang dikompilasi, alat inti memanggil dotnet build --output bin/publish. Parameter apa pun yang diteruskan ke opsi ini ditambahkan ke baris perintah. |
--dotnet-version |
Untuk aplikasi dotnet-isolated, menentukan versi .NET target (misalnya, 8.0). |
--force |
Mengabaikan verifikasi prapublikasi dalam skenario tertentu. |
--list-ignored-files |
Menampilkan daftar file yang diabaikan selama penerbitan, berdasarkan file .funcignore . |
--list-included-files |
Menampilkan daftar file yang diterbitkan, yang didasarkan pada file .funcignore . |
--no-build |
Project tidak dibangun selama penerbitan. Untuk Python, pip install tidak berjalan. |
--nozip |
Menonaktifkan mode default Run-From-Package. Mengekstrak file ke wwwroot folder di server alih-alih menjalankannya langsung dari paket penyebaran. |
--overwrite-settings, -y |
Menekan perintah untuk menimpa pengaturan aplikasi saat Anda menggunakan --publish-local-settings -i. |
--publish-local-settings, -i |
Menerbitkan pengaturan di 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 |
Menerbitkan hanya pengaturan dan melewati isi. Defaultnya adalah minta. |
--show-keys |
Menambahkan kunci fungsi ke URL yang ditampilkan dalam log. |
func azure storage fetch-connection-string
Mendapatkan connection string untuk akun Azure Storage yang ditentukan.
func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>
Untuk informasi selengkapnya, lihat unduh penyimpanan connection string.
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 |
|---|---|
--environment |
Nama lingkungan Container Apps yang ada. |
--image-build |
Atur ke true untuk melewati build Docker lokal. |
--image-name |
Nama gambar kontainer yang ada dalam registri kontainer, termasuk nama tag. |
--location |
Wilayah untuk penyebaran. Idealnya, wilayah ini sama dengan lingkungan dan sumber daya akun penyimpanan. |
--name |
Nama yang digunakan untuk penyebaran aplikasi fungsi di lingkungan Aplikasi Kontainer. Nama ini juga muncul saat mengelola aplikasi fungsi di portal. Nama harus unik di lingkungan. |
--registry |
Saat diatur, build Docker berjalan dan gambar didorong ke registri yang diatur dalam --registry. Anda tidak dapat menggunakan --registry dengan --image-name. Untuk Docker Hub, gunakan juga --registry-username. |
--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 |
connection string untuk akun penyimpanan yang akan digunakan oleh aplikasi fungsi. |
--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 handler kustom). |
Penting
String koneksi penyimpanan dan kredensial layanan lainnya adalah rahasia penting. Simpan file skrip apa pun yang digunakan func azurecontainerapps deploy dengan aman dan jangan simpan di kontrol sumber yang dapat diakses publik.
func deploy
Perintah func deploy tidak digunakan lagi. Alih-alih gunakan func kubernetes deploy.
func bundles add
Menambahkan konfigurasi bundel ekstensi ke file host.json .
func bundles add
func bundles add Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--force, -f |
Menimpa konfigurasi bundel ekstensi yang ada jika ada. |
--channel, -c |
Saluran rilis bundel ekstensi. Nilai yang didukung adalah: GA (default), Preview, dan Experimental. |
func bundles download
Mengunduh bundel ekstensi yang dikonfigurasi di host.json.
func bundles download
func bundles download Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--force, -f |
Memaksa pengunduhan ulang bundel ekstensi meskipun sudah ada. |
func bundles list
Mencantumkan bundel ekstensi yang diunduh.
func bundles list
func bundles path
Mendapatkan jalur ke bundel ekstensi yang diunduh.
func bundles path
func durable delete-task-hub
Menghapus semua artefak penyimpanan di hub tugas Durable Functions.
func durable delete-task-hub
func durable delete-task-hub Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connection-string-setting |
Nama pengaturan yang berisi connection string penyimpanan yang akan digunakan. |
--task-hub-name |
Nama hub tugas Tahan Lama untuk digunakan. |
Untuk informasi selengkapnya, lihat dokumentasi Durable Functions.
func durable get-history
Mengembalikan riwayat instans orkestrasi tertentu.
func durable get-history --id <INSTANCE_ID>
func durable get-history Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--id |
ID instans orkestrasi. (Diperlukan) |
--connection-string-setting |
Nama pengaturan yang memiliki connection string penyimpanan untuk digunakan. |
--task-hub-name |
Nama hub tugas Tahan Lama untuk digunakan. |
Untuk informasi selengkapnya, lihat dokumentasi Durable Functions.
func durable get-instances
Menampilkan status semua instans orkestrasi. Perintah ini mendukung halaman dengan top parameter .
func durable get-instances
func durable get-instances Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--continuation-token |
Token yang menunjukkan halaman atau bagian tertentu dari permintaan yang akan dikembalikan. |
--connection-string-setting |
Nama pengaturan aplikasi yang berisi connection string penyimpanan untuk digunakan. |
--created-after |
Dapatkan instans yang dibuat setelah tanggal dan waktu (UTC) ini. Semua tanggalwaktu dengan format ISO 8601 diterima. |
--created-before |
Dapatkan instans yang dibuat sebelum tanggal dan waktu tertentu (UTC). Semua tanggalwaktu dengan format ISO 8601 diterima. |
--runtime-status |
Dapatkan instans yang statusnya cocok dengan status tertentu, termasuk running, completed, dan failed. Anda dapat memberikan satu atau beberapa status yang dipisahkan ruang. |
--top |
Batasi jumlah rekaman yang dikembalikan dalam permintaan tertentu. |
--task-hub-name |
Nama hub tugas Durable Functions untuk digunakan. |
Untuk informasi selengkapnya, lihat dokumentasi Durable Functions.
func durable get-runtime-status
Mengembalikan status instans orkestrasi tertentu.
func durable get-runtime-status --id <INSTANCE_ID>
func durable get-runtime-status Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connection-string-setting |
Nama pengaturan yang berisi connection string penyimpanan yang akan digunakan. |
--id |
ID instans orkestrasi. (Diperlukan) |
--show-input |
Saat diatur, respons menyertakan input fungsi. |
--show-output |
Saat diatur, respons menyertakan riwayat eksekusi. |
--task-hub-name |
Nama hub tugas Durable Functions untuk digunakan. |
Untuk informasi selengkapnya, lihat dokumentasi Durable Functions.
func durable purge-history
Hapus menyeluruh status instans orkestrasi, riwayat, dan penyimpanan blob untuk orkestrasi yang lebih lama dari ambang yang ditentukan.
func durable purge-history
func durable purge-history Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connection-string-setting |
Nama pengaturan yang berisi connection string penyimpanan yang akan digunakan. |
--created-after |
Hapus riwayat instans yang dibuat setelah tanggal/waktu (UTC) ini. Semua nilai tanggalwaktu dalam format ISO 8601 diterima. |
--created-before |
Hapus riwayat instans yang dibuat sebelum tanggal/waktu (UTC) ini. Semua nilai tanggalwaktu dalam format ISO 8601 diterima. |
--runtime-status |
Hapus riwayat instans yang statusnya cocok dengan status tertentu, termasuk completed, , terminatedcanceled, dan failed. Berikan satu atau beberapa status yang dipisahkan spasi. Jika Anda tidak menyertakan --runtime-status, riwayat instans dihapus terlepas dari statusnya. |
--task-hub-name |
Nama hub tugas Durable Functions untuk digunakan. |
Untuk informasi 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>
func durable raise-event Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connection-string-setting |
Nama pengaturan yang berisi connection string penyimpanan yang akan digunakan. |
--event-data |
Data yang akan diteruskan ke peristiwa, baik sebaris atau dari file JSON. Untuk file, awali jalur ke file dengan tanda (@), seperti @path/to/file.json. (Diperlukan) |
--event-name |
Nama acara yang akan dinaikkan. (Diperlukan) |
--id |
ID instans orkestrasi. (Diperlukan) |
--task-hub-name |
Nama hub tugas Durable Functions untuk digunakan. |
Untuk informasi selengkapnya, lihat dokumentasi Durable Functions.
func durable rewind
Menggulung balik instans orkestrasi yang ditentukan.
func durable rewind --id <INSTANCE_ID> --reason <REASON>
func durable rewind Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connection-string-setting |
Nama pengaturan yang berisi connection string penyimpanan yang akan digunakan. |
--id |
ID instans orkestrasi. (Diperlukan) |
--reason |
Alasan untuk memundurkan orkestrasi. (Diperlukan) |
--task-hub-name |
Nama hub tugas Durable Functions untuk digunakan. |
Untuk informasi 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>
func durable start-new Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connection-string-setting |
Nama pengaturan yang berisi connection string penyimpanan yang akan digunakan. |
--function-name |
Nama fungsi orkestrator untuk memulai. (Diperlukan) |
--id |
Menentukan ID instans orkestrasi. (Diperlukan) |
--input |
Input ke fungsi orkestrator, baik sebaris atau dari file JSON. Untuk file, awali jalur ke file dengan ampersand (@), seperti @path/to/file.json. (Diperlukan) |
--task-hub-name |
Nama hub tugas Durable Functions untuk digunakan. |
Untuk informasi selengkapnya, lihat dokumentasi Durable Functions.
func durable terminate
Mengakhiri instans orkestrasi yang ditentukan.
func durable terminate --id <INSTANCE_ID> --reason <REASON>
func durable terminate Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connection-string-setting |
Nama pengaturan yang berisi connection string penyimpanan yang akan digunakan. |
--id |
Menentukan ID instans orkestrasi. (Diperlukan) |
--reason |
Alasan untuk mengakhiri orkestrasi. (Diperlukan) |
--task-hub-name |
Nama hub tugas Durable Functions untuk digunakan. |
Untuk informasi selengkapnya, lihat dokumentasi Durable Functions.
func extensions install
Menginstal ekstensi Functions secara manual dalam proyek non-.NET atau proyek skrip C#.
func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>
func extensions install Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--configPath, -c |
Jalur direktori yang berisi file extensions.csproj. |
--csx |
Mendukung proyek skrip C# (.csx). |
--force, -f |
Memperbarui versi ekstensi yang ada. |
--output, -o |
Jalur output untuk ekstensi. |
--package, -p |
Pengidentifikasi untuk paket ekstensi tertentu. Jika tidak ditentukan, semua ekstensi yang dirujuk diinstal, seperti halnya func extensions sync. |
--source, -s |
Sumber umpan NuGet saat tidak menggunakan NuGet.org. |
--version, -v |
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 ini berlaku saat menggunakan func extensions install:
Untuk proyek C# yang dikompilasi (baik dalam proses maupun proses pekerja terisolasi), gunakan metode penginstalan paket NuGet standar sebagai gantinya, seperti
dotnet add package.Untuk menginstal ekstensi secara manual dengan menggunakan Core Tools, Anda harus menginstal .NET SDK terinstal.
Jika memungkinkan, Anda harus menggunakan bundel ekstensi. Berikut 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
extensionBundleobjek 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.
func extensions sync Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--configPath, -c |
Jalur direktori yang berisi file extensions.csproj. |
--csx |
Mendukung proyek C# scripting (.csx). |
--output, -o |
Jalur output untuk ekstensi. |
Meregenerasi file extensions.csproj yang hilang. Tidak mengambil tindakan ketika bundel ekstensi ditentukan 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 .
func kubernetes deploy Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--dry-run |
Menampilkan templat penyebaran, tanpa eksekusi. |
--config-map-name |
Nama peta konfigurasi yang ada dengan pengaturan aplikasi fungsi untuk digunakan dalam penyebaran. Membutuhkan --use-config-map. Perilaku defaultnya adalah membuat pengaturan berdasarkan Values objek dalam file local.settings.json . |
--cooldown-period |
Periode cooldown (dalam detik) setelah semua pemicu tidak lagi aktif sebelum penyebaran menskalakan kembali ke nol, dengan default 300 dtk. |
--ignore-errors |
Lanjutkan penyebaran setelah sumber daya mengembalikan kesalahan. Perilaku default adalah berhenti saat kesalahan. |
--image-name |
Nama citra yang digunakan untuk penyebaran pod dan dari mana untuk membaca fungsi. |
--keda-version |
Atur versi KEDA untuk diinstal. Opsi yang valid adalah: v1 dan v2 (default). |
--keys-secret-name |
Nama koleksi Rahasia Kubernetes yang akan digunakan untuk menyimpan kunci akses. |
--max-replicas |
Atur jumlah replika maksimum yang diskalakan Horizontal Pod Autoscaler (HPA). |
--min-replicas |
Atur jumlah replika minimum di bawah HPA yang tidak akan diskalakan. |
--mount-funckeys-as-containervolume |
Pasang kunci akses sebagai volume kontainer. |
--name |
Nama yang digunakan untuk penyebaran dan artefak lainnya di Kubernetes. |
--namespace |
Atur namespace Layanan Kubernetes untuk disebarkan. Default ke namespace default. |
--no-docker |
Membaca fungsi dari direktori saat ini alih-alih dari gambar. Membutuhkan pemasangan filesystem citra. |
--registry |
Saat diatur, build Docker berjalan dan gambar didorong ke registri nama tersebut. 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 memiliki pengaturan aplikasi fungsi untuk digunakan dalam penyebaran. Perilaku defaultnya adalah membuat pengaturan berdasarkan Values objek dalam file local.settings.json . |
--show-service-fqdn |
Tampilkan URL pemicu HTTP dengan Kubernetes FQDN alih-alih perilaku default menggunakan alamat IP. |
--service-type |
Atur 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. |
--use-git-hash-version |
Gunakan hash Git sebagai versi untuk gambar kontainer. |
--write-configs |
Keluarkan konfigurasi Kubernetes sebagai file YAML alih-alih menyebarkan. |
--config-file |
Jalur file output saat menggunakan --write-configs. Default: functions.yaml. |
--hash-files |
File ke hash untuk menentukan versi gambar. |
--image-build |
Saat diatur ke false, lewati build Docker. |
--key-secret-annotations |
Anotasi untuk ditambahkan ke rahasia kunci, dalam key1=val1,key2=val2 format. |
Core Tools akan memanfaatkan CLI Docker lokal untuk membangun dan menerbitkan citra. Pastikan Docker sudah diinstal secara lokal. Jalankan perintah docker login untuk menyambungkan ke akun Anda.
Azure Functions mendukung hosting fungsi kontainer Anda baik di Azure Container Apps atau di Azure Functions. Azure Functions tidak secara resmi mendukung menjalankan kontainer Anda langsung di kluster Kubernetes atau di Azure Kubernetes Service (AKS). Untuk informasi selengkapnya, lihat dukungan kontainer Linux di Azure Functions.
func kubernetes delete
Menghapus penyebaran Functions dari kluster Kubernetes.
func kubernetes delete --name <APP_NAME>
func kubernetes delete Perintah mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--name |
Nama untuk penyebaran dan artefak lainnya di Kubernetes. (Diperlukan) |
--namespace |
Atur namespace Layanan Kubernetes. Default ke default namespace layanan. |
--registry |
Nama registri kontainer. |
--image-name |
Gambar yang digunakan untuk penyebaran pod. |
--keda-version |
Atur versi KEDA. Opsi yang valid adalah v1 dan v2 (default). |
func kubernetes install
Menginstal KEDA dalam kluster Kubernetes
func kubernetes install
Menginstal KEDA ke cluster yang didefinisikan dalam file konfigurasi kubectl.
func kubernetes install Perintah mendukung opsi ini:
| 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 |
Menginstal ke namespace Layanan Kubernetes tertentu. Jika tidak ditentukan, namespace default digunakan. |
Untuk informasi selengkapnya, lihat Mengelola KEDA dan fungsi di Kubernetes.
func kubernetes remove
Menghapus KEDA dari kluster Kubernetes yang ditentukan dalam kubectl file konfigurasi.
func kubernetes remove
Menghapus KEDA dari kluster yang ditentukan dalam kubectl file konfigurasi.
Perintah func kubernetes remove mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--namespace |
Menghapus instalan dari namespace Layanan Kubernetes tertentu. Jika tidak ditentukan, namespace default digunakan. |
Untuk informasi 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>
Ganti <SETTING_NAME> dengan nama pengaturan aplikasi.
Perintah func settings add mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connectionString |
Menambahkan pasangan nama-nilai ke kumpulan ConnectionStrings alih-alih kumpulan Values.
ConnectionStrings Gunakan koleksi hanya ketika kerangka kerja tertentu memerlukannya. Untuk informasi selengkapnya, lihat filelocal.settings.json. |
func settings decrypt
Mendekripsi nilai terenkripsi dalam Values koleksi dalam file local.settings.json .
func settings decrypt
Perintah ini juga mendekripsi nilai connection string dalam koleksi ConnectionStrings. Dalam local.setting.json, IsEncrypted juga diatur ke false. Mengenkripsi pengaturan lokal untuk mengurangi risiko membocorkan informasi berharga dari local.setting.json. Dalam Azure, pengaturan aplikasi selalu disimpan dienkripsi.
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.
Perintah func settings delete mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--connectionString |
Menghapus pasangan nama-nilai dari ConnectionStrings koleksi alih-alih Values koleksi. |
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. Dalam Azure, pengaturan aplikasi selalu disimpan sebagai terenkripsi.
func settings list
Output daftar pengaturan dalam kumpulan Values di file local.settings.json.
func settings list
Output juga mencakup string koneksi dari ConnectionStrings koleksi. Secara default, nilai ditutupi untuk keamanan. Anda dapat menggunakan opsi --showValue untuk menampilkan nilai aktual.
Perintah func settings list mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--showValue, -a |
Perlihatkan nilai yang tidak dimasak aktual dalam output. |
func templates list
Daftar templat fungsi (pemicu) yang tersedia.
Perintah func templates list mendukung opsi ini:
| Opsi | Deskripsi |
|---|---|
--language, -l |
Bahasa untuk memfilter templat yang ditampilkan. Mengembalikan semua bahasa secara default. |
Opsi global
Opsi ini tersedia untuk sebagian besar perintah Core Tools:
| Opsi | Deskripsi |
|---|---|
--script-root |
Mengatur direktori akar aplikasi fungsi dan mengubah direktori kerja untuk perintah . |
--verbose |
Mengaktifkan output verbose untuk pengelogan terperinci. Tidak didukung oleh semua perintah. |
--offline |
Berjalan dalam mode offline, tanpa melakukan panggilan jaringan eksternal. Didukung oleh func start, func init, dan func new. Juga dapat diatur melalui FUNCTIONS_CORE_TOOLS_OFFLINE variabel lingkungan. |
--version, -v |
Menampilkan versi Azure Functions Core Tools. |
--help, -h |
Menampilkan informasi bantuan. |
--pause-on-error |
Jeda untuk input tambahan sebelum keluar dari proses. Berguna saat Anda meluncurkan Core Tools dari lingkungan pengembangan terintegrasi (IDE). |