Mengonfigurasi aplikasi App Service

Catatan

Mulai 1 Juni 2024, semua aplikasi App Service yang baru dibuat akan memiliki opsi untuk menghasilkan nama host default yang unik menggunakan konvensi <app-name>-<random-hash>.<region>.azurewebsites.netpenamaan . Nama aplikasi yang ada akan tetap tidak berubah.

Contoh: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Untuk detail lebih lanjut, lihat Nama Host Default Unik untuk Sumber Daya App Service.

Artikel ini menjelaskan cara mengonfigurasi pengaturan umum untuk aplikasi web, back end seluler, atau aplikasi API. Untuk Azure Functions, lihat Referensi pengaturan aplikasi untuk Azure Functions.

Mengonfigurasi pengaturan aplikasi

Catatan

• Nama pengaturan aplikasi hanya boleh berisi huruf, angka (0-9), titik ("."), dan garis bawah ("_")
• Karakter khusus dalam nilai Pengaturan Aplikasi harus diloloskan sesuai kebutuhan oleh OS target

Misalnya untuk mengatur variabel lingkungan di App Service Linux dengan nilai "pa$$w0rd\" string untuk pengaturan aplikasi harus: "pa\$\$w0rd\\"

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.

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.

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

• Inti ASP.NET
• Node.js
• PHP
• Python
• Java
• Kontainer kustom

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

Catatan

Jika Anda menyimpan rahasia di pengaturan aplikasi, pertimbangkan untuk menggunakan referensi Key Vault. Jika rahasia Anda adalah untuk konektivitas ke sumber daya back-end, pertimbangkan opsi konektivitas yang lebih aman yang tidak memerlukan rahasia sama sekali. Untuk informasi selengkapnya, lihat Mengamankan konektivitas ke layanan dan database Azure dari Azure App Service.

Portal Azure

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

   

2. Di menu kiri aplikasi, pilih Pengaturan aplikasi variabel lingkungan>.

   

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

3. Untuk menambahkan pengaturan aplikasi baru, pilih Tambahkan. Untuk mengedit pengaturan, klik pengaturan.

4. Di dialog, Anda dapat menempelkan pengaturan ke slot saat ini.

   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). Setiap periode dalam nama pengaturan aplikasi akan diganti dengan _ (garis bawah tunggal).

5. Setelah selesai, pilih Terapkan. Jangan lupa untuk memilih Terapkan kembali di halaman Variabel lingkungan .

Azure CLI

Tambahkan atau edit pengaturan aplikasi dengan az webapp config app settings set:

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

Ganti <setting-name> dengan nama pengaturan, dan <value> dengan nilai untuk ditetapkan ke pengaturan tersebut.

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

az webapp config appsettings list --name <app-name> --resource-group <group-name>

Hapus satu atau beberapa pengaturan dengan hapus pengaturan aplikasi konfigurasi az webapp:

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

Azure PowerShell

Atur satu atau beberapa pengaturan aplikasi dengan Set-AzWebApp:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

Cmdlet ini menggantikan seluruh kumpulan pengaturan aplikasi dengan yang Anda tentukan. Untuk menambah atau mengedit pengaturan aplikasi dalam kumpulan yang ada, sertakan pengaturan aplikasi yang ada di Hashtable input Anda dengan menggunakan cmdlet Get-AzWebApp. Contohnya:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new Hashtable
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

Untuk memeriksa apakah pengaturan aplikasi khusus slot, gunakan Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

Untuk membuat satu atau beberapa pengaturan aplikasi khusus slot, gunakan Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

Mengedit pengaturan aplikasi secara massal

Portal Azure

Pilih tombol Edit tingkat lanjut. Edit pengaturan di area teks. Setelah selesai, pilih OK. Jangan lupa untuk memilih Terapkan kembali di halaman Variabel lingkungan .

Pengaturan aplikasi memiliki pemformatan JSON berikut ini:

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

Azure CLI

Jalankan az webapp config app settings set dengan nama file JSON.

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Tip

Membungkus nama file dengan kuotasi hanya diperlukan di PowerShell.

Format file yang diperlukan adalah susunan pengaturan JSON dengan bidang pengaturan slot adalah opsional. Contohnya:

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

Untuk kenyamanan, Anda dapat menyimpan pengaturan yang ada ke dalam file JSON dengan az webapp config appsettings list. Contoh berikut dapat dijalankan di Bash.

# Save the settings
az webapp config appsettings list --name <app-name> --resource-group <group-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Tidak mungkin mengedit pengaturan aplikasi secara massal menggunakan file JSON dengan Azure PowerShell.

Konfigurasi string koneksi

Catatan

Pertimbangkan opsi konektivitas yang lebih aman yang tidak memerlukan rahasia koneksi. Untuk informasi selengkapnya, lihat Mengamankan konektivitas ke layanan dan database Azure dari Azure App Service.

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 Membuat cadangan kustom. 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_
• Notification Hub: NOTIFICATIONHUBCONNSTR_
• Bus Layanan:SERVICEBUSCONNSTR_
• Pusat Aktivitas: EVENTHUBCONNSTR_
• Dokumen DB: DOCDBCONNSTR_
• Redis Cache: REDISCACHECONNSTR_

Catatan

Aplikasi .NET yang menargetkan PostgreSQL, Notification Hub, Bus Layanan, Event Hub, Document Db dan Redis Cache harus mengatur string koneksi ke Kustom sebagai solusi untuk masalah yang diketahui di .NET EnvironmentVariablesConfigurationProvider

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

• Inti ASP.NET
• Node.js
• PHP
• Python
• Java
• Kontainer kustom

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

Catatan

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

Portal Azure

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

   

2. Di menu kiri aplikasi, pilih String koneksi variabel lingkungan>.

   

   Secara default, nilai untuk string koneksi disembunyikan di portal untuk keamanan. Untuk melihat nilai tersembunyi dari string koneksi, pilih bidang Nilainya. Untuk melihat nilai tersembunyi dari semua string koneksi, pilih tombol Perlihatkan nilai.

3. Untuk menambahkan string koneksi baru, pilih Tambahkan. Untuk mengedit string koneksi, pilih string koneksi.

4. Dalam dialog, Anda dapat menempelkan string koneksi ke slot saat ini.

5. Setelah selesai, pilih Terapkan. Jangan lupa untuk memilih Terapkan kembali di halaman Variabel lingkungan .

Azure CLI

Tambahkan atau edit pengaturan aplikasi dengan az webapp config connection-string set:

az webapp config connection-string set --name <app-name> --resource-group <group-name> --connection-string-type <type> --settings <string-name>='<value>'

Ganti <string-name> dengan nama string koneksi, dan <value> dengan nilai yang akan ditetapkan pada string koneksi. Untuk kemungkinan nilai <type> (misalnya, SQLAzure), lihat dokumentasi perintah CLI.

Tampilkan semua string koneksi dan nilainya dengan az webapp config connection-string list:

az webapp config connection-string list --name <app-name> --resource-group <group-name>

Hapus satu atau beberapa string koneksi dengan az webapp config connection-string delete:

az webapp config connection-string delete --name <app-name> --resource-group <group-name> --setting-names {<string-name1>,<string-name2>,...}

Azure PowerShell

Atur satu atau beberapa string koneksi dengan Set-AzWebApp:

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

Setiap string koneksi berisi nama (<string-name1>), nilai (<connection-string1>), dan jenis, yang merupakan nilai numerik yang sesuai dengan salah satu bidang enum ConnectionStringType. Misalnya, Untuk Azure SQL, tentukan type="2".

Cmdlet ini menggantikan seluruh rangkaian string koneksi dengan yang Anda tentukan. Untuk menambah atau mengedit pengaturan aplikasi dalam kumpulan yang ada, sertakan pengaturan aplikasi yang ada di hashtable input Anda dengan menggunakan cmdlet Get-AzWebApp. Contohnya:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hashtable
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
    $connStrings[$item.Name] = @{value=$item.ConnectionString; type=$item.Type.ToString()}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>', type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>', type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

Untuk memeriksa apakah string koneksi khusus slot, gunakan Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

Untuk membuat satu atau beberapa koneksi string khusus slot, gunakan Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

Mengedit string koneksi secara massal

Portal Azure

Pilih tombol Edit tingkat lanjut. Edit string koneksi di area teks. Setelah selesai, pilih Terapkan. Jangan lupa untuk memilih Terapkan kembali di halaman Variabel lingkungan .

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
  },
  ...
]

Azure CLI

Jalankan az webapp config connection-string set dengan nama file JSON.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Tip

Membungkus nama file dengan kuotasi hanya diperlukan di PowerShell.

Format file yang dibutuhkan adalah larik JSON dari string koneksi dengan bidang pengaturan slot adalah opsional. Contohnya:

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

Untuk kenyamanan, Anda dapat menyimpan string koneksi yang ada ke dalam file JSON dengan az webapp config connection-string list. Contoh berikut dapat dijalankan di Bash.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Tidak mungkin mengedit string koneksi secara massal dengan menggunakan file JSON dengan Azure PowerShell.

Konfigurasikan pengaturan tumpukan bahasa

• Inti ASP.NET
• Node.js
• PHP
• Python
• Java

Konfigurasikan pengaturan umum

Portal Azure

Di portal Azure, cari dan pilih App Service, lalu pilih aplikasi Anda. Di menu kiri aplikasi, pilih pengaturan >Konfigurasi 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, Anda dapat memilih versi runtime bahasa dan mengatur Perintah pengaktifan opsional atau file perintah pengaktifan.

  

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

  • Bitness platform: 32-bit atau 64-bit. Hanya untuk aplikasi Windows.
  • Status FTP: Hanya izinkan FTPS atau nonaktifkan semua FTP.
  • 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.

  • Soket web: 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.

  • Afinitas sesi: Dalam penyebaran multi-instans, pastikan bahwa klien dirutekan ke instans yang sama selama masa pakai sesi. Anda dapat mengatur opsi ini ke Nonaktif untuk aplikasi tanpa status.

  • Proksi afinitas sesi: Proksi afinitas sesi dapat diaktifkan jika aplikasi Anda berada di belakang proksi terbalik (seperti Azure Application Gateway atau Azure Front Door) dan Anda menggunakan nama host default. Domain untuk cookie afinitas sesi akan selaras dengan nama host yang diteruskan dari proksi terbalik.

  • HANYA HTTPS: Saat diaktifkan, semua lalu lintas HTTP dialihkan ke HTTPS.

  • Versi TLS minimum: Pilih versi enkripsi TLS minimum yang diperlukan oleh aplikasi Anda.

• 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.

Azure CLI

Anda dapat mengatur banyak opsi umum yang dapat dikonfigurasi menggunakan az webapp config set. Contoh berikut menunjukkan subset dari opsi yang dapat dikonfigurasi.

az webapp config set --resource-group <group-name> --name <app-name> --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

Untuk menampilkan pengaturan yang ada, gunakan perintah az webapp config show.

Azure PowerShell

Anda dapat mengatur banyak opsi umum yang dapat dikonfigurasi menggunakan Set-AzWebApp. Contoh berikut menunjukkan subset dari opsi yang dapat dikonfigurasi.

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [True|False] -WebSocketsEnabled [True|False] -AlwaysOn [True|False] -NumberOfWorkers

Untuk menampilkan pengaturan yang ada, gunakan perintah Get-AzWebApp.

Konfigurasikan dokumen default

Pengaturan ini hanya untuk aplikasi Windows.

Dokumen default adalah halaman web yang ditampilkan di URL akar aplikasi App Service. File pencocokan pertama dalam daftar digunakan. Jika aplikasi menggunakan modul yang merutekan berdasarkan URL alih-alih menyajikan konten statis, tidak perlu dokumen default.

Portal Azure

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

2. Di menu kiri aplikasi, pilih Konfigurasi>Dokumen default.

   

3. Untuk menambahkan dokumen default, pilih Dokumen baru. Untuk menghapus dokumen default, pilih Hapus di sebelah kanannya.

Azure CLI

Tambahkan dokumen default dengan menggunakan az resource update:

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Azure PowerShell

Tambahkan dokumen default dengan mengubah objek PowerShell aplikasi yang sedang diperbarui:

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

Memetakan jalur URL ke direktori

Secara default, App Service memulai aplikasi Anda dari direktori akar kode aplikasi Anda. Tetapi, kerangka kerja web tertentu tidak dimulai di direktori akar. Misalnya, Laravel dimulai di subdirektori public. Aplikasi semacam itu dapat diakses di http://contoso.com/public, misalnya, tetapi Anda biasanya ingin mengarahkan http://contoso.com ke direktori public sebagai gantinya. Jika file pengaktifan 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.

Penting

Direktori virtual ke fitur jalur fisik hanya tersedia di aplikasi Windows.

Portal Azure

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

2. Di menu sebelah kiri aplikasi, pilih Konfigurasi>Pemetaan jalur

3. Pilih 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.

   

4. Pilih OK. Jangan lupa untuk memilih Simpan di halaman Konfigurasi .

Azure CLI

Contoh berikut mengatur jalur akar / ke subdirektori public (yang berfungsi untuk Laravel), dan juga menambahkan aplikasi virtual kedua di jalur /app2. Untuk menjalankannya, buat file bernama json.txt dengan konten berikut.

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

Ubah <group-name> dan <app-name> untuk sumber daya Anda dan jalankan perintah berikut. Waspadai karakter escape saat menjalankan perintah ini. Untuk informasi selengkapnya tentang karakter escape, lihat Tips untuk menggunakan Azure CLI dengan sukses.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

Azure PowerShell

Contoh berikut mengatur jalur akar / ke subdirektori public (yang berfungsi untuk Laravel), dan juga menambahkan aplikasi virtual kedua di jalur /app2. Untuk menjalankannya, ubah <group-name> dan <app-name>.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp

Mengonfigurasi pemetaan penangan

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 penangan kustom:

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

2. Di menu kiri aplikasi, pilih Konfigurasi>Pemetaan jalur.

   

3. Pilih Pemetaan handler baru. Konfigurasikan penghandel sebagai berikut:

   • Ekstensi. Ekstensi file yang ingin Anda tangani, seperti *.php atau handler.fcgi.
   • Prosesor Skrip. Jalur absolut dari 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.

4. Pilih OK. Jangan lupa untuk memilih Simpan di halaman Konfigurasi .

Konfigurasikan kontainer kustom

• Mengonfigurasikan kontainer kustom untuk Azure App Service
• Menambahkan penyimpanan kustom untuk aplikasi yang disimpan dalam kontainer

Langkah berikutnya

• Variabel lingkungan dan referensi pengaturan aplikasi
• Mengonfigurasi nama domain kustom di Azure App Service
• Menyiapkan lingkungan staging di Azure App Service
• Mengamankan nama DNS kustom dengan pengikatan TLS/SSL di Azure App Service
• Aktifkan log diagnostik
• Meningkatkan skala aplikasi di Azure App Service
• Dasar-dasar pemantauan di Azure App Service
• Mengubah pengaturan applicationHost.config dengan applicationHost.xdt