overview.md

Task Utilities

Release Management utility tasks 1.Tokenizer 2.Powershell++ 3.Shell++ 4.Zip & Unzip 5.Powershell to rollback

Details:

###Tokenizer The task is used to tokenize environment specific configuration:

Tokenization based pattern replacement

This task finds the pattern: __<pattern>__ and replaces the same with the value from the variable with name <pattern>. Eg. If you have a vriable defined as foo with value bar, on running this task on a file that contains __foo__ will be changed to bar.

(Optional) Tokenization based on XML / XPath

If Configuration Json filename is provided (optional): A configuration Json document is provided as an input that contains a section ConfigChanges to provide KeyName the XPath to identify a particular node in the XML document, Attribute name that needs to be set and Value to be set. And this configuration can be maintained for multiple environments. Below is the sample for the Json document that can be provided as input. There can be multiple sections for each . There can also be a non-environment related set of Config changes. Its recommended to put tokens here for values, then they will be replaced by the tokenize step with variable values.

{
	"<environment>": {
		"CustomVariables": {
		"Variable1": "value1",
		"Variable2": "value2",
		},
		"ConfigChanges": [
			{
			  "KeyName": "/configuration/appSettings/add[@key='EnableDebugging']",
			  "Attribute":"value",
			  "Value":"false"
			},
			{
			  "KeyName":“/configuration/connectionStrings/add[@name='databaseentities']”,
			  "Attribute": "connectionString",
			  "value": "Integrated Security=True;Persist Security Info=False;Initial Catalog=DB;Data Source=servername"
			}
		]
	},
	"ConfigChanges": [
        {
          "KeyName": "/configuration/appSettings/add[@key='ServiceURL']",
          "Attribute":"value",
          "Value":"__ServiceUrl__"
        }
	]
}

Below is the list of inputs for the task: Source filename* - Source file name that contains the tokens (____). These patterns will be replaced with user-defined variables or from Configuration Json FileName. If it is an XML document, XPaths mentioned in the Configuration JsonFileName will be set as per environment. Destination filename (optional) - Destination filename that has transformed Source filename. If this is empty, the 'Source filename' will be modified. Configuration Json filename (optional) - Json file that contains environment and non-environment specific settings in the form XPath, Attribute, Value and values for user-defined variables. Refer above for the schema/format of the Json filename. If this parameter is not specified, then custom variables mentioned against the build/release are used to replace the tokens that match the regular expression ____

###PowerShell++ This task lets you write your powershell script inline in the task textbox itself.
###Shell++ This task lets you write your powershell script inline in the task textbox itself.
###Zip & Unzip This task lets you create zip files and Unzip archives on a windows agent.
###Rollback The task is used to enable execution of rollback scripts for the environments. In case of rollback, you would need to know which of the tasks were executed successfully and which of the tasks failed. You would need to undo/fix the changes made to the environment by those tasks only. Release does not have pre-defined variables that indicate the status of the tasks executed in the job. That makes using an intelligent rollback script difficult. Rollback task facilitates exactly that. You can author a powershell script for reverting/ fixing the changes done to your environment by the deployment.

Ensure that Run always* control option is enabled for the rollback task, so that the script can get executed when any of the tasks in the job fail.

"Release_Tasks" environment variable shall be set by the task to make the execution status of each of the tasks in the deployment job available for the powershell script. An example to access the task execution information is as follows.

try
{
   $jsonobject = ConvertFrom-Json $env:Release_Tasks
}
catch
{
   Write-Verbose -Verbose "Error converting from json"
   Write-Verbose -Verbose $Error
}


foreach ($task in $jsonobject | Get-Member -MemberType NoteProperty) {    
   $taskproperty = $jsonobject.$($task.Name) | ConvertFrom-Json
   Write-Verbose -Verbose "Task $($taskproperty.Name) with rank $($task.Name) has status $($taskproperty.Status)"
}