Plik trybu offline aplikacji (app_offline.htm)

  • Artykuł

Plik trybu offline aplikacji (app_offline.htm) jest używany przez moduł ASP.NET Core w celu zamknięcia aplikacji.

Jeśli plik o nazwie app_offline.htm zostanie wykryty w katalogu głównym aplikacji, moduł ASP.NET Core próbuje bezpiecznie zamknąć aplikację i zatrzymać przetwarzanie żądań przychodzących. Jeśli aplikacja jest nadal uruchomiona po liczbie sekund zdefiniowanych w programie shutdownTimeLimit, moduł ASP.NET Core zatrzymuje uruchomiony proces.

app_offline.htm Gdy plik jest obecny, moduł ASP.NET Core odpowiada na żądania, wysyłając z powrotem zawartość app_offline.htm pliku. Wartość app_offline.htm musi być mniejsza niż 4 GB. Po usunięciu app_offline.htm pliku następne żądanie uruchamia aplikację.

W przypadku korzystania z modelu hostingu poza procesem aplikacja może nie zostać natychmiast zamknięta, jeśli istnieje otwarte połączenie. Na przykład połączenie protokołu WebSocket może opóźnić zamknięcie aplikacji.

Zablokowane pliki wdrożenia

Pliki w folderze wdrożenia są zablokowane, gdy aplikacja jest uruchomiona. Zablokowanych plików nie można zastąpić podczas wdrażania.

app_offline.htm jest podstawowym mechanizmem zwalniania zablokowanych plików. app_offline.htm Jest używany przez narzędzie Web Deploy, aby prawidłowo zatrzymać i uruchomić aplikację.

app_offline.htm Można użyć ręcznie do uruchamiania i zatrzymywania aplikacji (wymaga programu PowerShell 5 lub nowszego):

$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

W poprzednim skry skryptzie programu PowerShell:

  • Symbol zastępczy {PATH TO APP} to ścieżka do aplikacji.
  • Polecenie New-Item zatrzymuje pulę aplikacji.
  • Polecenie Remove-Item uruchamia pulę aplikacji.
  • Polecenia między poleceniem New-Item a Remove-Item poleceniem są udostępniane przez dewelopera w celu wdrożenia aplikacji.

Pliki można również odblokować, ręcznie zatrzymując pulę aplikacji w Menedżerze usług IIS na serwerze. Nie używaj app_offline.htm pliku podczas korzystania z Menedżera usług IIS, aby zatrzymać i ponownie uruchomić pulę aplikacji.