a resource for triggering on an interval
Go Shell
Latest commit 52b2ded Jan 4, 2017 @ClaraFuPivotal ClaraFuPivotal committed with mariash fix test to not depend on leap year
[#137037149]

Signed-off-by: Maria Shaldibina <mshaldibina@pivotal.io>

README.md

Time Resource

Implements a resource that reports new versions on a configured interval. The interval can be arbitrarily long.

This resource is built to satisfy "trigger this build at least once every 5 minutes," not "trigger this build on the 10th hour of every Sunday." That level of precision is better left to other tools.

Source Configuration

  • interval: Optional. The interval on which to report new versions. Valid values: 60s, 90m, 1h.

  • location: Optional. Default UTC. The location in which to interpret start, stop, and days.

    e.g.

    location: Africa/Abidjan
    
  • start and stop: Optional. Only create new time versions between this time range. The supported formats for the times are: 3:04 PM, 3PM, 3 PM, 15:04, and 1504.

    e.g.

    start: 8:00 PM
    stop: 9:00 PM
    

    Deprecation: an offset may be appended, e.g. +0700 or -0400, but you should use location instead.

  • days: Optional. Run only on these day(s). Supported days are: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday and Saturday.

    e.g.

    days: [Monday, Wednesday]
    

These can be combined to emit a new version on an interval during a particular time period.

Behavior

check: Produce timestamps satisfying the interval.

Returns current version and new version only if it has been longer than interval since the given version, or if there is no version given.

in: Report the given time.

Fetches the given timestamp, writing the request's metadata to input in the destination.

Parameters

None.

out: Produce the current time.

Returns a version for the current timestamp. This can be used to record the time within a build plan, e.g. after running some long-running task.

Parameters

None.

Examples

Periodic trigger

resources:
- name: 5m
  type: time
  source: {interval: 5m}

jobs:
- name: something-every-5m
  plan:
  - get: 5m
    trigger: true
  - task: something
    config: # ...

Trigger once within time range

resources:
- name: after-midnight
  type: time
  source:
    start: 12:00 AM
    stop: 1:00 AM
    location: Asia/Sakhalin

jobs:
- name: something-after-midnight
  plan:
  - get: after-midnight
    trigger: true
  - task: something
    config: # ...

Trigger on an interval within time range

resources:
- name: 5m-during-midnight-hour
  type: time
  source:
    interval: 5m
    start: 12:00 AM
    stop: 1:00 AM
    location: America/Bahia_Banderas

jobs:
- name: something-every-5m-during-midnight-hour
  plan:
  - get: 5m-during-midnight-hour
    trigger: true
  - task: something
    config: # ...