Schedule GT Framework tests
You can configure GT Framework tests to run automatically by creating a schedule.
Define schedule details
-
In the Automated Builds app, select + Create schedule.
-
Provide the following details:
-
Name
Schedule name must be unique within application.
This field is case sensitive.
-
Branch filter
Specify branches on which the selected builds will run.
Add each rule in a new line. Branch names are case-sensitive. You can also use a wildcard:
*
.Examples
-
Include a specific branch:
+:branch_name
-
Exclude a specific branch:
-:branch_name
-
Include only the default branch:
+:<default>
-
Include all branches:
+:*
-
Include all branches except for the default one:
+:*
-:<default> -
Include all branches prefixed with feature-:
+:feature-*
-
-
Application
Select GtFramework.
-
Select and configure GT Framework tests
-
In Select and configure builds, select tests.
You can schedule GT Framework Tests, GT Framework API Tests, or GT Framework UI Tests.
-
To customize build parameters, select Configure next to chosen tests.
-
(Optional) To customize the build configuration, select Override next to each parameter and update its value.
For GT Framework Tests, depending on your build version, select the Pre-Garmisch or Garmisch or later tab. For pre-Garmisch builds, you must define Tested Module Name. Make sure that the test suite specified for this build is located in the module.
If a schedule contains a disabled build, the Automated Builds app displays a warning next to the schedule name.
Note:Customized parameters apply only to the scheduled build and override parameters specified through other means, for example through configuration files. This step modifies the default configuration of your build.
-
Save your changes.
Define date and time
To specify when to run the schedule, use cron syntax.
You can use the following values in a cron expression:
Field | Possible values | Special characters | Notes |
---|---|---|---|
Seconds | 0–59 | , - * / | |
Minutes | 0–59 | , - * / | |
Hours | 0–23 | , - * / | |
Day of the month | 1–31 | , - * / ? L W | |
Month | 1–12 or JAN–DEC | , - * / | |
Day of the week | 1–7 or SUN-SAT | , - * / ? L W | The first day of the week is Sunday. |
Year | 1970-2099 or empty | , - * / | This field is optional. |
For example, you can set your schedule to run:
- Every Monday at noon:
0 0 12 ? * 2
- Every day at 6 p.m.:
0 0 18 1/1 * ?
- On the first Friday of every month at 8:15 a.m.:
0 15 8 ? 1/1 6#1
A cron expression is relative to the selected time zone. You can choose a different time zone from the drop-down list.
Additional settings
In this step, you can also define additional settings:
-
Run only if there are pending changes
By default, the builds run according to the schedule even if there are no changes in your code. To trigger builds only if there are pending changes, check this option.
-
Active
By default, your schedule is set to Active.
You can also create inactive schedules and activate them later. For details, see Edit a schedule.