Sdílet prostřednictvím

Soubor offline aplikace (app_offline.htm)

  • Článek

Poznámka:

Toto není nejnovější verze tohoto článku. Aktuální verzi najdete v tomto článku ve verzi .NET 9.

Upozorňující

Tato verze ASP.NET Core se už nepodporuje. Další informace najdete v zásadách podpory .NET a .NET Core. Aktuální verzi najdete v tomto článku ve verzi .NET 9.

Důležité

Tyto informace se týkají předběžného vydání produktu, který může být podstatně změněn před komerčním vydáním. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Aktuální verzi najdete v tomto článku ve verzi .NET 9.

Offline soubor aplikace (app_offline.htm) používá modul ASP.NET Core k vypnutí aplikace.

Pokud se v kořenovém adresáři aplikace zjistí soubor s názvem app_offline.htm , pokusí se ASP.NET Core Module aplikaci řádně vypnout a zastavit zpracování příchozích požadavků. Pokud aplikace stále běží po počtu sekund definovaných v shutdownTimeLimit, ASP.NET Core Module zastaví spuštěný proces.

V době, kdy app_offline.htm je soubor k dispozici, ASP.NET Core Module reaguje na požadavky odesláním obsahu app_offline.htm souboru. Musí app_offline.htm být menší než 4 GB. app_offline.htm Když se soubor odebere, spustí se další požadavek.

Pokud používáte model hostování mimo proces, nemusí se aplikace okamžitě vypnout, pokud existuje otevřené připojení. Například připojení Protokolu WebSocket může zpozdit vypnutí aplikace.

Uzamčené soubory nasazení

Když je aplikace spuštěná, soubory ve složce pro nasazení jsou uzamčené. Uzamčené soubory není možné během nasazování přepsat.

app_offline.htm je primární mechanismus uvolnění uzamčených souborů. app_offline.htm nástroj Web Deploy používá k správnému zastavení a spuštění aplikace.

app_offline.htm můžete aplikaci spustit a zastavit ručně (vyžaduje PowerShell 5 nebo novější):

$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

V předchozím skriptu PowerShellu:

  • Zástupný symbol {PATH TO APP} představuje cestu k aplikaci.
  • Příkaz New-Item zastaví fond aplikací.
  • Příkaz Remove-Item spustí fond aplikací.
  • Příkazy mezi příkazem New-Item a Remove-Item příkazem poskytuje vývojář k nasazení aplikace.

Soubory je možné odemknout také ručním zastavením fondu aplikací ve Správci služby IIS na serveru. Nepoužívejte app_offline.htm soubor při zastavení a restartování fondu aplikací pomocí Správce služby IIS.