Name: github-release-resource
Owner: Concourse
Description: a resource for github releases
Created: 2015-01-31 23:54:21.0
Updated: 2018-05-23 14:44:55.0
Pushed: 2018-05-23 14:44:53.0
Homepage: null
Size: 899
Language: Go
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Fetches and creates versioned GitHub resources.
If you're seeing rate limits affecting you then please add a token to the source configuration. This will increase your number of allowed requests.
owner
: Required. The GitHub user or organization name for the repository
that the releases are in.
repository
: Required. The repository name that contains the releases.
access_token
: Optional. Used for accessing a release in a private-repo
during an in
and pushing a release to a repo during an out
. The access
token you create is only required to have the repo
or public_repo
scope.
github_api_url
: Optional. If you use a non-public GitHub deployment then
you can set your API URL here.
github_uploads_url
: Optional. Some GitHub instances have a separate URL
for uploading. If github_api_url
is set, this value defaults to the same
value, but if you have your own endpoint, this field will override it.
insecure
: Optional. Default false
. When set to true
, concourse will allow
insecure connection to your github API.
release
: Optional. Default true
. When set to true
, put
produces
release and check
detects releases. If false
, put
and check
will ignore releases.
Note that releases must have semver compliant tags to be detected.
pre_release
: Optional. Default false
. When set to true
, put
produces
pre-release and check
detects prereleases. If false
, only non-prerelease releases
will be detected and published. Note that releases must have semver compliant
tags to be detected.
If release
and pre_release
are set to true
, put
produces
release and check
detects prereleases and releases.
drafts
: Optional. Default false
. When set to true
, put
produces
drafts and check
only detects drafts. If false
, only non-draft releases
will be detected and published. Note that releases must have semver compliant
tags to be detected, even if they're drafts.
tag_filter
: *Optional. If set, override default tag filter regular
expression of v?([^v].*)
. If the filter includes a capture group, the capture
group is used as the release version; otherwise, the entire matching substring
is used as the version.
me: gh-release
pe: github-release
urce:
owner: concourse
repository: concourse
access_token: abcdef1234567890
yaml
t: gh-release
yaml
t: gh-release
rams:
name: path/to/name/file
tag: path/to/tag/file
body: path/to/body/file
globs:
- paths/to/files/to/upload-*.tgz
To get a specific version of a release:
t: gh-release
rsion: { tag: 'v0.0.1' }
To set a custom tag filter:
me: gh-release
pe: github-release
urce:
owner: concourse
repository: concourse
tag_filter: "version-(.*)"
check
: Check for released versions.Releases are listed and sorted by their tag, using
semver semantics if possible. If version
is specified, check
returns releases from the specified version on. Otherwise, check
returns the latest release.
in
: Fetch assets from a release.Fetches artifacts from the given release version. If the version is not specified, the latest version is chosen using semver semantics.
Also creates the following files:
tag
containing the git tag name of the release being fetched.version
containing the version determined by the git tag of the release being fetched.body
containing the body text of the release.commit_sha
containing the commit SHA the tag is pointing to.globs
: Optional. A list of globs for files that will be downloaded from
the release. If not specified, all assets will be fetched.
include_source_tarball
: Optional. Enables downloading of the source
artifact tarball for the release as source.tar.gz
. Defaults to false
.
include_source_zip
: Optional. Enables downloading of the source
artifact zip for the release as source.zip
. Defaults to false
.
out
: Publish a release.Given a name specified in name
, a body specified in body
, and the tag to use
specified in tag
, this creates a release on GitHub then uploads the files
matching the patterns in globs
to the release.
name
: Required. A path to a file containing the name of the release.
tag
: Required. A path to a file containing the name of the Git tag to use
for the release.
tag_prefix
: Optional. If specified, the tag read from the file will be
prepended with this string. This is useful for adding v in front of version numbers.
commitish
: Optional. A path to a file containing the commitish (SHA, tag,
branch name) that the release should be associated with.
body
: Optional. A path to a file containing the body text of the release.
globs
: Optional. A list of globs for files that will be uploaded alongside
the created release.
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:
er build -t github-release-resource .
Please make all pull requests to the master
branch and ensure tests pass
locally.