Creating project templates

When you create project template, you identify the agent pool that it uses, and configure pre-processing options. You can add project-level properties to a project.

  1. From the IBM® UrbanCode™ Build dashboard, click Templates, then click Create.
  2. Using the Create a Project Template dialog, type a name for the template in the Name field.
  3. Select a team to manage the template from the Team list.
    Until you create your own teams, the System Team is available. For information about creating teams, see Security teams
  4. Click Save.
    The Build Pre-Processing tab is displayed. To complete the template, you must define the required fields on this page.
  5. Type a number of seconds to wait between builds in the Time Period field.

    The quiet period determines the amount of time that must pass after changes are made to the source before another build can begin. The value represents seconds.

  6. Type a number of seconds to wait between merge triggers in the Merge Period field.
    The merge period is the amount of time to wait after a file is added to the source repository before another build can begin. The value represents seconds.
  7. Specify criteria that are used to search for source and dependency changes.

    To use a label, type a property or a property value. To specify a property, use the property syntax, such as ${p:my.property}. To specify a property value, type the value, such as my property value.

    To use a stamp, enter the stamp value or a pattern. Patterns can contain '?' for a single character, and '*' any sequence of characters. For example, 1.? matches 1.2 but not 1.2.0; 1.* matches both 1.2 and 1.2.0.

    Use the plus icon to enter additional values. Use the drag-and-drop icon to reorder values. If multiple values are specified, they are searched in order, top to bottom.

  8. Specify an agent pool:
    1. To pick a specific pool, click Agent Pool Selection, then select the pool from the list.
      The job runs on the first available agent in the selected pool.
    2. To select the pool by property, click Agent Pool Property, then type the property, such as ${p:my.property}.
  9. To clean the working directory before processing begins, select Yes for the Should Claenup option; otherwise, select No.
  10. To use a precondition script for steps using this template, select the script from the Step Pre-Condition Script list.
    For information about step precondition scripts, see Creating step-precondition scripts
  11. Click Save.
After creating the project template, use the Properties tab to define template properties. For information, see Creating project template properties.