tracks BOSH releases published on
Switch branches/tags
Nothing to show
Clone or download
vito Merge pull request #15 from EngineerBetter/master
Add support for fetching specific versions of releases.
Latest commit b7d0e93 Aug 23, 2018 release resource

Tracks the versions of a release on

For example, to automatically consume releases of Concourse:

- name: concourse
  type: bosh-io-release
    repository: concourse/concourse

Source Configuration

  • repository: Required. The GitHub repository of the release, i.e. username/reponame.
  • regexp: Optional A regular expression matching the version(s) to fetch, i.e. 13.*.


check: Check for new versions of the release.

Detects new versions of the release that have been published to If no version is specified, check returns the latest version, otherwise check returns all versions from the version specified on.

Note that there may be a delay between the final release appearing on GitHub, and it appearing in

in: Fetch a version of the release.

Fetches a given release, placing the following in the destination:

  • version: The version number of the release.
  • url: A URL that can be used to download the release tarball.
  • sha1: The sha1 of the release tarball.
  • release.tgz: The release tarball, if the tarball param is true.


  • tarball: Optional. Default true. Fetch the release tarball.



  • docker is required - version 17.06.x is tested; earlier versions may also work.

Running the tests

The tests have been embedded with the Dockerfile; ensuring that the testing environment is consistent across any docker enabled platform. When the docker image builds, the test are run inside the docker container, on failure they will stop the build.

Run the tests with the following command:

docker build -t bosh-io-release-resource .


Please make all pull requests to the master branch and ensure tests pass locally.