HowTo: ASP.NET MVC Anwendungen updaten – App_Offline.htm & AJAX
Um eine ASP.NET Anwendung umzudaten ist es oftmals auch nötig bestimmt dlls auszutauschen. Dazu muss natürlich auch die Anwendung runtergefahren werden. Mit ASP.NET 2.0 kam ein nettes Feature hinzu: Das App_Offline.htm. Mit diesem File kann man neue Requests abfangen und auch für AJAX Calls gibt es einen Workaround.
App_Offline.htm
Legt man ein File namens “App_Offline.htm” in den Web-Root leitet der IIS alle neuen Requests an dieses File weiter. Damit ist es möglich, dass man Usern während des Update Prozesses eine Informationsseite zu präsentieren. Diese Updateseite wird mit dem HTTP Code 404 ausgeliefert.
“IE Problem”
Es soll wohl bei dem IE zu Problemen kommen, wenn die Updateseite zu klein ( kleiner als 512 byte ) ist – dann stellt der IE seine eigene Fehlerseite dar. Hier reicht es einfach das HTML durch Kommentare etc. “aufzublähen”.
Hier das Beispiel von ScottGu:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Site Under Construction</title>
</head>
<body>
<h1>Under Construction</h1>
<h2>Gone to Florida for the sun...</h2>
<!--
Adding additional hidden content so that IE Friendly Errors don't prevent
this message from displaying (note: it will show a "friendly" 404
error if the content isn't of a certain size).
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
<h2>Gone to Florida for the sun...</h2>
-->
</body>
</html>
Resultat
Wenn das File nun ins Webroot gelegt wird, wird nur das ausgegeben.
AJAX Problem
Was noch zu Problemen führen könnte wären WebApps in den AJAX eingesetzt wird. Die Webseite ist komplett geladen und der User klick fröhlich rum. Dann geht er einen Kaffee holen und in dieser Zeit aktualisieren wir die Anwendung. Jetzt wäre es natürlich schade wenn der nächste AJAX Call einfach nur ins Leere laufen würde – etwas schöner wäre ja, wenn man den Nutzer wenigstens sagt, dass die Anwendung gerade gewartet wird.
Lösung
Wie hier vorgeschlagen habe ich einfach einen besonderen HTML Kommentar in die Fehlerseite mit eingebaut:
<!--[AJAX_APP_OFFLINE_FLAG]-->
Jetzt kann ich z.B. über ein globales AJAX Exception Handling schauen ob dieser “Flag” vorkommt und wenn ja eine nettere Fehlermeldung ausgeben:
$(document).ajaxError(function(e, xhr, settings, exception) {
alert('Error!');
var responseText = xhr.responseText;
if (responseText.indexOf("<!--[AJAX_APP_OFFLINE_FLAG]-->") != -1) {
alert("Site update in progress... keep cool 
");
}
else {
alert('Real error! OMG!');
}
});
Resultat für den normalen Aufruf:
Resultat für AJAX Aufrufe:
Hinweis:
Damit der erste Aufruf bei euch funktioniert habe ich die “App_Offline.htm” mal in “xApp_Offline.htm” umbenannt.
Javascript und CSS Datein:
Sobald der IIS die App_Offline.htm entdeckt wird nur dieses File ausgeliefert. Somit kann man in der App_Offline.htm keine CSS Datei einbinden die in dieser Webapplikation liegt!
Frage in die Runde:
Wie ist eure Strategie wenn es um das Updaten von Anwendungen geht?
About the author
Written by Robert Mühsig
Robert Mühsig (@robert0muehsig) ist Webentwickler und beschäftigt sich mit Web-Frameworks (vor allem dem ASP.NET MVC Framework) und scheut sich auch nicht vor Javascript. Ansonsten bloggt er über all jene Probleme, die ihm über den Weg laufen. Seit 2008 ist er Microsoft MVP für ASP.NET und er arbeitet bei der T-Systems Multimedia Solutions GmbH in Dresden. Treffen kann man ihn online via Twitter (@robert0muehsig) oder dieser Seite oder bei der .NET User Group Dresden.
Björn
6. February 2010
Ich bin immer wieder erstaunt. Gestern erst unterhielt ich mich mit einem Kollegen und darüber, dass wir ein ASP.NET MVC Projekt in den Offlinemodus schalten sollten können, um es etwa zu updaten und heute der Beitrag. Tja, danke für die Arbeit, spart mir Zeit
Robert Mühsig
7. February 2010
Was ich noch nicht nachgeprüft habe ist, wie es sich mit CSS Datein oder Javascriptdatein verhält die man in der App_Offline.htm einbindet. Ansonsten müsste man die Styleeigenschaften für die App_Offline.htm direkt reinschreiben.
Ein anderer Punkt ist, dass man natürlich nur ein statisches File ausliefert – Lokalisierung ist dann natürlich schlecht möglich. Mh. Ideen (ohne das man eine Mondrakete baut)?
Robert Mühsig
8. February 2010
Ok, gerade mal nachgeprüft ob man noch auf JS und CSS Datein zugreifen kann: Nein. Auch Bilder werden nicht ausgeliefert. Der IIS sendet dem Client nur noch die App_Offline.htm. D.h. wenn man CSS und JS Datein einbinden will, muss man diese in einer anderen Webapp hosten.
Björn
8. February 2010
Eigentlich auch logisch
Muss man halt Grafiken auslagern 
Ksenia Orlowa
21. June 2011
Ich Tausche beim Update nur einige Wenige DLL,s aus, aber wen es dan doch mehr wird, dan Verwende ich App Öfline und sage den System einfach dass die Ajax Calls via JS Als Cookie gespeichert werden sollen.
Nach den Update werden die Cookes einfach An den Server geschickt und wie gewohnt verarbeitet. Meistens Tausche ich eh nur Content aus!