Konfigurasikan aplikasi App Service di portal Azure

Artikel ini menjelaskan cara mengonfigurasi pengaturan umum untuk aplikasi web, ujung belakang seluler, atau aplikasi API menggunakan portal Azure.

Mengonfigurasi pengaturan aplikasi

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. Dalam kedua kasus, mereka disuntikkan ke lingkungan aplikasi Anda di startup aplikasi. Saat Anda menambahkan, menghapus, atau mengedit pengaturan aplikasi, App Service memicu memulai ulang aplikasi.

Di portal Azure, cari dan pilih App Service, lalu pilih aplikasi Anda.

Cari App Services

Di menu sebelah kiri aplikasi, pilih Konfigurasi > Pengaturan aplikasi.

Pengaturan Aplikasi

Untuk pengembang ASP.NET dan ASP.NET Core, mengatur pengaturan aplikasi di App Service mirip dengan mengatur di <appSettings> pada Web.config atau appsettings.json, tetapi nilai di ambil alih App Service 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.

Tumpukan bahasa lainnya, juga mendapatkan pengaturan aplikasi sebagai variabel lingkungan pada runtime. Untuk langkah-langkah spesifik tentang tumpukan bahasa, lihat:

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

Catatan

Pengaturan aplikasi juga dapat diselesaikan dari Brankas Kunci menggunakan referensi Brankas Kunci.

Perlihatkan nilai tersembunyi

Secara default, nilai untuk pengaturan aplikasi disembunyikan di portal untuk alasan keamanan. Untuk melihat nilai tersembunyi dari pengaturan aplikasi, klik bidang Nilai dari pengaturan tersebut. Untuk melihat nilai semua pengaturan aplikasi, klik tombol Perlihatkan nilai.

Tambahkan atau edit

Untuk menambahkan pengaturan aplikasi baru, klik Pengaturan aplikasi baru. Di dialog, Anda dapat menempelkan pengaturan ke slot saat ini.

Untuk mengedit pengaturan, klik tombol Edit di sisi kanan.

Setelah selesai, klik Perbarui. Jangan lupa untuk mengeklik Simpan di halaman Konfigurasi.

Catatan

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

Mengedit secara massal

Untuk menambahkan atau mengedit pengaturan aplikasi secara massal, klik tombol Edit tingkat lanjut. Setelah selesai, klik Perbarui. Jangan lupa untuk mengeklik Simpan di halaman Konfigurasi.

Pengaturan aplikasi memiliki pemformatan JSON berikut ini:

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

Mengotomatiskan pengaturan aplikasi dengan Azure CLI

Anda dapat menggunakan Azure CLI untuk membuat dan mengelola pengaturan dari baris perintah.

  • Tetapkan nilai ke pengaturan dengan set pengaturan aplikasi konfigurasi az webapp:

    az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings <setting-name>="<value>"
    

    Ganti <setting-name> dengan nama pengaturan, dan <value> dengan nilai untuk ditetapkan ke pengaturan tersebut. Perintah ini akan membuat pengaturan jika belum ada.

  • Tampilkan semua pengaturan dan nilainya dengan daftar appsetting konfigurasi az webapp:

    az webapp config appsettings list --name <app-name> --resource-group <resource-group-name>
    
  • Hapus satu atau beberapa pengaturan dengan hapus pengaturan aplikasi konfigurasi az webapp:

    az webapp config appsettings delete --name <app-name> --resource-group <resource-group-name> --setting-names {<names>}
    

    Ganti <names> dengan daftar nama pengaturan yang dipisahkan spasi.

Konfigurasi string koneksi

Di portal Azure, cari dan pilih App Service, lalu pilih aplikasi Anda. Di menu sebelah kiri aplikasi, pilih Konfigurasi > Pengaturan aplikasi.

Pengaturan Aplikasi

Untuk pengembang ASP.NET dan ASP.NET Core, mengatur pengaturan aplikasi di App Service mirip dengan mengatur di <connectionStrings> pada Web.config, tetapi nilai yang Anda atur di ambil alih App Service yang ada di Web.config. Anda dapat menyimpan pengaturan pengembangan (misalnya, file databse) di Web.config dan rahasia produksi (misalnya, kredensial Database SQL) 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.

Untuk tumpukan bahasa lain, lebih baik menggunakan pengaturan aplikasi, karena string koneksi memerlukan pemformatan khusus dalam kunci variabel untuk mengakses nilai.

Catatan

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. Untuk informasi selengkapnya, lihat Apa yang akan dicadangkan. Jika Anda tidak memerlukan pencadangan otomatis ini, maka gunakan pengaturan aplikasi.

Pada runtime, string koneksi tersedia sebagai variabel lingkungan, diawali dengan jenis koneksi berikut:

  • SQLServer: SQLCONNSTR_
  • MySQL: MYSQLCONNSTR_
  • SQLAzure: SQLAZURECONNSTR_
  • Kustom: CUSTOMCONNSTR_
  • PostgreSQL: POSTGRESQLCONNSTR_

Misalnya, string koneksi MySql bernama connectionstring1 dapat diakses sebagai variabel lingkungan MYSQLCONNSTR_connectionString1. Untuk langkah-langkah spesifik tentang tumpukan bahasa, lihat:

String koneksi selalu dienkripsi saat disimpan (dienkripsi saat istirahat).

Catatan

String koneksi juga dapat diselesaikan dari Brankas Kunci menggunakan referensi Brankas Kunci.

Perlihatkan nilai tersembunyi

Secara default, nilai untuk string koneksi disembunyikan di portal untuk keamanan. Untuk melihat nilai tersembunyi dari string koneksi, cukup klik bidang Nilai dari string tersebut. Untuk melihat nilai semua string koneksi, klik tombol Tampilkan nilai.

Tambahkan atau edit

Untuk menambahkan string koneksi baru, klik String koneksi baru. Dalam dialog, Anda dapat menempelkan string koneksi ke slot saat ini.

Untuk mengedit pengaturan, klik tombol Edit di sisi kanan.

Setelah selesai, klik Perbarui. Jangan lupa untuk mengeklik Simpan di halaman Konfigurasi.

Mengedit secara massal

Untuk menambahkan atau mengedit string koneksi secara massal, klik tombol Edit tingkat lanjut. Setelah selesai, klik Perbarui. Jangan lupa untuk mengeklik Simpan di halaman Konfigurasi.

String koneksi memiliki pemformatan JSON berikut ini:

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

Konfigurasikan pengaturan umum

Di portal Azure, cari dan pilih App Service, lalu pilih aplikasi Anda. Di menu kiri aplikasi, pilih pengaturan > Konfigurasi Umum.

Pengaturan umum

Di sini, Anda dapat mengonfigurasi beberapa pengaturan umum untuk aplikasi. Beberapa pengaturan mengharuskan Anda untuk meningkatkan ke tingkat harga yang lebih tinggi.

  • Pengaturan tumpukan: Tumpukan perangkat lunak untuk menjalankan aplikasi, termasuk bahasa dan versi SDK.

    Untuk aplikasi Linux dan aplikasi kontainer kustom, Anda dapat memilih versi runtime bahasa dan mengatur perintah Startup opsional atau file perintah startup.

    Pengaturan umum untuk kontainer Linux

  • Pengaturan platform: Memungkinkan Anda mengonfigurasi pengaturan untuk platform hosting, termasuk:

    • Bitness: 32-bit atau 64-bit. (Default ke 32-bit untuk Layanan Aplikasi yang dibuat di portal.)

    • Protokol WebSocket: Untuk ASP.NET SignalR atau socket.io, misalnya.

    • Selalu Hidup: Menjaga aplikasi tetap dimuat bahkan ketika tidak ada lalu lintas. Saat Always On tidak diaktifkan (default), aplikasi dibongkar setelah 20 menit tanpa permintaan masuk. Aplikasi yang dibongkar dapat menyebabkan latensi tinggi untuk permintaan baru karena waktu pemanasannya. Ketika Always On diaktifkan, penyeimbang beban front-end mengirimkan permintaan GET ke root aplikasi setiap lima menit. Ping terus menerus mencegah aplikasi dibongkar.

      Always On diperlukan untuk WebJobs berkelanjutan atau untuk WebJobs yang dipicu menggunakan ekspresi CRON.

    • Versi alur terkelola: Mode alur IIS. Atur ke Klasik jika Anda memiliki aplikasi warisan yang memerlukan versi lama dari IIS.

    • Versi HTTP: Atur ke 2.0 untuk mengaktifkan dukungan untuk protokol HTTPS/2.

    Catatan

    Sebagian besar browser modern mendukung protokol HTTP/2 hanya melalui TLS, sementara lalu lintas yang tidak dienkripsi terus menggunakan HTTP/1.1. Untuk memastikan bahwa browser klien terhubung ke aplikasi Anda dengan HTTP/2, amankan nama DNS kustom Anda. Untuk informasi selengkapnya, lihat Mengamankan nama DNS kustom dengan pengikatan data TLS/SSL di Azure App Service.

    • Afinitas ARR: Dalam penyebaran multi instans, pastikan bahwa klien dirutekan ke instans yang sama untuk masa hidup sesi. Anda dapat mengatur opsi ini menjadi Mati untuk aplikasi tanpa status.
  • Penelusuran kesalahan: Mengaktifkan penelusuran jarak jauh untuk aplikasi ASP.NET, ASP.NET Core, atau Node.js. Opsi ini mati secara otomatis setelah 48 jam.

  • Sertifikat klien masuk: memerlukan sertifikat klien dalam autentikasi bersama.

Konfigurasikan dokumen default

Pengaturan ini hanya untuk aplikasi Windows.

Di portal Azure, cari dan pilih App Service, lalu pilih aplikasi Anda. Di menu kiri aplikasi, pilih Konfigurasi > Dokumen default.

Dokumen default

Dokumen default adalah halaman web yang ditampilkan di URL root untuk situs web. File pencocokan pertama dalam daftar digunakan. Untuk menambahkan dokumen default baru, klik Dokumen baru. Jangan lupa untuk mengklik Simpan.

Jika aplikasi menggunakan modul yang dirutekan berdasarkan URL dan bukan menyajikan konten statis, maka tidak perlu dokumen default.

Konfigurasikan pemetaan jalur

Di portal Azure, cari dan pilih App Service, lalu pilih aplikasi Anda. Di menu kiri aplikasi, pilih Konfigurasi > Pemetaan jalur.

Pemetaan jalur

Catatan

Tab Pemetaan jalur mungkin menampilkan pengaturan khusus OS yang berbeda dari contoh yang ditampilkan di sini.

Aplikasi Windows (tidak masuk kontainer)

Untuk aplikasi Windows, Anda dapat menyesuaikan pemetaan penghandel IIS dan aplikasi serta direktori virtual.

Pemetaan penghandel memungkinkan Anda menambahkan pemroses skrip kustom untuk menangani permintaan ekstensi file tertentu. Untuk menambahkan penghandel kustom, klik Pemetaan penghandel baru. Konfigurasikan penghandel sebagai berikut:

  • Ekstensi. Ekstensi file yang ingin Anda tangani, seperti *.php atau handler.fcgi.
  • Prosesor Skrip. Jalur absolut prosesor skrip untuk Anda. Permintaan ke file yang cocok dengan ekstensi file diproses oleh prosesor skrip. Gunakan jalur D:\home\site\wwwroot untuk merujuk ke direktori root aplikasi Anda.
  • Argument. Argumen baris perintah opsional untuk prosesor skrip.

Setiap aplikasi memiliki jalur root default (/) dipetakan ke D:\home\site\wwwroot, tempat kode Anda disebarkan secara default. Jika akar aplikasi Anda berada di folder yang berbeda, atau jika repositori Anda memiliki lebih dari satu aplikasi, Anda dapat mengedit atau menambahkan aplikasi dan direktori virtual di sini.

Dari tab Pemetaan jalur, klik Aplikasi atau direktori virtual baru.

  • Untuk memetakan direktori virtual ke jalur fisik, biarkan kotak centang Direktori dipilih. Tentukan direktori virtual dan jalur relatif (fisik) yang sesuai ke root situs web (D:\home).

  • Untuk menandai direktori virtual sebagai aplikasi web, kosongkan kotak centang Direktori.

    Kotak centang direktori

Aplikasi masuk kontainer

Anda dapat menambahkan penyimpanan kustom untuk aplikasi masuk kontainer Anda. Aplikasi masuk kontainer mencakup semua aplikasi Linux dan juga kontainer kustom Windows dan Linux yang berjalan di App Service. Klik Pemasangan Azure Storage Baru dan konfigurasikan penyimpanan kustom Anda sebagai berikut:

  • Nama: Nama tampilan.
  • Opsi konfigurasi: Dasar atau Lanjutan.
  • Akun penyimpanan: Akun penyimpanan dengan kontainer yang Anda inginkan.
  • Jenis penyimpanan: Azure Blobs atau Azure Files.

    Catatan

    Aplikasi kontainer Windows hanya mendukung Azure Files.

  • Kontainer penyimpanan: Untuk konfigurasi dasar, kontainer yang Anda inginkan.
  • Bagikan nama : Untuk konfigurasi lanjutan, nama berbagi file.
  • Tombol akses: Untuk konfigurasi lanjutan, kunci akses.
  • Jalur pemasangan: Jalur absolut dalam kontainer Anda untuk memasang penyimpanan kustom.

Untuk informasi selengkapnya, lihat Mengakses Azure Storage sebagai jaringan berbagi dari penampung di App Service.

Konfigurasikan pengaturan tumpukan bahasa

Konfigurasikan kontainer khusus

Lihat Mengonfigurasi kontainer Linux kustom untuk Azure App Service

Langkah berikutnya