Bagikan melalui

File App Offline (app_offline.htm)

  • Artikel

Catatan

Ini bukan versi terbaru dari artikel ini. Untuk rilis saat ini, lihat versi .NET 9 dari artikel ini.

Peringatan

Versi ASP.NET Core ini tidak lagi didukung. Untuk informasi selengkapnya, lihat Kebijakan Dukungan .NET dan .NET Core. Untuk rilis saat ini, lihat versi .NET 8 dari artikel ini.

Penting

Informasi ini berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Untuk rilis saat ini, lihat versi .NET 9 dari artikel ini.

File App Offline (app_offline.htm) digunakan oleh Modul ASP.NET Core untuk mematikan aplikasi.

Jika file dengan nama app_offline.htm terdeteksi di direktori akar aplikasi, ASP.NET Core Module mencoba mematikan aplikasi dengan lancar dan berhenti memproses permintaan masuk. Jika aplikasi masih berjalan setelah jumlah detik yang ditentukan dalam shutdownTimeLimit, Modul ASP.NET Core menghentikan proses yang sedang berjalan.

app_offline.htm Saat file ada, ASP.NET Core Module merespons permintaan dengan mengirim kembali konten app_offline.htm file. app_offline.htm harus kurang dari 4 GB. app_offline.htm Saat file dihapus, permintaan berikutnya memulai aplikasi.

Saat menggunakan model hosting di luar proses, aplikasi mungkin tidak segera dimatikan jika ada koneksi terbuka. Misalnya, koneksi WebSocket dapat menunda aplikasi dimatikan.

File penyebaran yang dikunci

File dalam folder penyebaran dikunci saat aplikasi sedang berjalan. File yang dikunci tidak dapat ditimpa selama penyebaran.

app_offline.htm adalah mekanisme utama untuk merilis file terkunci. app_offline.htm digunakan oleh Web Deploy untuk menghentikan dan memulai aplikasi dengan benar.

app_offline.htm dapat digunakan secara manual untuk memulai dan menghentikan aplikasi (memerlukan PowerShell 5 atau yang lebih baru):

$pathToApp = '{PATH TO APP}'


New-Item -Path $pathToApp -Name "app_offline.htm" -ItemType "file"

# Provide script commands here to deploy the app

Remove-Item -Path $pathToApp\app_offline.htm

Dalam skrip PowerShell sebelumnya:

  • Tempat penampung {PATH TO APP} adalah jalur ke aplikasi.
  • New-Item Perintah menghentikan kumpulan aplikasi.
  • Perintah Remove-Item memulai kumpulan aplikasi.
  • Perintah antara New-Item perintah dan Remove-Item perintah disediakan oleh pengembang untuk menyebarkan aplikasi.

File juga dapat dibuka kuncinya dengan menghentikan kumpulan aplikasi secara manual di Manajer IIS di server. Jangan gunakan app_offline.htm file saat menggunakan Manajer IIS untuk menghentikan dan menghidupkan ulang kumpulan aplikasi.