Mengonfigurasi pengaturan aplikasi

Selesai

Di App Service, pengaturan aplikasi adalah variabel yang diteruskan sebagai variabel lingkungan ke kode aplikasi. Untuk kontainer khusus dan aplikasi Linux, App Service meneruskan pengaturan aplikasi ke kontainer menggunakan bendera --env untuk mengatur variabel lingkungan dalam kontainer.

Pengaturan aplikasi dapat diakses dengan menavigasi ke halaman manajemen aplikasi dan memilih Konfigurasi > Pengaturan Aplikasi.

Navigating to Configuration > Application settings

Untuk pengembang ASP.NET dan ASP.NET Core, mengatur pengaturan aplikasi di App Service seperti mengatur aplikasi di <appSettings> pada Web.config atau appsettings.json, tetapi nilai di App Service menimpa yang ada di Web.config atau appsettings.json. Anda dapat menyimpan pengaturan pengembangan (misalnya, kata sandi MySQL lokal) di Web.config atau appsettings.json dan rahasia produksi (misalnya, kata sandi database Azure MySQL) dengan aman di App Service. Kode yang sama menggunakan pengaturan pengembangan saat Anda melakukan debug secara lokal, dan menggunakan rahasia produksi Anda saat disebarkan ke Azure.

Pengaturan aplikasi selalu dienkripsi saat disimpan (dienkripsi saat istirahat).

Menambahkan dan mengedit pengaturan

Untuk menambahkan pengaturan aplikasi baru, pilih Pengaturan aplikasi baru. Jika Anda menggunakan slot penyebaran, Anda dapat menentukan apakah pengaturan Anda dapat ditukar atau tidak. Di dialog, Anda dapat menempelkan pengaturan ke slot saat ini.

Selecting deployment slot setting to stick the setting to the current slot.

Untuk mengedit pengaturan, pilih tombol Edit di sisi kanan.

Setelah selesai, pilih Perbarui. Jangan lupa untuk memilih Simpan kembali di halaman Konfigurasi.

Catatan

Secara default, atau kustom, kontainer Linux dari setiap struktur kunci JSON bersarang dalam nama pengaturan aplikasi seperti ApplicationInsights:InstrumentationKey perlu dikonfigurasi di App Service sebagai ApplicationInsights__InstrumentationKey untuk nama kunci. Dengan kata lain, setiap : harus diganti dengan __ (garis bawah ganda).

Mengedit pengaturan aplikasi dalam jumlah besar

Untuk menambahkan atau mengedit pengaturan aplikasi secara massal, pilih tombol Edit tingkat lanjut . Setelah selesai, pilih Perbarui. Pengaturan aplikasi memiliki pemformatan JSON berikut ini:

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

Konfigurasi string koneksi

Untuk pengembang ASP.NET dan ASP.NET Core, nilai yang Anda tetapkan di App Service mengambil alih yang ada di Web.config. Untuk tumpukan bahasa lain, lebih baik menggunakan pengaturan aplikasi sebagai gantinya, karena string koneksi memerlukan pemformatan khusus dalam kunci variabel untuk mengakses nilai. String koneksi selalu dienkripsi saat disimpan (dienkripsi saat istirahat).

Tip

Ada satu kasus ketika Anda mungkin ingin menggunakan string koneksi daripada pengaturan aplikasi untuk bahasa non .NET: jenis database Azure tertentu dicadangkan bersama dengan aplikasi hanya apabila Anda mengonfigurasi string koneksi untuk database di aplikasi App Service Anda.

Menambahkan dan mengedit string koneksi mengikuti prinsip yang sama dengan pengaturan aplikasi lainnya dan juga dapat dikaitkan dengan slot penyebaran. Contoh string koneksi dalam pemformatan JSON yang akan Anda gunakan untuk menambahkan atau mengedit secara massal:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]