shreddedbacon/git-release-tags repository overview

⁠Git Release Tags Resource

A Concourse resource for the getting releases from github tags. Will only work for release tags that use semver in their tags.

This is handy for repositories that you don't manage, and the repository is only tagging releases, rather than actually creating GitHub releases that you could use the concourse github-release resource type to check with.

An example repository is nginx/nginx where tags of releases are listed as release-1.12.0, release-1.12.1, etc.

⁠Source Configuration

resource_types:
- name: git-release-tags
  type: docker-image
  source:
    repository: shreddedbacon/git-release-tags

resources:
- name: nginx
  type: git-release-tags
  source:
    repo: nginx
    owner: nginx
    token: <github api token>
    tag_prefix: release-
    per_page: 100
    version_family: 1.12

• repo is the name of the repository in github
• owner is the name of the repository owner in github
• token your github api token
• tag_prefix this should match what releases are listed as for the repository naming standard you want to check, ie nginx uses release-1.12.0, so the prefix is release-
• per_page specify the number of results to return in the github api call, defaults to 20 but you can increase if you are getting no results in a repo with lots of tags
• version_family you can use this to drill down the versions you want to watch, ie if you only want nginx version 1.12 and its patch releases, you can use version_family: 1.12
• get_assets set to True to only get tags that have release assets associated to them
• get_source_tar to False to not download the source tarball
• page_max will cycle through pages using github api up until this page max value is reached if no versions are found on the first page results

⁠Behavior

⁠check: Check for release tags

Checks if there are new versions of the source. You can query the resource for specific versions using fly -t <target> check-resource -r <pipeline>/<resource_name> --from version:<version>

⁠in: Download a version

Places the following files in the destination:

• source.tar.gz: The source tarball from the release tag
• url: A file containing the URL of the file
• version: The version of the resource

⁠out: Not implemented

Does nothing

⁠Example

jobs:
- name: get-nginx-source
  plan:
  - get: nginx
    trigger: true