Partilhar via

Ficheiro offline da app (app_offline.htm)

Observação

Esta não é a versão mais recente deste artigo. Para a versão atual, consulte a versão .NET 10 deste artigo.

Advertência

Esta versão do ASP.NET Core não é mais suportada. Para obter mais informações, consulte a Política de suporte do .NET e do .NET Core. Para a versão atual, consulte a versão .NET 10 deste artigo.

O ficheiro App Offline (app_offline.htm) é usado pelo ASP.NET Módulo Core para encerrar uma aplicação.

Se um ficheiro com esse nome app_offline.htm for detetado no diretório raiz de uma aplicação, o Módulo Core ASP.NET tenta desligar a aplicação de forma gradual e parar o processamento de pedidos recebidos. Se a aplicação continuar a funcionar após o número de segundos definido em shutdownTimeLimit, o Módulo Núcleo ASP.NET interrompe o processo em execução.

Enquanto o app_offline.htm ficheiro está presente, o ASP.NET Módulo Núcleo responde aos pedidos enviando de volta o conteúdo do app_offline.htm ficheiro. app_offline.htm deve ter menos de 4 GB. Quando o app_offline.htm ficheiro é removido, o próximo pedido inicia a aplicação.

Ao usar o modelo de alojamento fora de processo, a aplicação pode não desligar imediatamente se houver uma ligação aberta. Por exemplo, uma ligação WebSocket pode atrasar o encerramento da aplicação.

Ficheiros de implantação bloqueados

Os ficheiros na pasta de implementação ficam bloqueados quando a aplicação está a correr. Ficheiros bloqueados não podem ser sobrescritos durante a implementação.

app_offline.htm é o principal mecanismo para libertar ficheiros bloqueados. app_offline.htm é usado pelo Web Deploy para parar e iniciar corretamente a aplicação.

app_offline.htm pode ser usado manualmente para iniciar e parar a aplicação (requer PowerShell 5 ou posterior):

$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

No script PowerShell anterior:

  • O marcador {PATH TO APP} é o caminho para a aplicação.
  • O New-Item comando interrompe o pool de aplicações.
  • O Remove-Item comando inicia o pool de aplicações.
  • Os comandos entre o New-Item comando e o Remove-Item comando são fornecidos pelo programador para implementar a aplicação.

Os ficheiros também podem ser desbloqueados parando manualmente o pool de aplicações no Gestor IIS do servidor. Não uses o app_offline.htm ficheiro quando usares o gestor IIS para parar e reiniciar o pool de aplicações.

  • Last updated on