https://github.com/dpb587/dynamic-metalink-resource

A Concourse resource for managing versions/files from arbitrary sources.
https://github.com/dpb587/dynamic-metalink-resource

concourse-resource metalink

Last synced: 5 days ago
JSON representation

A Concourse resource for managing versions/files from arbitrary sources.

• Host: GitHub
• URL: https://github.com/dpb587/dynamic-metalink-resource
• Owner: dpb587
• License: mit
• Created: 2018-06-09T16:26:06.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-09-07T01:34:11.000Z (over 6 years ago)
• Last Synced: 2024-10-30T18:13:55.173Z (about 2 months ago)
• Topics: concourse-resource, metalink
• Language: Go
• Size: 3.04 MB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# dynamic-metalink-resource

A [Concourse](https://concourse.ci) resource for managing versions/files from arbitrary sources.

## Source Configuration

 * **`version_check`** - a script to execute which will output an unordered list of all semvers (one per line)

 * **`metalink_get`** - a script to generate [metalink](https://github.com/dpb587/metalink) content for the given `version` passed as an environment variable

 * `signature_trust_store` - identities and keys used for signature verification

 * `skip_hash_verification` - skip hash verification of files

 * `skip_signature_verification` - skip signature verification of files

 * `version` - a [supported](https://github.com/Masterminds/semver#basic-comparisons) version constraint (e.g. `^4.1`)

 * `include_files` - a list of file globs to match when downloading a version's files (used by `in`)

 * `exclude_files` - a list of file globs to skip when downloading a version's files (used by `in`)

## Operations

### `check`

Check for new versions.

Version:

* `version` - semantic version (e.g. `4.1.2`)

### `in`

Download and verify the referenced file(s).

* `.resource/metalink.meta4` - metalink data used when downloading the file

* `.resource/version` - version downloaded (e.g. `4.1.2`)

* `*` - the downloaded file(s) from the metalink

Parameters:

* `skip_download` - do not download blobs (only `metalink.meta4` and `version` will be available)

Metadata:

* `bytes` - total bytes of files

* `files` - number of files

### `out`

Unsupported.

## Usage

To use this resource type, you should configure it in the [`resource_types`](https://concourse-ci.org/resource-types.html) section of your pipeline.

    - name: dynamic-metalink

      type: docker-image

      source:

        repository: dpb587/dynamic-metalink-resource

The default `latest` tag will refer to the current, stable version of this Docker image. For using the latest development version, you can refer to the `master` tag. If you need to refer to an older version of this image, you can refer to the appropriate `v{version}` tag.

## Examples

Some examples of using this resource for upstream dependencies (e.g. [`golang`](examples/golang.yml), [`nginx`](examples/nginx.yml), [`openssl`](examples/openssl.yml)) are available in [`examples`](examples).

## License

[MIT License](LICENSE)