Compartir a través de

Archivo App Offline (app_offline.htm)

  • Artículo

Nota:

Esta no es la versión más reciente de este artículo. Para la versión actual, consulte la versión de .NET 9 de este artículo.

Advertencia

Esta versión de ASP.NET Core ya no se admite. Para obtener más información, consulta la Directiva de soporte técnico de .NET y .NET Core. Para la versión actual, consulta la versión .NET 8 de este artículo.

Importante

Esta información hace referencia a un producto en versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.

Para la versión actual, consulte la versión de .NET 9 de este artículo.

El módulo de ASP.NET Core usa el archivo App Offline (app_offline.htm) para cerrar una aplicación.

Si se detecta un archivo con el nombre app_offline.htm en el directorio raíz de una aplicación, el módulo de ASP.NET Core intenta cerrar correctamente la aplicación y deja de procesar las solicitudes entrantes. Si la aplicación se sigue ejecutando después del número de segundos definido en shutdownTimeLimit, el módulo de ASP.NET Core termina el proceso en ejecución.

Mientras el archivo app_offline.htm existe, el módulo ASP.NET Core responde a solicitudes con la devolución del contenido del archivo app_offline.htm. El tamaño de app_offline.htm debe ser inferior a 4 GB. Cuando se quita el archivo app_offline.htm, la solicitud siguiente inicia la aplicación.

Al usar el modelo de hospedaje fuera de proceso, puede que la aplicación no se apague inmediatamente si hay una conexión abierta. Por ejemplo, una conexión WebSocket puede retrasar el apagado de la aplicación.

Archivos de implementación bloqueados

Los archivos de la carpeta de implementación se bloquean cuando se ejecuta la aplicación. Los archivos bloqueados no se pueden sobrescribir durante la implementación.

app_offline.htm es el mecanismo principal para liberar archivos bloqueados. Web Deploy usa app_offline.htm para detener e iniciar la aplicación correctamente.

app_offline.htm puede usarse manualmente para iniciar y detener la aplicación (requiere PowerShell 5 o 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

En el anterior script de PowerShell:

  • El marcador de posición {PATH TO APP} es la ruta de acceso a la aplicación.
  • El comando New-Item detiene el grupo de aplicaciones.
  • El comando Remove-Item inicia el grupo de aplicaciones.
  • El desarrollador proporciona comandos entre el comando New-Item y el comando Remove-Item para implementar la aplicación.

Los archivos también se pueden desbloquear si se detiene manualmente el grupo de aplicaciones en el Administrador de IIS en el servidor. No use el archivo app_offline.htm al usar el Administrador de IIS para detener y reiniciar el grupo de aplicaciones.