| Change type | Description |
|---|---|
| Introduced in version 13.1 | A new Calendar tab has been added under . This tab allows you to define custom calendars within the environment setup, specifying dates to be excluded from processing. |
You can access the Calendars page from the tab.
Add schedule exclusion calendars
- From the menu at the top of the screen, select .
- In the list of environments on the left side of the screen, select the environment where you want to add the new calendar.
- Select the Calendars tab, then click New.
- Enter the calendar name and add the desired dates.
- Click Apply Changes.
The fields in the Add Calendar dialog allow you to set a name and add dates for the selected environment, as described below:
- Calendar Name - Enter a name for the calendar. Using a clear and descriptive name makes it easier to identify and organize your calendars. For example, "Business holidays".
- New Date - Click to add a new date to your calendar.
- Dates:
- Name: Enter a name for the date. For example, "New Year's Day".
- Date: Select the specific date.
Edit calendar
- From the menu at the top of the screen, select .
- In the list of environments on the left side of the screen, select the environment where you want to edit the calendar.
- Click the vertical ellipsis next to the calendar you want to edit.
- Select Edit and update the necessary fields.
- Click Apply Changes to save your updates.
Delete calendar
- From the menu at the top of the screen, select .
- In the list of environments on the left side of the screen, select the environment that contains the calendar you want to delete.
- Click the vertical ellipsis next to the calendar you want to delete.
- Confirm the deletion when prompted.
Set default exclusion calendar
Each environment can have one calendar set as the default exclusion calendar. The default calendar is automatically applied to any scheduled executable stage (such as daily or weekly jobs), unless a different calendar is specifically selected. When used, this calendar prevents scheduled stages from running on the specified exclusion dates.
- Prevent failed or incomplete runs.
- Reduce unnecessary compute or cloud costs.
Setting a default calendar makes administration easier by providing a baseline schedule for the environment.
To set an exclusion calendar as the default:
- Click the vertical ellipsis next to the calendar you created.
- Select Set as Default
Use additional calendars
In addition to the default calendar, you can create additional calendars to meet different requirements for various pipelines or projects:
- For example, a financial team’s pipeline might use a quarter-end freeze calendar, while the engineering team might follow a sprint deployment blackout calendar.
- Scheduled stages can be set to:
- Use the default calendar, or
- Override the default by choosing a specific custom calendar for each stage.
Export and Import calendars
Export calendars from one environment and import them into another to achieve the following benefits:
- Consistency across development, testing, and production environments.
- Reusability of calendar definitions, which helps reduce setup time and manual work.
- Standardized operational behavior when moving pipelines through different stages of the deployment lifecycle.
This approach is especially helpful for organizations with shared holiday schedules or global teams that require consistent scheduling rules.
Export calendar
- From the menu at the top of the screen, select .
- In the list of environments on the left side of the screen, select the environment you want to export calendars from.
- Click Export.
Import calendar
- An invalid file cannot be imported, and an error message will appear.
- If a file contains a calendar with a name that already exists in the list, the existing calendar will be replaced.
- Calendars that do not already exist will be added to the environment.
- All other calendars will remain unchanged by the import.
- From the menu at the top of the screen, select .
- From the list of environments on the left side of the screen, select the environment where you want to import the calendars.
- Click Import.