Welcome to AspAdvice Sign in | Join | Help

Tweak web.config To Set Compilation Debug False

ASP.NET applications should never run with <compilation debug="true"> in production.  It can have drastic performance implications (of the negative kind).  Obviously, in a perfect world, developers would always remember to verify this setting whenever they upload changes to production, but unfortunately many organizations utilize fallible humans in their deployment process, and this is something that is easily missed.

As part of an automated build process, this problem can be eliminated fairly easily.  Most sections within web.config can be extracted to separate files (using the configSource="{path}" attribute), and separate files can be pulled in for TEST, STAGE, and PRODUCTION environments.  However, the bulk of the <system.web> section will likely need to be the same between all three of these environments, so maintaining separate versions of this configuration element would violate DRY and would be prone to problems.  The solution in this case is to keep these settings in the main web.config file, and tweak them as part of the deployment process within the automated build.  If you're using Web Deployment Projects, they can help in this case.  If you're not, keep reading.

The easiest way to accomplish the modification of the web.config file is with an EXE that can be called from MSBuild, NAnt, CCNET, or whatever build automation software you're using.  If you're only using one of these, it might make sense to create a custom MSBuild or NAnt task just for this purpose, but having the EXE is a bit more general purpose as it can then be called from any of these, or even from a batch file.  I decided to name the EXE TweakConfig, and while it includes some code for checking parameters and such, its main function boils down to this (thanks Dan Wahlin for the original version of this code):

        private static void ModifyDebugValue(string path, bool debugState)
            XmlDocument doc = new XmlDocument();
            XmlElement compile = 
doc.DocumentElement.SelectSingleNode("system.web/compilation") as XmlElement; if (compile != null) { compile.SetAttribute("debug", debugState.ToString().ToLower()); } doc.Save(path); } For example:
c:\>tweakconfig.exe web.config debug=false

would set the <compilation debug="true|false"> section to false.

We built this into a continuous integration solution for a client last week, and it's working great.  I've been helping a few different companies with their continuous integration server setup (with CruiseControl.NET), and wrote a white paper a couple of months ago for Microsoft on the topic (with TFS 2008), so this is an area I'm spending a fair bit of time on lately.  If you'd like help getting up to speed with automated builds and continuous integration for your company, feel free to contact me.

I've made the source project and the EXE available.  If you find any bugs or enhance it, please email me and I'll update my files.

Published Sunday, March 30, 2008 12:51 PM by ssmith
Filed under: , ,


New Comments to this post are disabled