Mengonfigurasi aplikasi 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

Di Azure App Service, pengaturan aplikasi adalah variabel yang diteruskan sebagai variabel lingkungan ke kode aplikasi. Kondisi berikut berlaku untuk pengaturan aplikasi:

• Nama pengaturan aplikasi hanya boleh berisi huruf, angka (0-9), titik (.), dan garis bawah (_).
• Karakter khusus dalam nilai pengaturan aplikasi harus di-escape sesuai dengan kebutuhan sistem operasi target.

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

Untuk aplikasi Linux dan kontainer kustom, App Service meneruskan pengaturan aplikasi ke kontainer dengan menggunakan --env bendera 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, mengonfigurasi pengaturan aplikasi di App Service seperti mengonfigurasinya di dalam <appSettings>Web.config atau appsettings.json. Nilai dalam App Service mengesampingkan nilai di Web.config atau appsettings.json. Anda dapat menyimpan pengaturan pengembangan, seperti kata sandi MySQL lokal, di Web.config atau appsettings.json. Anda dapat menyimpan rahasia produksi, seperti kata sandi database Azure MySQL, dengan aman di App Service. Kode yang sama menggunakan pengaturan pengembangan ketika Anda men-debug secara lokal. Ini menggunakan rahasia produksi Anda saat Anda menyebarkannya ke Azure.

Tumpukan bahasa lain mendapatkan pengaturan aplikasi sebagai variabel lingkungan saat runtime. Untuk langkah-langkah khusus untuk setiap tumpukan bahasa, lihat:

• ASP.NET Core
• Jawa
• Node.js
• Ular sawah
• PHP
• Kontainer khusus

Pengaturan aplikasi selalu dienkripsi saat disimpan (dienkripsi saat tidak aktif).

Catatan

Jika Anda menyimpan rahasia di pengaturan aplikasi, pertimbangkan menggunakan referensi Azure Key Vault. Jika rahasia Anda adalah untuk konektivitas ke sumber daya back-end, pertimbangkan opsi konektivitas yang lebih aman dan tidak memerlukan rahasia. 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 sebelah kiri aplikasi , pilih>Pengaturan Variabel lingkungan. Lalu pilih Pengaturan aplikasi.

   

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

   Catatan

   Izin pengguna Baca/Tulis diperlukan untuk melihat bagian ini di portal Microsoft Azure. Peran bawaan RBAC dengan izin yang memadai adalah Pemilik, Kontributor, dan Kontributor Situs Web. Peran Pembaca saja tidak akan diizinkan untuk mengakses halaman ini.

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

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

   Catatan

   Dalam layanan aplikasi Linux default atau kontainer Linux kustom, struktur kunci JSON berlapis apa pun dalam nama pengaturan aplikasi perlu dikonfigurasi secara berbeda untuk nama kunci. Ganti titik dua (:) dengan dua garis bawah (__). Gantilah titik mana pun (.) dengan satu garis bawah (_). Misalnya, ApplicationInsights:InstrumentationKey perlu dikonfigurasi di App Service seperti ApplicationInsights__InstrumentationKey untuk nama kunci.

5. Setelah selesai, pilih Terapkan. Lalu pilih Terapkan pada halaman Variabel lingkungan .

Azure CLI

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

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

Ganti <setting-name> dengan nama pengaturan. Ganti <value> dengan nilai yang akan ditetapkan ke pengaturan.

Tampilkan semua pengaturan dan nilainya dengan menggunakan az webapp config appsettings list:

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

Hapus satu atau beberapa pengaturan dengan menggunakan az webapp config app settings delete:

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

Azure PowerShell

Atur satu atau beberapa pengaturan aplikasi dengan menggunakan Set-AzWebApp:

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

Cmdlet ini menggantikan seluruh set pengaturan aplikasi dengan yang Anda tentukan. Untuk menambahkan atau mengedit pengaturan aplikasi dalam set yang ada, sertakan pengaturan aplikasi yang ada dalam tabel hash 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 hash table
$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 itu khusus untuk slot, gunakan Get-AzWebAppSlotConfigName:

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

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

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

Mengedit pengaturan aplikasi secara massal

Portal Azure

1. Pilih Edit tingkat lanjut.
2. Sunting pengaturan di area teks.
3. Setelah selesai, pilih OK. Lalu pilih Terapkan pada 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"

Petunjuk / Saran

Membungkus nama file dengan tanda kutip hanya diperlukan di PowerShell.

Format file yang diperlukan adalah array pengaturan JSON di mana bidang pengaturan slot bersifat opsional. Contohnya:

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

Untuk kenyamanan, Anda dapat menyimpan pengaturan yang ada dalam file JSON dengan menggunakan az webapp config appsettings list.

# Save the settings
az webapp config appsettings list --resource-group <group-name> --name <app-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.

Mengonfigurasikan string koneksi

Bagian ini menjelaskan cara mengonfigurasi string koneksi.

Catatan

Pertimbangkan opsi konektivitas yang lebih aman dan 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 string koneksi di App Service seperti mengaturnya di <connectionStrings>Web.config. Nilai yang Anda tetapkan di App Service mengambil alih nilai di Web.config. Anda dapat menyimpan pengaturan pengembangan, seperti file database, di Web.config. Anda dapat menyimpan rahasia produksi, seperti info masuk database SQL, dengan aman di App Service. Kode yang sama menggunakan pengaturan pengembangan ketika Anda men-debug secara lokal. Ini menggunakan rahasia produksi Anda saat Anda menyebarkannya ke Azure.

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

Ada satu kasus di mana Anda mungkin ingin menggunakan string koneksi alih-alih pengaturan aplikasi untuk bahasa non-.NET. Jenis database Azure tertentu dibackup bersamaan dengan aplikasi hanya jika Anda mengonfigurasi string koneksi untuk database pada App Service Anda. Untuk informasi selengkapnya, lihat Membuat cadangan kustom. Jika Anda tidak memerlukan cadangan otomatis ini, gunakan pengaturan aplikasi.

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

• SQL Server: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• Azure SQL: SQLAZURECONNSTR_
• Kustom: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Azure Notification Hubs: NOTIFICATIONHUBCONNSTR_
• Azure Service Bus: SERVICEBUSCONNSTR_
• Azure Event Hubs: EVENTHUBCONNSTR_
• Azure Cosmos DB: DOCDBCONNSTR_
• Cache Redis: REDISCACHECONNSTR_

Catatan

Aplikasi .NET yang menargetkan cache PostgreSQL, Notification Hubs, Service Bus, Event Hubs, Azure Cosmos DB, dan Redis 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 khusus untuk setiap tumpukan bahasa, lihat:

• ASP.NET Core
• Jawa
• Node.js
• Ular sawah
• PHP
• Kontainer khusus

String koneksi selalu dienkripsi saat disimpan (dienkripsi saat tidak aktif).

Catatan

Anda juga dapat mengatasi string koneksi dari Key Vault dengan menggunakan referensi Key Vault.

Portal Azure

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

2. Di menu sebelah kiri aplikasi , pilih>Pengaturan Variabel lingkungan. Lalu pilih String koneksi.

   Secara default, nilai untuk string koneksi disembunyikan di portal untuk keamanan. Untuk melihat nilai tersembunyi string koneksi, di bawah Nilai, pilih Perlihatkan nilai. Untuk melihat nilai tersembunyi dari semua string koneksi, pilih 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. Lalu pilih Terapkan pada halaman Variabel lingkungan .

Azure CLI

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

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

Ganti <string-name> dengan nama string koneksi. Ganti <value> dengan nilai untuk ditetapkan ke string koneksi. Untuk kemungkinan nilai <type> seperti SQLAzure, lihat dokumentasi perintah CLI.

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

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

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

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

Azure PowerShell

Atur satu atau beberapa string koneksi dengan menggunakan 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 jenisnya. Jenis adalah nilai numerik yang sesuai dengan salah satu bidang enumerator ConnectionStringType . Misalnya, untuk Azure SQL, tentukan type="2".

Cmdlet ini menggantikan seluruh kumpulan string koneksi dengan yang Anda tentukan. Untuk menambahkan atau mengedit pengaturan aplikasi dalam set yang ada, sertakan pengaturan aplikasi yang ada dalam tabel hash 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 hash table
$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 terkait dengan slot, gunakan Get-AzWebAppSlotConfigName:

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

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

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

Mengedit string koneksi secara massal

Portal Azure

1. Pilih Edit tingkat lanjut.
2. Edit string koneksi di area teks.
3. Setelah selesai, pilih Terapkan. Jangan lupa juga untuk memilih Terapkan pada 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"

Petunjuk / Saran

Membungkus nama file dengan tanda kutip hanya diperlukan di PowerShell.

Format file yang diperlukan adalah array JSON dari string koneksi di mana bidang pengaturan slot bersifat 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 dalam file JSON dengan menggunakan az webapp config connection-string list.

# 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

Untuk mengonfigurasi pengaturan tumpukan bahasa, lihat sumber daya ini:

• ASP.NET Core
• Jawa
• Node.js
• Ular sawah
• PHP

Konfigurasikan pengaturan umum

Untuk mengonfigurasi pengaturan umum, ikuti langkah-langkah untuk alat pilihan Anda.

Portal Azure

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

2. Di menu kiri aplikasi, pilihKonfigurasi>. Lalu pilih 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: Konfigurasikan pengaturan untuk tumpukan perangkat lunak untuk menjalankan aplikasi, termasuk bahasa dan versi SDK.

  Untuk aplikasi Linux, Anda dapat memilih versi runtime bahasa dan mengatur perintah startup opsional.

• Pengaturan platform: Mengonfigurasi pengaturan untuk platform hosting, termasuk:

  • Platform: Pilih 32-bit atau 64-bit. Hanya untuk aplikasi Windows.

  • Status FTP: Izinkan hanya FTPS, atau nonaktifkan FTP sama sekali.

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

    Catatan

    Sebagian besar browser modern hanya mendukung protokol HTTP/2 melalui TLS. Lalu lintas yang tidak terenkripsi 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 Memberikan keamanan untuk nama DNS kustom dengan pengikatan TLS/SSL di App Service.

  • Soket web: Konfigurasikan untuk ASP.NET SignalR atau socket.io, misalnya.

  • Selalu Aktif: Aktifkan jika Anda ingin menjaga aplikasi tetap dimuat bahkan saat tidak ada lalu lintas.

    Saat Always On dinonaktifkan (default), aplikasi dibongkar setelah 20 menit tanpa permintaan masuk. Aplikasi yang tidak aktif dapat menyebabkan latensi tinggi untuk permintaan baru karena waktu persiapannya.

    Saat Always On diaktifkan, load balancer front-end mengirimkan GET permintaan ke akar aplikasi setiap lima menit. Ping terus menerus mencegah aplikasi dihentikan.

    Always On diperlukan untuk WebJobs berkelanjutan atau untuk WebJobs yang dipicu oleh ekspresi cron.

  • Afinitas sesi: Dalam penyebaran beberapa instans, pastikan klien dirutekan ke instans yang sama selama durasi sesi. Anda dapat mengatur opsi ini ke Nonaktif untuk aplikasi tanpa status.

  • Proksi afinitas sesi: Aktifkan jika aplikasi berada di belakang proksi balik (seperti Azure Application Gateway atau Azure Front Door) dan menggunakan nama host default. Domain cookie afinitas sesi sesuai dengan nama host yang diteruskan dari proksi terbalik.

  • HTTPS Saja: Aktifkan jika Anda ingin mengalihkan semua lalu lintas HTTP ke HTTPS.

  • Versi TLS minimum: Pilih versi enkripsi TLS minimum yang diperlukan 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 dengan menggunakan az webapp config set. Contoh berikut menunjukkan subset 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 dengan menggunakan Set-AzWebApp. Contoh berikut menunjukkan subset 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

Dokumen default adalah halaman web yang muncul 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.

Pengaturan untuk mengonfigurasi dokumen default hanya untuk aplikasi Windows.

Portal Azure

1. Di portal Azure, cari dan pilih App Service, lalu pilih aplikasi Anda.
2. Di menu kiri aplikasi, pilih Konfigurasi. Lalu pilih 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.

Fitur pemetaan direktori virtual ke 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 kiri aplikasi, pilihKonfigurasi>. Lalu pilih Pemetaan jalur.

3. Pilih Aplikasi atau direktori virtual baru. Kemudian ambil salah satu tindakan berikut:

   • Untuk memetakan direktori virtual ke jalur fisik, biarkan Direktori dipilih. Tentukan direktori virtual dan jalur relatif (fisik) yang sesuai ke root situs web (D:\home).
   • Untuk menandai direktori virtual sebagai aplikasi web, batal pilih Direktori.

   

4. Pilih OK. Lalu pilih Simpan di halaman Konfigurasi .

Azure CLI

Contoh berikut mengatur jalur / akar ke subdirektori public , yang berfungsi untuk Laravel. Ini juga menambahkan aplikasi virtual kedua di direktori /app2. Untuk menjalankannya, buat file yang disebut 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 Anda 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. Ini juga menambahkan aplikasi virtual kedua di direktori /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 pengendali

Untuk aplikasi Windows, Anda dapat menyesuaikan pemetaan penghandel IIS dan aplikasi serta direktori virtual. Pemetaan penangan memungkinkan Anda menambahkan pemroses skrip kustom untuk mengelola 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, pilihKonfigurasi>. Lalu pilih Pemetaan jalur.

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

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

4. Pilih OK. Lalu pilih Simpan di halaman Konfigurasi .

Konfigurasikan kontainer kustom

• Mengonfigurasikan kontainer kustom untuk Azure App Service
• Memasang Azure Storage sebagai berbagi lokal di App Service

Konten terkait

• Variabel Lingkungan dan Pengaturan Aplikasi di Azure App Service
• Menyiapkan domain kustom yang sudah ada di Azure App Service
• Menyiapkan lingkungan staging di Azure App Service
• Mengaktifkan HTTPS untuk domain kustom di Azure App Service
• Mengaktifkan pembuatan logging diagnostik untuk aplikasi di Azure App Service
• Meningkatkan skala aplikasi di Azure App Service
• Kuota dan notifikasi Azure App Service
• Mengubah pengaturan applicationHost.config dengan applicationHost.xdt