Tuesday, February 8, 2011

Using XDT with Worker Role App.configs

Recently I wrote a worker role in windows azure and was hoping the app.config would transform much like the web.config in the web roles. Sadly this is not the case. The configuration transforms are very useful when making a distinction between production, staging and development environments. After a little research, I did discover how to roll my own hopefully Microsoft will extend this feature to the rest of the azure project types.

Like the web roles this transform is only executed when a deploy is executed, here is how it was done:

  1. Un-load the project containing your worker role and app.config
  2. Edit the project file at the bottom add the following lines:

    <usingtask taskname="TransformXml" assemblyfile="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v10.0\Web\Microsoft.Web.Publishing.Tasks.dll">
    <target name="AfterCompile" condition="exists('app.$(Configuration).config')">
    <transformxml source="app.config" destination="$(IntermediateOutputPath)$(TargetFileName).config" transform="app.$(Configuration).config">
    </transformxml></target>
    </usingtask>


  3. Add the following Item Group:

    <ItemGroup>
    <Content Include="App.config" />
    <Content Include="App.Debug.Config">
    <DependentUpon>App.Config</DependentUpon>
    <SubType>Designer</SubType>
    </Content>
    <Content Include="App.Release.Config">
    <DependentUpon>App.Config</DependentUpon>
    </Content>
    </ItemGroup>
  4. Now add the new configuration files to the project App.Debug.config, App.Release.config
  5. Reload the worker role project project
  6. Unload the cloud service project that references the worker role
  7. Open the file for edit and add the following line:

    <Target Name="CopyWorkerRoleConfigurations" BeforeTargets="AfterPackageComputeService">
    <Copy SourceFiles="..\{PROJECT PATH}\obj\$(Configuration)\{ASSEMBLY NAME}.dll.config" DestinationFolder="$(IntermediateOutputPath)\{PROJECT NAME}" OverwriteReadOnlyFiles="true"/>
    </Target>

  8. Reload the project file

You will need to use the name of your project and the assembly name in the locations above. The paths are relative to the azure service project file. If you get lost you can add an element to the target and set the text to your path.