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.
Pengaturan aplikasi dalam aplikasi fungsi berisi opsi konfigurasi yang memengaruhi semua fungsi untuk aplikasi fungsi tersebut. Pengaturan ini diakses sebagai variabel lingkungan. Artikel ini mencantumkan pengaturan aplikasi yang tersedia di aplikasi fungsi.
Ada beberapa cara yang dapat Anda tambahkan, perbarui, dan hapus pengaturan aplikasi fungsi:
Perubahan pada pengaturan aplikasi fungsi mengharuskan aplikasi fungsi Anda dimulai ulang.
Dalam artikel ini, contoh nilai string koneksi dipotong untuk keterbacaan.
Azure Functions menggunakan platform Azure App Service untuk hosting. Anda mungkin menemukan beberapa pengaturan yang relevan untuk menghosting aplikasi fungsi Anda di Variabel lingkungan dan pengaturan aplikasi di Azure App Service.
Pertimbangan pengaturan aplikasi
Saat menggunakan pengaturan aplikasi, Anda harus mengetahui pertimbangan berikut:
Mengubah pengaturan aplikasi menyebabkan aplikasi fungsi Anda dimulai ulang secara default di semua paket hosting. Untuk penyebaran tanpa waktu henti saat mengubah pengaturan, gunakan Rencana Konsumsi Flex dengan pembaruan bergulir sebagai strategi pembaruan situs web. Untuk paket hosting lainnya, lihat optimalkan penerapan untuk panduan tentang meminimalkan gangguan layanan.
Dalam mengatur nama, garis bawah ganda (
__) dan titik dua (:) dianggap sebagai nilai cadangan. Garis bawah ganda ditafsirkan sebagai pemisah hierarkis di Windows dan Linux. Titik dua ditafsirkan dengan cara yang sama hanya pada Windows. Misalnya, pengaturanAzureFunctionsWebHost__hostid=somehost_123456akan ditafsirkan sebagai objek JSON berikut:"AzureFunctionsWebHost": { "hostid": "somehost_123456" }Dalam artikel ini, hanya garis bawah ganda yang digunakan, karena didukung pada kedua sistem operasi. Sebagian besar pengaturan yang mendukung koneksi identitas terkelola menggunakan garis bawah ganda.
Saat fungsi berjalan secara lokal, pengaturan aplikasi ditentukan dalam
Valueskoleksi di local.settings.json.Ada opsi konfigurasi aplikasi fungsi lainnya di file host.json dan di file local.settings.json.
Anda dapat menggunakan pengaturan aplikasi untuk mengganti pengaturan nilai host.json tanpa harus mengubah file host.json itu sendiri. Pendekatan ini berguna untuk skenario di mana Anda perlu mengonfigurasi atau memodifikasi pengaturan host.json tertentu untuk lingkungan tertentu. Pendekatan ini juga memungkinkan Anda mengubah pengaturan host.json tanpa harus menerbitkan ulang proyek Anda. Untuk mempelajari selengkapnya, lihat artikel referensi host.json.
Artikel ini mendokuensikan pengaturan yang paling relevan dengan aplikasi fungsi Anda. Karena Azure Functions berjalan di App Service, pengaturan aplikasi lain juga didukung. Untuk informasi selengkapnya, lihat Variabel lingkungan dan pengaturan aplikasi di Azure App Service.
Beberapa skenario juga mengharuskan Anda untuk bekerja dengan pengaturan yang didokumenkan di pengaturan situs App Service.
Mengubah pengaturan aplikasi App Service baca-sajadapat membuat aplikasi fungsi Anda menjadi status tidak responsif.
Berhati-hatilah saat memperbarui pengaturan aplikasi dengan menggunakan REST API, termasuk templat ARM. Karena API ini menggantikan pengaturan aplikasi yang ada, Anda harus menyertakan semua pengaturan yang ada saat menambahkan atau memodifikasi pengaturan menggunakan REST API atau templat ARM. Jika memungkinkan, gunakan Azure CLI atau Azure PowerShell untuk bekerja secara terprogram dengan pengaturan aplikasi. Untuk informasi selengkapnya, harap lihat Bekerja dengan pengaturan aplikasi.
APPINSIGHTS_INSTRUMENTATIONKEY
Kunci instrumentasi untuk Application Insights. Jangan gunakan keduanya APPINSIGHTS_INSTRUMENTATIONKEY dan APPLICATIONINSIGHTS_CONNECTION_STRING. Jika memungkinkan, gunakan APPLICATIONINSIGHTS_CONNECTION_STRING. Saat Application Insights berjalan di sovereign cloud, Anda harus menggunakan APPLICATIONINSIGHTS_CONNECTION_STRING. Untuk mempelajari selengkapnya, lihat Cara mengonfigurasi pemantauan untuk Azure Functions.
| Key | Nilai sampel |
|---|---|
| APPINSIGHTS_INSTRUMENTATIONKEY | 55555555-af77-484b-9032-64f83bb83bb |
Jangan gunakan keduanya APPINSIGHTS_INSTRUMENTATIONKEY dan APPLICATIONINSIGHTS_CONNECTION_STRING. Kami menyarankan agar Anda menggunakan APPLICATIONINSIGHTS_CONNECTION_STRING.
APPLICATIONINSIGHTS_AUTHENTICATION_STRING
Memungkinkan akses ke Application Insights dengan menggunakan autentikasi Microsoft Entra. Gunakan pengaturan ini saat Anda harus tersambung ke ruang kerja Application Insights dengan menggunakan autentikasi Microsoft Entra. Untuk informasi selengkapnya, lihat Autentikasi Microsoft Entra untuk Application Insights.
Saat Anda menggunakan APPLICATIONINSIGHTS_AUTHENTICATION_STRING, nilai spesifik yang Anda tetapkan bergantung pada jenis identitas terkelola:
| Identitas yang dikelola | Nilai Setelan |
|---|---|
| System-assigned | Authorization=AAD |
| User-assigned | Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID> |
Persyaratan autentikasi ini diterapkan ke koneksi dari host Functions, snapshot debugger, profiler, dan agen khusus bahasa apa pun. Untuk menggunakan pengaturan ini, identitas terkelola harus sudah tersedia untuk aplikasi fungsi, dengan peran yang ditetapkan setara dengan Monitoring Metrics Publisher.
Note
Saat menggunakan APPLICATIONINSIGHTS_AUTHENTICATION_STRING untuk menyambungkan ke Application Insights menggunakan autentikasi Microsoft Entra, Anda juga harus Menonaktifkan autentikasi lokal untuk Application Insights. Konfigurasi ini memerlukan autentikasi Microsoft Entra agar telemetri diserap ke ruang kerja Anda.
APPLICATIONINSIGHTS_CONNECTION_STRING
Rantai koneksi untuk Application Insights. Jangan gunakan keduanya APPINSIGHTS_INSTRUMENTATIONKEY dan APPLICATIONINSIGHTS_CONNECTION_STRING. Kami merekomendasikan penggunaan APPLICATIONINSIGHTS_CONNECTION_STRING dalam semua kasus. Ini adalah persyaratan dalam kasus-kasus berikut:
- Saat aplikasi fungsi Anda memerlukan penyesuaian tambahan yang didukung dengan menggunakan string koneksi
- Saat instans Application Insights Anda berjalan di cloud berdaulat, memerlukan titik akhir kustom
Untuk informasi selengkapnya, lihat String koneksi.
| Key | Nilai sampel |
|---|---|
| APPLICATIONINSIGHTS_CONNECTION_STRING | InstrumentationKey=... |
Untuk menyambungkan ke Application Insights dengan autentikasi Microsoft Entra, Anda harus menggunakan APPLICATIONINSIGHTS_AUTHENTICATION_STRING.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL
Important
Proksi Azure Functions adalah fitur versi 1.x hingga 3.x dari runtime Azure Functions. Untuk informasi selengkapnya, lihat Proksi fungsi.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
Important
Proksi Azure Functions adalah fitur versi 1.x hingga 3.x dari runtime Azure Functions. Untuk informasi selengkapnya, lihat Proksi fungsi.
AZURE_FUNCTIONS_ENVIRONMENT
Mengonfigurasi lingkungan hosting runtime aplikasi fungsi saat berjalan di Azure. Nilai ini dibaca selama inisialisasi. Runtime hanya menerima nilai-nilai ini:
| Value | Description |
|---|---|
Production |
Mewakili lingkungan produksi, dengan pengurangan pengelogan dan pengoptimalan performa penuh. Nilai ini adalah default ketika AZURE_FUNCTIONS_ENVIRONMENT tidak diatur atau diatur ke nilai yang tidak didukung. |
Staging |
Mewakili lingkungan penahapan, seperti saat beroperasi di slot penahapan. |
Development |
Lingkungan pengembangan mendukung pencatatan log yang lebih mendetail dan pengoptimalan lain yang mengurangi performa. Azure Functions Core Tools mengatur AZURE_FUNCTIONS_ENVIRONMENT ke Development saat berjalan di komputer lokal Anda. Pengaturan ini tidak dapat diubah dalam file local.settings.json. |
Gunakan pengaturan ini alih-alih ASPNETCORE_ENVIRONMENT saat Anda perlu mengubah lingkungan runtime di Azure menjadi sesuatu selain Production. Untuk informasi selengkapnya, lihat Kelas dan metode Startup berbasis lingkungan.
Pengaturan ini tidak tersedia dalam runtime Functions versi 1.x.
AzureFunctionsJobHost__*
Di versi 2.x dan versi yang lebih baru dari runtime Functions, pengaturan aplikasi dapat mengganti pengaturan host.json di lingkungan saat ini. Pengaturan ini dinyatakan sebagai pengaturan aplikasi bernama AzureFunctionsJobHost__path__to__setting. Untuk informasi selengkapnya, lihat Menggantikan nilai host.json.
AzureFunctionsWebHost__hostid
Mengatur ID host untuk aplikasi fungsi tertentu, yang seharusnya menjadi ID unik. Pengaturan ini mengambil alih nilai ID host yang dihasilkan secara otomatis untuk aplikasi Anda. Gunakan pengaturan ini hanya saat Anda perlu mencegah tabrakan ID host antara aplikasi fungsi yang berbagi akun penyimpanan yang sama.
ID host harus memenuhi persyaratan berikut:
- Antara 1 dan 32 karakter
- Hanya berisi huruf kecil, angka, dan tanda hubung
- Tidak dimulai atau diakhiri dengan tanda hubung
- Tidak berisi tanda hudah berturut-turut
Cara mudah untuk menghasilkan ID adalah dengan mengambil GUID, menghapus tanda hubung, dan membuatnya huruf kecil, seperti dengan mengonversi GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 ke nilai 1835d7b55c984790815d072cc94c6f71.
| Key | Nilai sampel |
|---|---|
| AzureFunctionsWebHost__hostid | myuniquefunctionappname123456789 |
Untuk informasi selengkapnya, lihat Pertimbangan ID Host.
AzureWebJobsDashboard
Pengaturan ini tidak digunakan lagi dan hanya didukung saat berjalan pada versi 1.x dari runtime Azure Functions.
String koneksi akun penyimpanan opsional untuk menyimpan log dan menampilkannya di tab Monitor di portal Microsoft Azure. Akun penyimpanan harus merupakan akun tujuan umum yang mendukung blob, antrean, dan tabel. Untuk mempelajari selengkapnya, lihat Persyaratan akun Storage.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsDashboard | DefaultEndpointsProtocol=https;AccountName=... |
AzureWebJobsDisableHomepage
Nilai true menonaktifkan halaman arahan bawaan yang ditampilkan untuk URL root aplikasi fungsi. Nilai defaultnya adalah false.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsDisableHomepage | true |
Ketika pengaturan aplikasi ini dihilangkan atau diatur ke false, halaman yang mirip dengan contoh berikut ditampilkan sebagai respons terhadap URL <functionappname>.azurewebsites.net.
AzureWebJobsDotNetReleaseCompilation
true berarti gunakan mode Release saat mengompilasi kode .NET.
false berarti menggunakan mode Debug. Defaultnya adalah true.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsDotNetReleaseCompilation | true |
AzureWebJobsFeatureFlags
Daftar fitur beta yang dipisahkan koma untuk diaktifkan. Fitur beta yang diaktifkan oleh bendera ini tidak siap produksi, tetapi dapat diaktifkan untuk penggunaan eksperimental sebelum ditayangkan.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsFeatureFlags | feature1,feature2,EnableProxies |
Jika aplikasi Anda saat ini memiliki pengaturan ini, tambahkan bendera baru ke akhir daftar yang diurai koma.
Bendera fitur yang saat ini didukung:
| Nilai penanda | Description |
|---|---|
EnableProxies |
Mengaktifkan kembali proksi pada runtime Functions versi 4.x saat Anda merencanakan migrasi ke Azure API Management. Untuk informasi selengkapnya, lihat Mengaktifkan kembali proksi di Functions v4.x. |
EnableAzureMonitorTimeIsoFormat |
ISO 8601 Mengaktifkan format waktu di log Azure Monitor untuk aplikasi Linux yang berjalan pada paket Khusus (App Service). |
AzureWebJobsKubernetesSecretName
Menunjukkan sumber daya Rahasia Kubernetes yang digunakan untuk menyimpan kunci. Hanya didukung saat dijalankan di Kubernetes.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsKubernetesSecretName | <SECRETS_RESOURCE> |
Pertimbangan saat Anda menggunakan sumber daya Rahasia Kubernetes:
- Anda juga harus mengatur
AzureWebJobsSecretStorageTypekekubernetes. KetikaAzureWebJobsKubernetesSecretNametidak diatur, repositori dianggap baca saja. Dalam hal ini, nilai-nilai harus dihasilkan sebelum penyebaran. - Azure Functions Core Tools menghasilkan nilai secara otomatis saat disebarkan ke Kubernetes.
- Rahasia yang tidak dapat diubah tidak didukung dan menggunakannya menghasilkan kesalahan runtime.
Untuk mempelajari selengkapnya, lihat Mengelola penyimpanan kunci.
AzureWebJobsSecretStorageKeyVaultClientId
ID klien dari identitas terkelola yang ditetapkan pengguna atau pendaftaran aplikasi yang digunakan untuk mengakses brankas tempat kunci disimpan. Pengaturan ini mengharuskan Anda untuk mengatur AzureWebJobsSecretStorageType ke keyvault. Didukung di versi 4.x dan versi yang lebih baru dari runtime Functions.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsSecretStorageKeyVaultClientId | <CLIENT_ID> |
Untuk mempelajari selengkapnya, lihat Mengelola penyimpanan kunci.
AzureWebJobsSecretStorageKeyVaultClientSecret
Rahasia ID Klien dari identitas terkelola yang ditugaskan oleh pengguna atau pendaftaran aplikasi digunakan untuk mengakses brankas tempat menyimpan kunci. Pengaturan ini mengharuskan Anda untuk mengatur AzureWebJobsSecretStorageType ke keyvault. Didukung di versi 4.x dan versi yang lebih baru dari runtime Functions.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsSecretStorageKeyVaultClientSecret | <CLIENT_SECRET> |
Untuk mempelajari selengkapnya, lihat Mengelola penyimpanan kunci.
AzureWebJobsSecretStorageKeyVaultName
Pengaturan ini tidak digunakan lagi dan hanya digunakan saat berjalan pada versi 3.x dari runtime Azure Functions.
Nama instans brankas kunci yang digunakan untuk menyimpan kunci. Pengaturan ini hanya digunakan dalam runtime Functions versi 3.x, yang tidak lagi didukung. Untuk versi 4.x, sebagai gantinya gunakan AzureWebJobsSecretStorageKeyVaultUri. Pengaturan ini mengharuskan Anda untuk mengatur AzureWebJobsSecretStorageType ke keyvault.
Vault harus memiliki kebijakan akses yang sesuai dengan identitas terkelola sumber daya hosting yang ditetapkan sistem. Kebijakan akses harus memberi identitas izin rahasia berikut: Get,Set, List, dan Delete.
Saat fungsi Anda berjalan secara lokal, identitas pengembang digunakan. Pengaturan harus ada dalam filelocal.settings.json.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsSecretStorageKeyVaultName | <VAULT_NAME> |
Untuk mempelajari selengkapnya, lihat Mengelola penyimpanan kunci.
AzureWebJobsSecretStorageKeyVaultTenantId
ID penyewa dari pendaftaran aplikasi yang digunakan untuk mengakses brankas tempat kunci-kunci disimpan. Pengaturan ini mengharuskan Anda untuk mengatur AzureWebJobsSecretStorageType ke keyvault. Didukung di versi 4.x dan versi yang lebih baru dari runtime Functions. Untuk mempelajari selengkapnya, lihat Mengelola penyimpanan kunci.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsSecretStorageKeyVaultTenantId | <TENANT_ID> |
AzureWebJobsSecretStorageKeyVaultUri
URI dari instans brankas kunci yang digunakan untuk menyimpan kunci. Didukung di versi 4.x dan versi yang lebih baru dari runtime Functions. Kami merekomendasikan pengaturan ini untuk menggunakan instans brankas kunci untuk penyimpanan kunci. Pengaturan ini mengharuskan Anda untuk mengatur AzureWebJobsSecretStorageType ke keyvault.
Nilai AzureWebJobsSecretStorageKeyVaultUri harus berupa nilai lengkap URI Vault yang ditampilkan di tab gambaran umum Key Vault, termasuk https://.
Vault harus memiliki kebijakan akses yang sesuai dengan identitas terkelola sumber daya hosting yang ditetapkan sistem. Kebijakan akses harus memberi identitas izin rahasia berikut: Get,Set, List, dan Delete.
Saat fungsi Anda berjalan secara lokal, identitas pengembang digunakan, dan pengaturan harus berada dalam file local.settings.json.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsSecretStorageKeyVaultUri | https://<VAULT_NAME>.vault.azure.net |
Important
Rahasia tidak dibatasi pada aplikasi fungsi individual melalui pengaturan AzureWebJobsSecretStorageKeyVaultUri. Jika beberapa aplikasi fungsi dikonfigurasi untuk menggunakan layanan Key Vault yang sama, mereka berbagi rahasia yang sama, yang dapat menyebabkan konflik atau penimpaan kunci. Untuk menghindari perilaku yang tidak diinginkan, kami sarankan Anda menggunakan instans Key Vault terpisah untuk setiap aplikasi fungsi.
Untuk mempelajari lebih lanjut, lihat Mengelola Penyimpanan Kunci.
AzureWebJobsSecretStorageSas
URL SAS Blob Storage untuk akun penyimpanan kedua yang digunakan untuk penyimpanan kunci. Secara default, Functions menggunakan akun yang diatur dalam AzureWebJobsStorage. Saat menggunakan opsi penyimpanan rahasia ini, pastikan bahwa AzureWebJobsSecretStorageType tidak diatur secara eksplisit atau diatur ke blob. Untuk mempelajari selengkapnya, lihat Mengelola penyimpanan kunci.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsSecretStorageSas | <BLOB_SAS_URL> |
AzureWebJobsSecretStorageType
Menentukan repositori atau penyedia yang akan digunakan untuk penyimpanan kunci. Kunci dienkripsi sebelum disimpan menggunakan kode unik untuk aplikasi fungsi Anda.
| Key | Value | Description |
|---|---|---|
| AzureWebJobsSecretStorageType | blob |
Kunci disimpan dalam wadah penyimpanan Blob di akun yang telah disediakan oleh pengaturan AzureWebJobsStorage. Penyimpanan blob adalah perilaku default saat AzureWebJobsSecretStorageType tidak diatur.Untuk menentukan akun penyimpanan yang berbeda, gunakan pengaturan AzureWebJobsSecretStorageSas untuk menunjukkan URL SAS dari akun penyimpanan kedua. |
| AzureWebJobsSecretStorageType | files |
Kunci tetap ada pada sistem file. Perilaku ini adalah default untuk Functions v1.x. |
| AzureWebJobsSecretStorageType | keyvault |
Kunci disimpan dalam instans penyimpanan kunci yang ditetapkan oleh AzureWebJobsSecretStorageKeyVaultName. |
| AzureWebJobsSecretStorageType | kubernetes |
Hanya didukung saat menjalankan runtime Functions di Kubernetes. Ketika AzureWebJobsKubernetesSecretName tidak diatur, repositori dianggap baca saja. Dalam hal ini, nilai-nilai harus dihasilkan sebelum penyebaran.
Azure Functions Core Tools menghasilkan nilai secara otomatis saat disebarkan ke Kubernetes. |
Untuk mempelajari selengkapnya, lihat Mengelola penyimpanan kunci.
AzureWebJobsStorage
Menentukan string koneksi untuk akun Azure Storage yang digunakan runtime Functions untuk operasi normal. Beberapa penggunaan akun penyimpanan ini oleh Functions termasuk manajemen kunci, manajemen pemicu timer, dan titik pemeriksaan Event Hubs. Akun penyimpanan harus merupakan akun tujuan umum yang mendukung blob, antrean, dan tabel. Untuk informasi selengkapnya, lihat Persyaratan akun Storage.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsStorage | DefaultEndpointsProtocol=https;AccountName=... |
Alih-alih string koneksi, Anda dapat menggunakan koneksi berbasis identitas untuk akun penyimpanan ini. Untuk informasi lebih lengkap, lihat Menyambung ke penyimpanan host dengan identitas.
AzureWebJobsStorage__accountName
Saat menggunakan koneksi penyimpanan berbasis identitas, atur nama akun akun penyimpanan alih-alih menggunakan string koneksi di AzureWebJobsStorage. Sintaks ini unik untuk AzureWebJobsStorage dan tidak dapat digunakan untuk koneksi berbasis identitas lainnya.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsStorage__accountName | <STORAGE_ACCOUNT_NAME> |
Untuk klaster awan sovereign atau saat menggunakan DNS kustom, Anda harus menggunakan pengaturan AzureWebJobsStorage__*ServiceUri yang khusus untuk layanan.
AzureWebJobsStorage__blobServiceUri
Saat menggunakan koneksi penyimpanan berbasis identitas, mengatur URI lapisan data dari layanan blob akun penyimpanan.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsStorage__blobServiceUri | https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net |
Gunakan pengaturan ini alih-alih AzureWebJobsStorage__accountName di sovereign cloud atau saat menggunakan DNS kustom. Untuk informasi lebih lengkap, lihat Menyambung ke penyimpanan host dengan identitas.
AzureWebJobsStorage__clientId
Mengatur ID klien dari identitas tertentu yang ditetapkan pengguna yang digunakan untuk mendapatkan token akses untuk autentikasi identitas terkelola. Mengharuskan AzureWebJobsStorage__credential diatur ke managedidentity. Nilainya adalah ID klien yang sesuai dengan identitas yang ditetapkan ke aplikasi. Anda tidak dapat mengatur dan AzureWebJobsStorage__managedIdentityResourceIdAzureWebJobsStorage__clientId. Ketika tidak diatur, identitas yang ditetapkan sistem digunakan.
AzureWebJobsStorage__credential
Menentukan bagaimana token akses diperoleh untuk koneksi. Gunakan managedidentity untuk autentikasi identitas terkelola. Saat menggunakan managedidentity, identitas terkelola harus tersedia di lingkungan hosting. Jangan diatur AzureWebJobsStorage__credential dalam skenario pengembangan lokal.
AzureWebJobsStorage__managedIdentityResourceId
Mengatur pengidentifikasi sumber daya identitas yang ditetapkan pengguna yang digunakan untuk mendapatkan token akses untuk autentikasi identitas terkelola. Mengharuskan AzureWebJobsStorage__credential diatur ke managedidentity. Nilainya adalah ID sumber daya identitas yang ditetapkan ke aplikasi yang digunakan untuk autentikasi identitas terkelola. Anda tidak dapat mengatur dan AzureWebJobsStorage__managedIdentityResourceIdAzureWebJobsStorage__clientId. Ketika tidak diatur, identitas yang ditetapkan sistem digunakan.
AzureWebJobsStorage__queueServiceUri
Saat menggunakan koneksi penyimpanan berbasis identitas, menetapkan URI bidang data untuk layanan antrean akun penyimpanan.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsStorage__queueServiceUri | https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net |
Gunakan pengaturan ini alih-alih AzureWebJobsStorage__accountName di sovereign cloud atau saat menggunakan DNS kustom. Untuk informasi lebih lengkap, lihat Menyambung ke penyimpanan host dengan identitas.
AzureWebJobsStorage__tableServiceUri
Saat menggunakan koneksi penyimpanan berbasis identitas, mengatur URI bidang data dari layanan tabel akun penyimpanan.
| Key | Nilai sampel |
|---|---|
| AzureWebJobsStorage__tableServiceUri | https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net |
Gunakan pengaturan ini alih-alih AzureWebJobsStorage__accountName di sovereign cloud atau saat menggunakan DNS kustom. Untuk informasi lebih lengkap, lihat Menyambung ke penyimpanan host dengan identitas.
AzureWebJobs_TypeScriptPath
Jalur ke kompiler yang digunakan untuk TypeScript. Membuat Anda dapat mengganti defaultnya jika perlu.
| Key | Nilai sampel |
|---|---|
| AzureWebJobs_TypeScriptPath | %HOME%\typescript |
DOCKER_REGISTRY_SERVER_PASSWORD
Menunjukkan kata sandi yang digunakan untuk mengakses registri kontainer privat. Pengaturan ini hanya diperlukan saat menyebarkan aplikasi fungsi kontainer Anda dari registri kontainer privat. Untuk informasi selengkapnya, lihat Variabel lingkungan dan pengaturan aplikasi di Azure App Service.
DOCKER_REGISTRY_SERVER_URL
Menunjukkan URL registri kontainer privat. Pengaturan ini hanya diperlukan saat menyebarkan aplikasi fungsi kontainer Anda dari registri kontainer privat. Untuk informasi selengkapnya, lihat Variabel lingkungan dan pengaturan aplikasi di Azure App Service.
DOCKER_REGISTRY_SERVER_USERNAME
Menunjukkan akun yang digunakan untuk mengakses registri kontainer privat. Pengaturan ini hanya diperlukan saat menyebarkan aplikasi fungsi kontainer Anda dari registri kontainer privat. Untuk informasi selengkapnya, lihat Variabel lingkungan dan pengaturan aplikasi di Azure App Service.
DOCKER_SHM_SIZE
Mengatur ukuran memori bersama (dalam byte) saat pekerja Python menggunakan memori bersama. Untuk mempelajari selengkapnya, lihat Memori bersama.
| Key | Nilai sampel |
|---|---|
| DOCKER_SHM_SIZE | 268435456 |
Nilai sebelumnya menetapkan ukuran memori bersama ~256 MB.
Mengharuskan FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED diatur ke 1.
ENABLE_ORYX_BUILD
Menunjukkan apakah sistem build Oryx digunakan selama penyebaran.
ENABLE_ORYX_BUILD harus diatur ke true saat melakukan penyebaran build jarak jauh ke Linux. Untuk informasi selengkapnya, lihat Pembangunan jarak jauh.
| Key | Nilai sampel |
|---|---|
| ENABLE_ORYX_BUILD | true |
FUNCTION_APP_EDIT_MODE
Menunjukkan apakah Anda dapat mengedit aplikasi fungsi di portal Microsoft Azure. Nilai yang berlaku adalah readwrite atau readonly.
| Key | Nilai sampel |
|---|---|
| FUNCTION_APP_EDIT_MODE | readonly |
Runtime mengatur nilai berdasarkan tumpukan bahasa dan status penyebaran aplikasi fungsi Anda. Untuk informasi selengkapnya, lihat Batasan pengembangan di portal Azure.
FUNCTIONS_EXTENSION_VERSION
Versi runtime Functions yang berfungsi sebagai host untuk aplikasi fungsi Anda. Tilde (~) dengan versi utama berarti gunakan versi terbaru dari versi utama tersebut, misalnya, ~4. Saat versi minor baru dari versi utama yang sama tersedia, versi tersebut secara otomatis diinstal di aplikasi fungsi.
| Key | Nilai sampel |
|---|---|
| FUNCTIONS_EXTENSION_VERSION | ~4 |
Nilai versi runtime utama berikut ini didukung:
| Value | Target waktu berjalan | Comment |
|---|---|---|
~4 |
4.x | Recommended |
~1 |
1.x | Dukungan berakhir 14 September 2026 |
Nilai ~4 berarti bahwa aplikasi Anda berjalan pada versi 4.x dari runtime. Nilai ~1 menyematkan aplikasi Anda ke dalam versi 1.x dari runtime. Runtime versi 2.x dan 3.x tidak lagi didukung. Untuk informasi selengkapnya, lihat Ikhtisar versi runtime Azure Functions.
Jika diminta oleh dukungan untuk menyematkan aplikasi Anda ke versi minor tertentu, gunakan nomor versi lengkap, misalnya, 4.0.12345. Untuk informasi selengkapnya, lihat Cara menargetkan versi runtime Azure Functions.
FUNCTIONS_INPROC_NET8_ENABLED
Menunjukkan apakah aplikasi dapat menggunakan .NET 8 pada model proses dalam. Untuk menggunakan .NET 8 pada model dalam proses, nilai ini harus diatur ke 1. Lihat Memperbarui ke target .NET 8 untuk instruksi lengkap, termasuk nilai konfigurasi lain yang diperlukan.
| Key | Nilai sampel |
|---|---|
| FUNCTIONS_INPROC_NET8_ENABLED | 1 |
Atur ke 0 untuk menonaktifkan dukungan untuk .NET 8 pada model dalam proses.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR
Pengaturan aplikasi ini adalah cara sementara bagi aplikasi Node.js untuk mengaktifkan perubahan besar yang memudahkan pemecahan masalah kesalahan pada titik masuk pada Node.js v18 atau lebih rendah. Kami sangat menyarankan penggunaan true, terutama untuk aplikasi model pemrograman v4, yang selalu menggunakan file titik masuk. Perilaku tanpa perubahan besar (false) mengabaikan kesalahan titik masuk dan tidak mencatatnya di Application Insights.
Dimulai dengan Node.js v20, pengaturan aplikasi tidak berpengaruh dan perilaku perubahan yang merusak selalu diaktifkan.
Untuk Node.js v18 atau yang lebih rendah, pengaturan aplikasi digunakan, dan perilaku default bergantung pada apakah kesalahan terjadi sebelum atau sesudah fungsi model v4 terdaftar:
- Jika kesalahan sebelumnya terjadi, perilaku default cocok dengan
false. Misalnya, jika Anda menggunakan model v3 atau file titik masuk Anda tidak ada. - Jika kesalahan dilemparkan setelahnya, perilaku bawaan cocok dengan
true. Misalnya, jika Anda mencoba mendaftarkan fungsi model duplikat v4.
| Key | Value | Description |
|---|---|---|
| FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR | true |
Blokir kesalahan titik masuk dan catat di Application Insights. |
| FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR | false |
Abaikan kesalahan poin masuk dan jangan mencatatnya di Application Insights. |
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT
Mengambil alih batas default pada ukuran isi permintaan yang dikirim ke titik akhir HTTP. Nilai diberikan dalam byte, dengan ukuran permintaan maksimum default 104.857.600 byte.
| Key | Nilai sampel |
|---|---|
| FUNCTIONS_REQUEST_BODY_SIZE_LIMIT | 250000000 |
FUNCTIONS_V2_COMPATIBILITY_MODE
Important
Pengaturan ini tidak lagi didukung. Awalnya disediakan untuk mengaktifkan solusi jangka pendek untuk aplikasi yang menargetkan runtime v2.x. Mereka akan dapat menggunakan runtime v3.x selama masih didukung. Kecuali untuk aplikasi warisan yang berjalan pada versi 1.x, semua aplikasi fungsi harus berjalan pada versi 4.x dari runtime Functions: FUNCTIONS_EXTENSION_VERSION=~4. Untuk informasi selengkapnya, lihat Ikhtisar versi runtime Azure Functions.
FUNCTIONS_WORKER_PROCESS_COUNT
Menentukan jumlah maksimum proses pekerja bahasa pemrograman, dengan nilai default 1. Nilai maksimum yang diperbolehkan adalah 10. Panggilan fungsi didistribusikan secara merata di antara proses pekerja bahasa pemrograman. Proses pekerja bahasa diluncurkan setiap 10 detik sampai jumlah yang ditetapkan oleh FUNCTIONS_WORKER_PROCESS_COUNT tercapai. Menggunakan beberapa proses pekerja bahasa bukanlah hal yang sama dengan penskalaan. Pertimbangkan untuk menggunakan pengaturan ini saat beban kerja Anda memiliki campuran pemanggilan CPU-terikat dan I/O-terikat. Pengaturan ini berlaku untuk semua runtime bahasa, kecuali untuk .NET yang berjalan dalam proses (FUNCTIONS_WORKER_RUNTIME=dotnet).
| Key | Nilai sampel |
|---|---|
| FUNCTIONS_WORKER_PROCESS_COUNT | 2 |
FUNCTIONS_WORKER_RUNTIME
Bahasa atau kumpulan bahasa runtime pekerja yang akan dimuat dalam aplikasi fungsi. Nilai ini sesuai dengan bahasa yang digunakan dalam aplikasi Anda, misalnya, python. Dimulai dengan runtime Azure Functions versi 2.x, aplikasi fungsi tertentu hanya dapat mendukung satu bahasa.
| Key | Nilai sampel |
|---|---|
| FUNCTIONS_WORKER_RUNTIME | node |
Nilai yang valid:
| Value | Lapisan Bahasa |
|---|---|
dotnet |
C# (pustaka kelas) C# (skrip) |
dotnet-isolated |
C# (proses pekerja terisolasi) |
java |
Java |
node |
JavaScript TypeScript |
powershell |
PowerShell |
python |
Python |
custom |
Other |
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED
Pengaturan ini memungkinkan pekerja Python menggunakan memori bersama untuk meningkatkan throughput. Aktifkan memori bersama saat aplikasi fungsi Python Anda mengalami penyempitan memori.
| Key | Nilai sampel |
|---|---|
| FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED | 1 |
Dengan mengaktifkan pengaturan ini, Anda dapat menggunakan pengaturan DOCKER_SHM_SIZE untuk mengatur ukuran memori bersama. Untuk mempelajari selengkapnya, lihat Memori bersama.
JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY
Menunjukkan apakah proses pekerja Java harus menghasilkan telemetri dalam format Telemetri Terbuka ke titik akhir Application Insights. Mengatur flag ini untuk True memberi tahu host Functions untuk membiarkan proses Java melakukan streaming log OpenTelemetry secara langsung, yang mencegah duplikasi entri pada tingkat host. Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan aplikasi.
JAVA_ENABLE_SDK_TYPES
Memungkinkan aplikasi fungsi Anda menggunakan jenis Azure SDK asli dalam pengikatan.
Note
Dukungan untuk pengikatan ke jenis SDK saat ini dalam pratinjau dan terbatas pada Azure Blob Storage SDK. Untuk informasi selengkapnya, lihat Jenis SDK di artikel referensi Java.
| Key | Nilai sampel |
|---|---|
| JAVA_ENABLE_SDK_TYPES | true |
Untuk informasi selengkapnya, lihat Jenis SDK di artikel referensi Java.
JAVA_OPTS
Digunakan untuk menyesuaikan komputer virtual Java (JVM) yang digunakan untuk menjalankan fungsi Java Anda saat berjalan pada paket Premium atau Paket khusus. Ketika menggunakan paket Konsumsi, gunakan languageWorkers__java__arguments sebagai gantinya. Untuk informasi selengkapnya, lihat Menyesuaikan JVM.
languageWorkers__java__arguments
Digunakan untuk menyesuaikan komputer virtual Java (JVM) yang digunakan untuk menjalankan fungsi Java Anda saat berjalan pada paket Konsumsi. Pengaturan ini memang meningkatkan waktu awal dingin untuk fungsi Java yang berjalan dalam rencana konsumsi. Untuk paket Premium atau Khusus, sebagai gantinya gunakan JAVA_OPTS. Untuk informasi selengkapnya, lihat Menyesuaikan JVM.
MDMaxBackgroundUpgradePeriod
Mengontrol periode pembaruan latar belakang dependensi terkelola untuk aplikasi fungsi PowerShell, dengan nilai default 7.00:00:00 (mingguan).
Setiap proses pekerja PowerShell memulai pemeriksaan pembaruan modul pada Galeri PowerShell saat proses dimulai dan setiap MDMaxBackgroundUpgradePeriod setelahnya. Saat versi modul baru tersedia di Galeri PowerShell, modul tersebut diinstal ke sistem file dan tersedia untuk pekerja PowerShell. Mengurangi nilai ini memungkinkan aplikasi fungsi Anda mendapatkan versi modul yang lebih baru lebih cepat, tetapi juga meningkatkan penggunaan sumber daya aplikasi, termasuk I/O jaringan, CPU, dan penyimpanan. Meningkatkan nilai ini mengurangi penggunaan sumber daya aplikasi, tetapi juga dapat menunda pengiriman versi modul baru ke aplikasi Anda.
| Key | Nilai sampel |
|---|---|
| MDMaxBackgroundUpgradePeriod | 7.00:00:00 |
Untuk mempelajari lebih lanjut, lihat Manajemen dependensi.
MDNewSnapshotCheckPeriod
Menentukan seberapa sering setiap pekerja PowerShell memeriksa apakah peningkatan dependensi terkelola diinstal. Frekuensi defaultnya adalah 01:00:00 (per jam).
Setelah versi modul baru diinstal ke sistem file, setiap proses pekerja PowerShell harus dimulai ulang. Memulai ulang pekerja PowerShell memengaruhi ketersediaan aplikasi Anda karena dapat mengganggu eksekusi fungsi saat ini. Hingga semua proses pekerja PowerShell dimulai ulang, pemanggilan fungsi dapat menggunakan versi modul lama atau baru. Memulai ulang semua pekerja PowerShell selesai dalam MDNewSnapshotCheckPeriod.
Dalam setiap MDNewSnapshotCheckPeriod, pekerja PowerShell memeriksa apakah peningkatan dependensi yang dikelola terinstal atau tidak. Saat pembaruan diinstal, komputer akan dimulai ulang. Meningkatkan nilai ini mengurangi frekuensi gangguan karena restart. Namun, peningkatan juga dapat meningkatkan waktu selama pemanggilan fungsi dapat menggunakan versi modul lama atau baru, secara nondeterministik.
| Key | Nilai sampel |
|---|---|
| MDNewSnapshotCheckPeriod | 01:00:00 |
Untuk mempelajari lebih lanjut, lihat Manajemen dependensi.
MDMinBackgroundUpgradePeriod
Jangka waktu setelah pemeriksaan pemutakhiran dependensi terkelola sebelumnya, sebelum pemeriksaan pemutakhiran berikutnya dimulai, dengan default 1.00:00:00 (harian).
Untuk menghindari peningkatan modul yang berlebihan pada pemulaian ulang Pekerja yang sering, memeriksa peningkatan modul tidak dilakukan ketika pekerja apa pun sudah memulai pemeriksaan tersebut di terakhir MDMinBackgroundUpgradePeriod.
| Key | Nilai sampel |
|---|---|
| MDMinBackgroundUpgradePeriod | 1.00:00:00 |
Untuk mempelajari lebih lanjut, lihat Manajemen dependensi.
OTEL_EXPORTER_OTLP_ENDPOINT
Menunjukkan URL tempat data berformat OpenTelemetry diekspor untuk penyerapan. Untuk informasi selengkapnya, lihat Menggunakan OpenTelemetry dengan Azure Functions.
OTEL_EXPORTER_OTLP_HEADERS
Mengatur daftar header opsional yang diterapkan ke semua data keluar yang diekspor ke titik akhir OpenTelemetry. Anda harus menggunakan pengaturan ini ketika titik akhir OpenTelemetry perlu menyediakan kunci API. Untuk informasi selengkapnya, lihat Menggunakan OpenTelemetry dengan Azure Functions.
PIP_INDEX_URL
Pengaturan ini memungkinkan Anda mengambil alih URL dasar Indeks Paket Python, yang secara default adalah https://pypi.org/simple. Gunakan pengaturan ini saat Anda perlu menjalankan build jarak jauh menggunakan dependensi kustom. Dependensi kustom ini dapat berada dalam repositori indeks paket yang sesuai dengan PEP 503 (API repositori sederhana) atau dalam direktori lokal yang mengikuti format yang sama.
| Key | Nilai sampel |
|---|---|
| PIP_INDEX_URL | http://my.custom.package.repo/simple |
Untuk mempelajari selengkapnya, lihat dokumentasi pip untuk --index-url dan menggunakan dependensi yang disesuaikan dalam referensi pengembang Python.
PIP_EXTRA_INDEX_URL
Nilai untuk pengaturan ini menunjukkan URL indeks tambahan untuk paket kustom untuk aplikasi Python, untuk digunakan selain --index-url. Gunakan pengaturan ini saat Anda perlu menjalankan build jarak jauh menggunakan dependensi kustom yang ditemukan dalam indeks paket tambahan. Harus mengikuti aturan yang sama dengan --index-url.
| Key | Nilai sampel |
|---|---|
| PIP_EXTRA_INDEX_URL | http://my.custom.package.repo/simple |
Untuk mempelajari selengkapnya, lihat dokumentasi pip untuk --extra-index-urlDependensi kustom di dalam referensi pengembang Python.
PROJECT
Pengaturan penyebaran berkelanjutan yang memberi tahu layanan penyebaran Kudu tentang folder di dalam repositori yang terhubung untuk lokasi proyek yang dapat disebarkan.
| Key | Nilai sampel |
|---|---|
| PROJECT | WebProject/WebProject.csproj |
PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY
Menunjukkan apakah proses pekerja Python harus menghasilkan telemetri dalam format Telemetri Terbuka ke titik akhir Application Insights. Mengatur bendera ini untuk True memberi tahu host Functions untuk membiarkan proses pekerja Python mengekspor data OpenTelemetry ke titik akhir Application Insights. Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan aplikasi.
PYTHON_ISOLATE_WORKER_DEPENDENCIES
Konfigurasi ini khusus untuk aplikasi fungsi Python. Ini mendefinisikan penentuan prioritas urutan pemuatan modul. Secara default, nilai ini diset ke 0.
| Key | Value | Description |
|---|---|---|
| PYTHON_ISOLATE_WORKER_DEPENDENCIES | 0 |
Prioritaskan melakukan pemuatan pustaka Python dari dependensi pekerja internal Python, yang merupakan perilaku default. Pustaka non-Microsoft yang ditentukan dalam requirements.txt mungkin tertutupi. |
| PYTHON_ISOLATE_WORKER_DEPENDENCIES | 1 |
Prioritaskan memuat pustaka Python dari paket aplikasi yang ditentukan dalam requirements.txt. Nilai ini mencegah pustaka Anda bertabrakan dengan pustaka pekerja Python internal. |
PYTHON_ENABLE_DEBUG_LOGGING
Mengaktifkan pengelogan tingkat debug di aplikasi fungsi Python. Nilai 1 memungkinkan pencatatan log tingkat debug. Tanpa pengaturan ini atau dengan nilai 0, hanya informasi dan log tingkat yang lebih tinggi yang dikirim dari pekerja Python ke host Functions. Gunakan pengaturan ini saat menelusuri kesalahan atau melacak eksekusi fungsi Python Anda.
Saat men-debug fungsi Python, pastikan juga untuk mengatur tingkat debug atau penelusuran level logging di file host.json sesuai kebutuhan. Untuk mempelajari selengkapnya, lihat Cara mengonfigurasi pemantauan untuk Azure Functions.
PYTHON_ENABLE_OPENTELEMETRY
Menunjukkan apakah proses pekerja Python harus mengirim telemetri ke titik akhir Telemetri Terbuka. Mengatur flag ini ke True menginstruksikan host Functions untuk mengizinkan proses pekerja Python mengekspor data OpenTelemetry ke OTEL_EXPORTER_OTLP_ENDPOINT yang telah dikonfigurasi. Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan aplikasi.
PYTHON_ENABLE_WORKER_EXTENSIONS
Konfigurasi ini khusus untuk aplikasi fungsi Python. Mengatur nilai ini untuk 1 memungkinkan pekerja memuat ekstensi pekerja Python yang ditentukan dalam requirements.txt. Ini memungkinkan aplikasi fungsi Anda untuk mengakses fitur baru yang disediakan oleh paket mitra. Ini juga dapat mengubah perilaku beban fungsi dan pemanggilan di aplikasi Anda. Pastikan ekstensi yang Anda pilih dapat dipercaya karena Anda menanggung risiko menggunakannya. Azure Functions tidak memberikan jaminan tegas ke ekstensi apa pun. Untuk cara menggunakan ekstensi, kunjungi halaman manual ekstensi atau dokumen readme. Secara default, nilai ini diatur ke 0.
| Key | Value | Description |
|---|---|---|
| PYTHON_ENABLE_WORKER_EXTENSIONS | 0 |
Nonaktifkan ekstensi worker Python apa pun. |
| PYTHON_ENABLE_WORKER_EXTENSIONS | 1 |
Izinkan worker Python memuat ekstensi dari file requirements.txt. |
PYTHON_THREADPOOL_THREAD_COUNT
Menentukan jumlah maksimum utas yang akan digunakan pekerja Python untuk menjalankan pemanggilan fungsi 1, dengan nilai default 1 untuk versi Python dan di bawahnya. Untuk versi Python 3.9 ke atas, nilainya diatur ke None. Pengaturan ini tidak menjamin jumlah utas yang akan dikonfigurasi selama proses eksekusi. Pengaturan ini membuat Python dapat memperluas jumlah alur ke nilai yang ditentukan. Pengaturan ini hanya berlaku untuk aplikasi fungsi Python. Selain itu, pengaturan ini berlaku untuk pemanggilan fungsi sinkron dan bukan untuk korutina.
| Key | Nilai sampel | Nilai maks |
|---|---|---|
| PYTHON_THREADPOOL_THREAD_COUNT | 2 | 32 |
SCALE_CONTROLLER_LOGGING_ENABLED
Setelan ini sedang dalam pratinjau.
Pengaturan ini mengontrol pencatatan dari pengontrol skala Azure Functions. Untuk informasi selengkapnya, lihat Log pengontrol Skala.
| Key | Nilai sampel |
|---|---|
| SCALE_CONTROLLER_LOGGING_ENABLED | AppInsights:Verbose |
Nilai untuk kunci ini disediakan dalam format <DESTINATION>:<VERBOSITY>, yang didefinisikan sebagai berikut:
| Property | Description |
|---|---|
<DESTINATION> |
Tujuan pengiriman log. Nilai yang berlaku adalah AppInsights atau Blob.Saat Anda menggunakan AppInsights, pastikan Application Insights diaktifkan di aplikasi fungsi Anda.Ketika Anda mengatur tujuan ke Blob, log dibuat dalam kontainer gumpalan bernama azure-functions-scale-controller dalam akun penyimpanan default yang diatur dalam pengaturan aplikasi AzureWebJobsStorage. |
<VERBOSITY> |
Menentukan tingkat log. Nilai yang didukung adalah None, Warning, dan Verbose.Ketika diatur ke Verbose, pengontrol skala mencatat alasan untuk setiap perubahan dalam jumlah pekerja, serta informasi tentang pemicu yang memperhitungkan keputusan tersebut. Log verbose termasuk peringatan pemicu dan hash yang digunakan oleh pemicu sebelum dan sesudah pengontrol skala berjalan. |
Tip
Perlu diingat bahwa saat Anda membiarkan pencatatan pengontrol skala diaktifkan, itu berdampak pada biaya potensial untuk memantau aplikasi fungsi Anda. Pertimbangkan untuk mengaktifkan pengelogan hingga Anda mengumpulkan cukup data untuk memahami bagaimana pengontrol skala bereaksi, lalu menonaktifkannya.
SCM_DO_BUILD_DURING_DEPLOYMENT
Mengontrol perilaku pembangunan jarak jauh selama pemasangan. Ketika SCM_DO_BUILD_DURING_DEPLOYMENT diatur ke true, proyek dibangun secara remote selama penyebaran.
| Key | Nilai sampel |
|---|---|
| SCM_DO_BUILD_DURING_DEPLOYMENT | true |
SCM_LOGSTREAM_TIMEOUT
Kontrol batas waktu, dalam hitungan detik, saat tersambung ke log streaming. Nilai default adalah 7200 (2 jam).
| Key | Nilai sampel |
|---|---|
| SCM_LOGSTREAM_TIMEOUT | 1800 |
Nilai 1800 sampel sebelumnya menetapkan batas waktu 30 menit. Untuk informasi selengkapnya, lihat Mengaktifkan log eksekusi streaming di Azure Functions.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
String koneksi untuk akun penyimpanan di mana kode dan konfigurasi aplikasi fungsi disimpan dalam rencana penskalaan berbasis peristiwa. Untuk informasi selengkapnya, lihat Pengaturan koneksi akun penyimpanan.
| Key | Nilai sampel |
|---|---|
| WEBSITE_CONTENTAZUREFILECONNECTIONSTRING | DefaultEndpointsProtocol=https;AccountName=... |
Pengaturan ini diperlukan untuk aplikasi paket Konsumsi dan Premium Elastis. Ini tidak diperlukan untuk aplikasi paket Khusus, di mana Functions tidak diskalakan secara dinamis.
Paket Konsumsi Flex sekarang menjadi paket hosting tanpa server yang direkomendasikan untuk Azure Functions. Ini menawarkan penskalakan yang lebih cepat, mengurangi cold start, jaringan privat, dan lebih banyak kontrol atas performa dan biaya. Untuk informasi selengkapnya, lihat Paket Konsumsi Flex.
Mengubah atau menghapus pengaturan ini dapat menyebabkan aplikasi fungsi Anda tidak dimulai. Untuk mempelajari selengkapnya, lihat artikel pemecahan masalah ini.
Azure Files tidak mendukung penggunaan identitas terkelola saat mengakses berbagi file. Untuk informasi selengkapnya, lihat Skenario autentikasi yang didukung Azure Files.
WEBSITE_CONTENTOVERVNET
Important
WEBSITE_CONTENTOVERVNET adalah pengaturan aplikasi lama yang telah digantikan oleh properti situs vnetContentShareEnabled.
Nilai 1 memungkinkan aplikasi fungsi Anda untuk menskalakan di seluruh stempel saat akun penyimpanan Anda dibatasi ke jaringan virtual. Anda harus mengaktifkan pengaturan ini saat membatasi akun penyimpanan Anda ke jaringan virtual. Hanya diperlukan saat menggunakan WEBSITE_CONTENTSHARE dan WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Untuk mempelajari selengkapnya, lihat Membatasi akun penyimpanan Anda ke jaringan virtual.
| Key | Nilai sampel |
|---|---|
| WEBSITE_CONTENTOVERVNET | 1 |
Pengaturan aplikasi ini diperlukan untuk penskalaan lintas stempel pada paket Elastic Premium dan Dedicated (App Service) (Standar dan lebih tinggi) ketika akun penyimpanan dibatasi oleh VNet. Tanpa pengaturan ini, aplikasi fungsi hanya dapat menskalakan dalam satu stempel (sekitar 1-20 instans). Tidak didukung untuk digunakan pada paket Konsumsi.
Note
Anda harus berhati-hati saat mengakses berbagi konten penyimpanan di akun penyimpanan yang dibagikan oleh beberapa aplikasi fungsi dalam paket yang sama. Untuk informasi selengkapnya, lihat Perutean yang konsisten melalui jaringan virtual di artikel Pertimbangan penyimpanan.
WEBSITE_CONTENTSHARE
Nama berbagi file yang digunakan Functions untuk menyimpan kode aplikasi fungsi dan file konfigurasi. Konten ini diperlukan oleh rencana penskalakan berbasis peristiwa. Digunakan dengan WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Default merupakan string unik yang dihasilkan oleh runtime, yang dimulai dengan nama fungsi aplikasi. Untuk informasi selengkapnya, lihat Pengaturan koneksi akun penyimpanan.
| Key | Nilai sampel |
|---|---|
| WEBSITE_CONTENTSHARE | functionapp091999e2 |
Pengaturan ini hanya diperlukan untuk aplikasi paket Konsumsi dan Premium. Pengaturan ini tidak diwajibkan bagi aplikasi pada Paket Khusus, yang tidak diskalakan secara dinamis oleh Functions.
Paket Konsumsi Flex sekarang menjadi paket hosting tanpa server yang direkomendasikan untuk Azure Functions. Ini menawarkan penskalakan yang lebih cepat, mengurangi cold start, jaringan privat, dan lebih banyak kontrol atas performa dan biaya. Untuk informasi selengkapnya, lihat Paket Konsumsi Flex.
Pembagian dibuat saat aplikasi fungsi Anda dibuat. Mengubah atau menghapus pengaturan ini dapat menyebabkan aplikasi fungsi Anda tidak dimulai. Untuk mempelajari selengkapnya, lihat artikel pemecahan masalah ini.
Pertimbangan berikut berlaku saat menggunakan templat Azure Resource Manager (ARM) atau file Bicep untuk membuat aplikasi fungsi selama penyebaran:
- Saat Anda tidak menetapkan nilai
WEBSITE_CONTENTSHAREuntuk aplikasi fungsi utama atau aplikasi apa pun di slot, nilai berbagi unik dibuat untuk Anda. Tidak menyetelWEBSITE_CONTENTSHAREadalah pendekatan yang direkomendasikan untuk penyebaran templat ARM. - Ada skenario di mana Anda harus mengatur
WEBSITE_CONTENTSHAREnilai ke nilai yang telah ditentukan sebelumnya, seperti saat Anda menggunakan akun penyimpanan aman di jaringan virtual. Dalam hal ini, Anda harus menetapkan nama berbagi yang unik untuk aplikasi fungsi utama dan aplikasi pada setiap slot penyebaran. Untuk akun penyimpanan yang diamankan oleh jaringan virtual, Anda juga harus membuat share itu sendiri untuk penyebaran otomatis Anda. Untuk informasi selengkapnya, lihat Penyebaran yang aman. - Jangan jadikan
WEBSITE_CONTENTSHAREsebagai pengaturan slot. - Saat Anda menentukan
WEBSITE_CONTENTSHARE, nilainya harus mengikuti pedoman berikut ini mengenai nama berbagi sumber daya.
WEBSITE_DNS_SERVER
Mengatur server DNS yang digunakan oleh aplikasi saat menyelesaikan alamat IP. Pengaturan ini sering diperlukan saat menggunakan fungsionalitas jaringan tertentu, seperti Zona privat Azure DNS dan titik akhir privat.
| Key | Nilai sampel |
|---|---|
| WEBSITE_DNS_SERVER | 168.63.129.16 |
WEBSITE_ENABLE_BROTLI_ENCODING
Mengontrol apakah pengkodean Brotli digunakan untuk kompresi alih-alih kompresi gzip default. Ketika WEBSITE_ENABLE_BROTLI_ENCODING diatur ke 1, pengodean Brotli digunakan. Jika tidak, pengodean gzip digunakan.
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED
Menonaktifkan cache saat menerapkan fungsi aplikasi menggunakan templat Azure Resource Manager (ARM).
| Key | Nilai sampel |
|---|---|
| WEBSITE_FUNCTIONS_ARMCACHE_ENABLED | 0 |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT
Jumlah maksimum instans yang dapat diperluas skalanya oleh aplikasi. Pengaturan awalnya adalah tanpa batas.
Important
Pengaturan ini dalam tahap pratinjau. Properti aplikasi untuk peluasan skala maks fungsi sekarang ada. Kami merekomendasikan properti ini untuk membatasi peluasan skala.
| Key | Nilai sampel |
|---|---|
| WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT | 5 |
WEBSITE_NODE_DEFAULT_VERSION
Hanya sistem operasi Windows.
Mengatur versi aplikasi Node.js digunakan saat menjalankan aplikasi fungsi Anda di Windows. Anda harus menggunakan tilde (~) agar runtime menggunakan versi terbaru yang tersedia dari versi utama yang ditargetkan. Misalnya, ketika diatur ke ~18, versi terbaru Node.js 18 digunakan. Saat versi utama ditargetkan dengan tilde, Anda tidak perlu memperbarui versi minor secara manual.
| Key | Nilai sampel |
|---|---|
| WEBSITE_NODE_DEFAULT_VERSION | ~18 |
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS
Saat Anda melakukan pertukaran slot pada aplikasi fungsi yang berjalan pada paket Premium, pertukaran dapat gagal saat akun penyimpanan khusus yang digunakan oleh aplikasi dibatasi jaringan. Kegagalan ini disebabkan oleh fitur pengelogan aplikasi warisan, yang digunakan bersama oleh Functions dan App Service. Pengaturan ini mengambil alih fitur pengelogan warisan dan memungkinkan pertukaran terjadi.
| Key | Nilai sampel |
|---|---|
| WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS | 0 |
Tambahkan WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS dengan nilai 0 ke semua slot untuk memastikan pengaturan diagnostik lama tidak memblokir pertukaran Anda. Anda juga dapat menambahkan pengaturan dan nilai ini hanya pada slot produksi sebagai pengaturan slot penyebaran (menetap).
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS
Secara bawaan, pengaturan versi untuk aplikasi fungsi tersebut bersifat khusus untuk setiap slot. Pengaturan ini digunakan saat meningkatkan fungsi dengan menggunakan slot penempatan. Pendekatan ini mencegah perilaku yang tidak terduga karena perubahan versi setelah pertukaran. Atur ke 0 dalam lingkungan produksi dan dalam slot untuk memastikan bahwa semua pengaturan versi ditukar. Untuk informasi selengkapnya, lihat Peningkatan dengan slot.
| Key | Nilai sampel |
|---|---|
| WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS | 0 |
WEBSITE_RUN_FROM_PACKAGE
Memungkinkan aplikasi fungsi Anda berjalan dari file paket, yang dapat dipasang atau disebarkan secara lokal ke URL eksternal.
| Key | Nilai sampel |
|---|---|
| WEBSITE_RUN_FROM_PACKAGE | 1 |
Nilai yang valid adalah baik URL yang mengarah ke lokasi file paket penyebaran eksternal, atau 1. Ketika diatur ke 1, paket harus berada di folder d:\home\data\SitePackages. Saat Anda menggunakan penyebaran zip dengan WEBSITE_RUN_FROM_PACKAGE diaktifkan, paket secara otomatis diunggah ke lokasi ini. Untuk informasi selengkapnya, lihat Menjalankan fungsi Anda dari file paket.
Saat Anda menggunakan WEBSITE_RUN_FROM_PACKAGE=<URL>, URL harus diselesaikan ke lokasi file paket di lokasi penyimpanan yang dapat diakses, seperti kontainer Azure Blob Storage. Kontainer harus bersifat privat untuk mencegah akses yang tidak sah, yang mengharuskan Anda menggunakan tanda tangan akses bersama (SAS) di URL atau autentikasi ID Microsoft Entra untuk mengizinkan akses. Menggunakan ID Microsoft Entra dengan identitas terkelola disarankan.
Ini adalah contoh pengaturan WEBSITE_RUN_FROM_PACKAGE ke URL paket penyebaran dalam kontainer Azure Blog Storage:
WEBSITE_RUN_FROM_PACKAGE=https://contosostorageaccount.blob.core.windows.net/mycontainer/mypackage.zip
Saat menggunakan SAS, Anda menambahkan token ke URL sebagai parameter kueri.
Saat Anda menyebarkan paket dari Azure Blob Storage menggunakan identitas terkelola yang ditetapkan pengguna, Anda juga harus mengatur WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID ke ID sumber daya identitas terkelola yang ditetapkan pengguna. Saat menyebarkan dari URL paket eksternal, Anda juga harus menyinkronkan pemicu secara manual. Untuk informasi selengkapnya, lihat Sinkronisasi pemicu.
WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID
Menunjukkan ID sumber daya identitas terkelola yang ditetapkan pengguna yang digunakan saat mengakses paket penyebaran dari kontainer Azure Blob Storage eksternal yang diamankan menggunakan ID Microsoft Entra. Pengaturan ini mengharuskan diatur WEBSITE_RUN_FROM_PACKAGE ke URL paket penyebaran dalam kontainer privat.
Pengaturan WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID=SystemAssigned sama dengan menghilangkan pengaturan, dalam hal ini identitas terkelola yang ditetapkan sistem untuk aplikasi digunakan.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION
Pengaturan WEBSITE_CONTENTAZUREFILECONNECTIONSTRING dan WEBSITE_CONTENTSHARE memiliki pemeriksaan validasi tambahan untuk memastikan bahwa aplikasi dapat dimulai dengan benar. Pembuatan pengaturan aplikasi gagal ketika aplikasi fungsi tidak dapat memanggil Akun Penyimpanan hilir atau Key Vault dengan benar karena kendala jaringan atau faktor pembatas lainnya. Ketika WEBSITE_SKIP_CONTENTSHARE_VALIDATION diatur ke 1, pemeriksaan validasi dilewati. Jika tidak, nilai akan diatur ke 0 dan validasi dilakukan.
| Key | Nilai sampel |
|---|---|
| WEBSITE_SKIP_CONTENTSHARE_VALIDATION | 1 |
Jika validasi dilewatkan dan baik string koneksi atau penyimpanan konten tidak valid, aplikasi tidak dapat dimulai dengan semestinya. Dalam hal ini, fungsi mengembalikan kesalahan HTTP 500. Untuk informasi selengkapnya, lihat Memecahkan masalah kesalahan: "Runtime Azure Functions tidak dapat dijangkau".
WEBSITE_SLOT_NAME
Read-only. Nama slot penyebaran saat ini. Nama slot produksi adalah Production.
| Key | Nilai sampel |
|---|---|
| WEBSITE_SLOT_NAME | Production |
WEBSITE_TIME_ZONE
Memungkinkan Anda mengatur zona waktu untuk aplikasi fungsi Anda.
| Key | OS | Nilai sampel |
|---|---|---|
| WEBSITE_TIME_ZONE | Windows | Eastern Standard Time |
| WEBSITE_TIME_ZONE | Linux | America/New_York |
Zona waktu yang digunakan dengan ekspresi CRON adalah Waktu Universal Terkoordinasi (UTC). Agar ekspresi CRON Anda berjalan berdasarkan zona waktu lain, buat setelan aplikasi untuk aplikasi fungsi Anda yang bernama WEBSITE_TIME_ZONE.
Nilai pengaturan ini bergantung pada sistem operasi dan rencana tempat aplikasi fungsi Anda berjalan.
| Sistem operasi | Plan | Value |
|---|---|---|
| Windows | All | Atur nilai ke nama zona waktu yang diinginkan sesuai dengan baris kedua dari setiap pasangan yang dihasilkan oleh perintah Windows tzutil.exe /L |
| Linux | Premium Dedicated |
Atur nilai ke nama zona waktu yang diinginkan seperti yang ditunjukkan dalam database tz |
Note
WEBSITE_TIME_ZONE dan TZ saat ini tidak didukung ketika berjalan di Linux dalam rencana Flex Konsumsi atau Konsumsi. Dalam hal ini, pengaturan WEBSITE_TIME_ZONE atau TZ dapat membuat masalah terkait SSL dan menyebabkan metrik berhenti berfungsi untuk aplikasi Anda.
Misalnya, Waktu Timur di AS (diwakili oleh Eastern Standard Time (Windows) atau America/New_York (Linux)) saat ini menggunakan UTC-05:00 selama waktu standar dan UTC-04:00 selama siang hari. Untuk memiliki pemicu timer aktif pada pukul 10.00 Waktu Bagian Timur setiap hari, buat pengaturan aplikasi untuk aplikasi fungsi milik Anda bernama WEBSITE_TIME_ZONE, atur nilainya menjadi Eastern Standard Time (Windows) atau America/New_York (Linux), lalu gunakan ekspresi NCRONTAB berikut ini:
"0 0 10 * * *"
Saat Anda menggunakan WEBSITE_TIME_ZONE, waktu disesuaikan untuk perubahan waktu dalam zona waktu tertentu, termasuk waktu musim panas dan perubahan waktu standar.
WEBSITE_USE_PLACEHOLDER
Menunjukkan apakah akan menggunakan pengoptimalan cold start tertentu saat berjalan pada rencana Konsumsi. Atur ke 0 untuk mematikan pengoptimalan cold-start pada rencana Konsumsi.
| Key | Nilai sampel |
|---|---|
| WEBSITE_USE_PLACEHOLDER | 1 |
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED
Menunjukkan apakah akan menggunakan pengoptimalan mulai dingin tertentu saat menjalankan fungsi proses pekerja terisolasi .NET pada rencana konsumsi. Atur ke 0 untuk mematikan pengoptimalan cold-start pada rencana Konsumsi.
| Key | Nilai sampel |
|---|---|
| WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED | 1 |
WEBSITE_VNET_ROUTE_ALL
Important
WEBSITE_VNET_ROUTE_ALL adalah pengaturan aplikasi warisan yang telah digantikan oleh pengaturan situs vnetRouteAllEnabled .
Menunjukkan apakah semua lalu lintas keluar dari aplikasi dijalankan melalui jaringan virtual. Nilai 1 pengaturan menunjukkan bahwa semua lalu lintas aplikasi dirutekan melalui jaringan virtual. Anda memerlukan pengaturan ini saat mengonfigurasi integrasi jaringan virtual Regional dalam paket hosting Elastic Premium dan Dedicated. Ini juga digunakan ketika jaringan virtual NAT gateway digunakan untuk menentukan alamat IP keluar statis.
| Key | Nilai sampel |
|---|---|
| WEBSITE_VNET_ROUTE_ALL | 1 |
WEBSITES_ENABLE_APP_SERVICE_STORAGE
Menunjukkan apakah direktori /home dibagikan di seluruh instans berskala, dengan nilai default true. Anda harus mengatur nilai ini ke false saat menyebarkan aplikasi fungsi Anda dalam kontainer.
Pengaturan situs App Service
Beberapa konfigurasi harus dipertahankan di tingkat App Service sebagai pengaturan situs, seperti versi bahasa. Pengaturan ini dikelola di portal Microsoft Azure, dengan menggunakan REST API, atau dengan menggunakan Azure CLI atau Azure PowerShell. Berikut ini adalah pengaturan situs yang mungkin diperlukan, tergantung pada bahasa runtime, OS, dan versi Anda.
AcrUseManagedIdentityCreds
Menunjukkan apakah gambar diperoleh dari instans Azure Container Registry menggunakan autentikasi identitas terkelola. Nilai true mengharuskan Anda menggunakan identitas terkelola. Kami merekomendasikan pendekatan ini lebih dari kredensial autentikasi yang disimpan sebagai praktik keamanan terbaik.
AcrUserManagedIdentityID
Menunjukkan identitas terkelola yang akan digunakan saat mendapatkan gambar dari instans Azure Container Registry. Memerlukan agar AcrUseManagedIdentityCreds diatur ke true. Nilai-nilai ini valid:
| Value | Description |
|---|---|
system |
Identitas terkelola yang diberikan sistem untuk aplikasi fungsi ini digunakan. |
<USER_IDENTITY_RESOURCE_ID> |
ID sumber daya yang sepenuhnya memenuhi syarat dari identitas terkelola yang ditetapkan pengguna. |
Identitas yang Anda tentukan harus ditambahkan ke dalam peran ACRPull dalam registri kontainer. Untuk informasi selengkapnya, lihat Membuat dan mengonfigurasi aplikasi fungsi di Azure dengan gambar.
alwaysOn
Pada aplikasi fungsi yang berjalan dalam paket didedikasikan (App Service), runtime Functions menjadi tidak aktif setelah beberapa menit tidak ada aktivitas, pada titik ini hanya permintaan ke pemicu HTTP yang membangunkan aplikasi fungsi Anda. Untuk memastikan bahwa fungsi yang dipicu non-HTTP Anda berfungsi dengan benar, termasuk fungsi pemicu Timer, aktifkan Always On untuk aplikasi fungsi dengan mengatur pengaturan situs alwaysOn ke nilai true.
functionsRuntimeAdminIsolationEnabled
Menentukan apakah titik akhir administrator bawaan (/admin) di aplikasi fungsi Anda dapat diakses. Saat diatur ke false (default), aplikasi memungkinkan permintaan ke titik akhir di bawah /admin ketika permintaan tersebut menyajikan kunci master dalam permintaan. Ketika true dan /admin endpoint tidak dapat diakses, bahkan dengan kunci master.
Properti ini tidak dapat diatur untuk aplikasi yang berjalan di Linux dalam paket Konsumsi. Ini tidak dapat diatur untuk aplikasi yang berjalan di Azure Functions versi 1.x. Jika Anda menggunakan versi 1.x, Anda harus terlebih dahulu bermigrasi ke versi 4.x.
Paket Konsumsi Flex sekarang menjadi paket hosting tanpa server yang direkomendasikan untuk Azure Functions. Ini menawarkan penskalakan yang lebih cepat, mengurangi cold start, jaringan privat, dan lebih banyak kontrol atas performa dan biaya. Untuk informasi selengkapnya, lihat Paket Konsumsi Flex.
linuxFxVersion
Untuk aplikasi fungsi yang berjalan di Linux, linuxFxVersion menunjukkan bahasa dan versi untuk proses pekerja yang spesifik bahasa. Informasi ini digunakan, bersama dengan FUNCTIONS_EXTENSION_VERSION, untuk menentukan gambar kontainer Linux tertentu mana yang diinstal untuk menjalankan aplikasi fungsi Anda. Pengaturan ini dapat diatur ke nilai yang telah ditentukan sebelumnya atau URI gambar kustom.
Nilai ini diatur untuk Anda saat membuat aplikasi Function Linux. Anda mungkin perlu mengaturnya untuk templat ARM, penyebaran Bicep, dan dalam skenario peningkatan tertentu.
Nilai linuxFxVersion yang valid
Anda bisa menggunakan perintah Azure CLI berikut untuk melihat tabel nilai saat ini linuxFxVersion , dengan versi runtime Functions yang didukung:
az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table
Perintah sebelumnya mengharuskan Anda untuk meningkatkan ke versi 2.40 dari Azure CLI.
Gambar kustom
Saat Anda membuat dan memelihara kontainer Linux kustom Anda sendiri untuk aplikasi fungsi Anda, linuxFxVersion nilainya adalah sebagai gantinya dalam format DOCKER|<IMAGE_URI>, seperti dalam contoh berikut:
linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"
Contoh ini menunjukkan sumber registri kontainer yang disebarkan. Untuk informasi selengkapnya, lihat Bekerja dengan kontainer dan Azure Functions.
Important
Saat membuat kontainer sendiri, Anda diharuskan untuk menjaga gambar dasar kontainer Anda diperbarui ke gambar dasar terbaru yang didukung. Gambar dasar yang didukung untuk Azure Functions tergantung pada bahasa. Lihat repositori gambar dasar Azure Functions.
Tim Functions berkomitmen untuk menerbitkan pembaruan bulanan untuk gambar dasar ini. Pembaruan reguler meliputi pembaruan versi minor terbaru dan perbaikan keamanan untuk runtime Functions dan bahasa. Anda harus memperbarui kontainer Anda secara teratur dari gambar dasar terbaru dan menyebarkan ulang versi kontainer Anda yang diperbarui. Untuk informasi selengkapnya, lihat Memelihara kontainer kustom.
netFrameworkVersion
Mengatur versi spesifik .NET untuk fungsi C#. Untuk informasi selengkapnya, lihat Memperbarui aplikasi fungsi Anda di Azure.
powerShellVersion
Mengatur versi PowerShell tertentu tempat fungsi Anda berjalan. Untuk informasi selengkapnya, lihat Mengubah versi PowerShell.
Saat berjalan secara lokal, Anda malah menggunakan pengaturan FUNCTIONS_WORKER_RUNTIME_VERSION dalam file local.settings.json.
vnetContentShareEnabled
Aplikasi yang berjalan dalam paket Premium menggunakan berbagi file untuk menyimpan konten. Nama berbagi konten ini disimpan dalam WEBSITE_CONTENTSHARE pengaturan aplikasi dan string koneksi disimpan di WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Untuk merutekan lalu lintas antara aplikasi fungsi dan berbagi konten melalui jaringan virtual, Anda juga harus mengatur vnetContentShareEnabled ke true. Mengaktifkan properti situs ini diperlukan untuk penskalaan lintas wilayah saat membatasi akses akun penyimpanan Anda ke jaringan virtual dalam paket hosting Elastic Premium dan Dedicated. Tanpa pengaturan ini, aplikasi fungsi hanya dapat menskalakan dalam satu stempel (sekitar 1-20 instans).
Note
Anda harus berhati-hati saat mengakses berbagi konten penyimpanan di akun penyimpanan yang dibagikan oleh beberapa aplikasi fungsi dalam paket yang sama. Untuk informasi selengkapnya, lihat Perutean yang konsisten melalui jaringan virtual di artikel Pertimbangan penyimpanan.
Properti situs ini menggantikan pengaturan lama WEBSITE_CONTENTOVERVNET.
vnetImagePullEnabled
Functions mendukung aplikasi fungsi yang berjalan di kontainer Linux. Untuk menyambungkan dan mengambil dari registri kontainer di dalam jaringan virtual, Anda harus mengatur vnetImagePullEnabled ke true. Properti situs ini didukung dalam paket hosting Elastic Premium dan Dedicated. Paket Konsumsi Flex tidak bergantung pada properti situs atau pengaturan aplikasi untuk mengonfigurasi Jaringan. Untuk informasi selengkapnya, lihat Penghentian paket Konsumsi Flex.
vnetRouteAllEnabled
Menunjukkan apakah semua lalu lintas keluar dari aplikasi dijalankan melalui jaringan virtual. Nilai true pengaturan menunjukkan bahwa semua lalu lintas aplikasi dirutekan melalui jaringan virtual. Gunakan pengaturan ini saat mengonfigurasi integrasi jaringan virtual Regional dalam paket Elastic Premium dan Dedicated. Ini juga digunakan ketika jaringan virtual NAT gateway digunakan untuk menentukan alamat IP keluar statis. Untuk informasi selengkapnya, lihat Mengonfigurasi perutean aplikasi.
Pengaturan situs ini menggantikan pengaturan WEBSITE_VNET_ROUTE_ALL warisan.
Penghentian Rencana Konsumsi Flex
Dalam paket Konsumsi Flex, properti situs dan pengaturan aplikasi ini sudah usang dan tidak disarankan untuk digunakan ketika membuat sumber daya aplikasi fungsi.
| Setting/property | Reason |
|---|---|
ENABLE_ORYX_BUILD |
Digantikan oleh parameter remoteBuild saat penerapan dalam Konsumsi Flex |
FUNCTIONS_EXTENSION_VERSION |
Pengaturan Aplikasi diatur oleh backend. Nilai ~1 dapat diabaikan. |
FUNCTIONS_WORKER_RUNTIME |
Digantikan oleh name dalam properties.functionAppConfig.runtime |
FUNCTIONS_WORKER_RUNTIME_VERSION |
Digantikan oleh version dalam properties.functionAppConfig.runtime |
FUNCTIONS_MAX_HTTP_CONCURRENCY |
Digantikan oleh bagian pemicu skala dan konkurensi |
FUNCTIONS_WORKER_PROCESS_COUNT |
Pengaturan tidak valid |
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED |
Pengaturan tidak valid |
SCM_DO_BUILD_DURING_DEPLOYMENT |
Digantikan oleh parameter remoteBuild saat penerapan dalam Konsumsi Flex |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
Digantikan oleh bagian penerapan dari functionAppConfig |
WEBSITE_CONTENTOVERVNET |
Tidak digunakan untuk terkoneksi ke jaringan dalam Konsumsi Flex |
WEBSITE_CONTENTSHARE |
Digantikan oleh bagian penerapan dari functionAppConfig |
WEBSITE_DNS_SERVER |
DNS diwarisi dari jaringan virtual terintegrasi di Flex |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT |
Digantikan oleh maximumInstanceCount dalam properties.functionAppConfig.scaleAndConcurrency |
WEBSITE_NODE_DEFAULT_VERSION |
Digantikan oleh version dalam properties.functionAppConfig.runtime |
WEBSITE_RUN_FROM_PACKAGE |
Tidak digunakan untuk implementasi pada Flex Consumption |
WEBSITE_SKIP_CONTENTSHARE_VALIDATION |
Berbagi konten tidak digunakan dalam Flex Consumption |
WEBSITE_VNET_ROUTE_ALL |
Tidak digunakan untuk terkoneksi ke jaringan dalam Konsumsi Flex |
properties.alwaysOn |
Tidak valid |
properties.containerSize |
Diganti namanya menjadi instanceMemoryMB |
properties.ftpsState |
FTPS tidak didukung |
properties.isReserved |
Tidak valid |
properties.IsXenon |
Tidak valid |
properties.javaVersion |
Digantikan oleh version dalam properties.functionAppConfig.runtime |
properties.LinuxFxVersion |
Digantikan oleh properties.functionAppConfig.runtime |
properties.netFrameworkVersion |
Digantikan oleh version dalam properties.functionAppConfig.runtime |
properties.powerShellVersion |
Digantikan oleh version dalam properties.functionAppConfig.runtime |
properties.siteConfig.functionAppScaleLimit |
Diganti namanya menjadi maximumInstanceCount |
properties.siteConfig.preWarmedInstanceCount |
Diganti namanya menjadi alwaysReadyInstances |
properties.use32BitWorkerProcess |
32-bit tidak didukung |
properties.vnetBackupRestoreEnabled |
Tidak digunakan untuk terkoneksi ke jaringan dalam Konsumsi Flex |
properties.vnetContentShareEnabled |
Tidak digunakan untuk terkoneksi ke jaringan dalam Konsumsi Flex |
properties.vnetImagePullEnabled |
Tidak digunakan untuk terkoneksi ke jaringan dalam Konsumsi Flex |
properties.vnetRouteAllEnabled |
Tidak digunakan untuk terkoneksi ke jaringan dalam Konsumsi Flex |
properties.windowsFxVersion |
Tidak valid |