Share via

Fichier App Offline (app_offline.htm)

  • Article

Le fichier App Offline (app_offline.htm) est utilisé par le module ASP.NET Core pour arrêter une application.

Si un fichier portant le nom app_offline.htm est détecté dans le répertoire racine d’une application, le module ASP.NET Core tente d’arrêter normalement l’application, puis interrompt le traitement des requêtes entrantes. Si l’application est toujours active après le nombre de secondes défini dans shutdownTimeLimit, le module ASP.NET Core met fin au processus en cours d’exécution.

Tant que le fichier app_offline.htm est présent, le module ASP.NET Core répond aux requêtes en renvoyant le contenu du fichier app_offline.htm. app_offline.htm doit faire moins de 4 Go. Lorsque le fichier app_offline.htm est supprimé, la requête suivante démarre l’application.

Lorsque vous utilisez le modèle d’hébergement out-of-process, l’application peut ne pas s’arrêter immédiatement s’il existe une connexion ouverte. Par exemple, une connexion WebSocket peut retarder l’arrêt de l’application.

Fichiers de déploiement verrouillés

Les fichiers dans le dossier de déploiement sont verrouillés quand l’application est en cours d’exécution. Les fichiers verrouillés ne peuvent pas être remplacés au cours du déploiement.

app_offline.htm est le mécanisme principal pour libérer les fichiers verrouillés. app_offline.htm est utilisé par Web Deploy pour arrêter et démarrer correctement l’application.

app_offline.htm peut être utilisé manuellement pour démarrer et arrêter l’application (nécessite PowerShell 5 ou version ultérieure) :

$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

Dans le script PowerShell précédent :

  • L’espace réservé {PATH TO APP} est le chemin d’accès à l’application.
  • La commande New-Item arrête le pool d’applications.
  • La commande Remove-Item démarre le pool d’applications.
  • Les commandes entre New-Item et Remove-Item sont fournies par le développeur pour déployer l’application.

Les fichiers peuvent également être déverrouillés en arrêtant manuellement le pool d’applications dans le Gestionnaire des services Internet sur le serveur. N’utilisez pas le fichier app_offline.htm lors de l’utilisation du Gestionnaire IIS pour arrêter et redémarrer le pool d’applications.