Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A (scheduled) window is a time range in which deployments are allowed to a particular environment. Time range is defined using cron expressions. Deploy or Execution request when submitted will be scheduled to run during next available window and it will execute (provided no other approval is configured) when scheduled window is reached. Deploy or Execution request submitted with Start Time that falls outside of the window will require the approval of a configured approver. If current time is already in scheduled window, then deploy or execution request will not have to wait for next scheduled window.

...

To add a window to a folder, open a folder.

Go to the Scheduled windows Windows tab.

Click Override Windows.

...

Select Approval groups who must approve exceptions to this window.

...

Click Save.

Creating

...

a new Window

Select Projects from the menu.

To create a window, open a folder.

Click Manage Folder in the top right corner.

Go to the Scheduled windows Windows tab.

Click Override Windows.

...

Click the Create button to create a new window.

...

Select the Environment, Workflow Type, Active status, and a Cron Expression defining the open window. Cron expressions provide the ability to specify complex time combinations such as "From 3:00- 3:30 pm every Friday" or "At 1:30am every last Friday of the month". Cron expressions are comprised of 6 required fields and one optional field separated by white space.  The fields respectively are described as follows:

Field Name

Allowed Values

Allowed Special Characters

Seconds

0-59

, - * /

Minutes

0-59

, - * /

Hours

0-23

, - * /

Day-of-month

1-31

, - * ? / L W

Month

1-12 or JAN-DEC

, - * /

Day-of-Week

1-7 or SUN-SAT

, - * ? / L #

Year (Optional)

empty, 1970-2199

, - * /

Info

Multiple Cron Expressions can be specified using semicolon as a delimeter. For example, 

0 0 11 ? * *;0 0 12 ? * *

is equivalent to

0 0 11-12 ? * *

A new Admin Screen was added to test expressions in the Administration Menu on the Admin Operations Screen.

Tip

For details on Cron Expression Syntax see http://www.quartz-scheduler.org/documentation/quartz-2.2.2/tutorials/crontrigger.html#crontrigger-tutorial

Examples

Expression

Means

0 0 12 * * ?

12:00 PM (noon) every day

0 15 10 ? * *

10:15 AM every day

0 15 10 * * ?

10:15 AM every day

0 15 10 * * ? *

10:15 AM every day

0 15 10 * * ? 2005

10:15 AM every day during the year 2005

0 * 14 * * ?

Every minute starting at 2:00 PM and ending at 2:59 PM, every day

0 0/5 14 * * ?

Every 5 minutes starting at 2:00 PM and ending at 2:55 PM, every day

0 0/5 14,18 * * ?

Every 5 minutes starting at 2:00 PM and ending at 2:55 PM, AND fire every 5 minutes starting at 6:00 PM and ending at 6:55 PM, every day

0 0-5 14 * * ?

Every minute starting at 2:00 PM and ending at 2:05 PM, every day

0 10,44 14 ? 3 WED

At 2:10 PM and at 2:44 PM every Wednesday in the month of March

0 15 10 ? * MON-FRI

At 10:15 AM every Monday, Tuesday, Wednesday, Thursday and Friday

You can also select one of several example cron expressions from the drop-down.

...

Select one or more Approval Groups from the dropdown who must approve deployments requested outside of the window. See Security chapter for details on creating and managing groups. Click the Save button to save.

Editing

...

an existing Window

Select Projects from the menu.

Click on the existing Folder, and now click on the Scheduled Windows tab.

...

Click on a window Id to Edit the existing window.

...