Partager via

Fichier App Offline (app_offline.htm)

  • Article

Remarque

Ceci n’est pas la dernière version de cet article. Pour la version actuelle, consultez la version .NET 9 de cet article.

Avertissement

Cette version d’ASP.NET Core n’est plus prise en charge. Pour plus d’informations, consultez la stratégie de support .NET et .NET Core. Pour la version actuelle, consultez la version .NET 9 de cet article.

Important

Ces informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Pour la version actuelle, consultez la version .NET 9 de cet 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.