Create Release Task
The Create Release task enables you to automatically create and start a release based on a configured template.
Input Properties
The following properties configure the behavior of the Create Release task:
Property | Description |
---|---|
Release Title | The title for the newly created release |
Template | The template to create the release from, or a variable containing the template ID |
Folder | The destination folder for the new release |
Risk Profile | The risk profile to assign to the release |
Start Release | When enabled, automatically starts the release after creation (enabled by default) |
Release Tags | Tags to add to the new release (supports variables using ${...} syntax) |
Variables | Required template variables to populate (if applicable) |
Release ID | Output property storing the ID of the created release |
Wait for Release to Finish | Controls task completion behavior: - Enabled: Task waits for sub-release completion - Disabled: Task completes after initiating sub-release |
In the Release Flow Editor, Create Release tasks are visually distinguished with a green border.
Template Name Display in Dropdown
The Template dropdown now displays both folder paths and template names, improving template selection.
The system applies intelligent name truncation:
- Single root folders: Names truncate at the end
- Nested folders: Names truncate at the beginning
- Template names: Always truncate at the end
- Hovering reveals full names via tooltip
Automated Tasks User Configuration
Create Release tasks require an assigned automated tasks user. This user must have:
- The "Create Release" permission on the specified template
- Assignment through the "Run automated tasks as user" release property
The automated tasks user carries over to the new release, overriding any template-specific user assignments. For more details, see Configure Release Properties.
Dynamic Template and Variable Assignment
Templates can be dynamically assigned using release variables. Toggle the template selector to variable mode to:
- Select from existing global/release variables
- Create new variables directly
- Configure dynamic variable values
- Pass template variables through the Create Release task
Folder Variable Selection
The destination folder can be dynamically set using a text-type variable:
- Create a folder variable if needed
- Toggle the folder selector to variable mode
- Choose from available release/folder/global variables
The selected variable's value determines the Folder ID at runtime.
Working with the Created Release ID
The new release's unique ID is stored in the task's "Created Release ID" output property. You can:
- Map this ID to a variable for use in other tasks
- Use it in Gate tasks to coordinate release flow
- Track the sub-release progress when needed
Without saving the ID to a variable, the release proceeds normally but cannot reference the sub-release.
Concurrent Release Limits
To maintain optimal performance, Release enforces a default limit of 100 concurrent releases from Create Release tasks. To modify this limit:
- Locate
XL_RELEASE_SERVER_HOME/conf/deployit-defaults.properties
- Uncomment and adjust
xlrelease.Release.maxConcurrentReleases
- Restart the Release server to apply changes