Table of Contents
Concourse Resource Types
Welcome to the Concourse resource types repository! Here you can publish your resource type. Upon approval, it will be live in the Concourse docs site under the ‘Resource Types’ section (coming soon).
On this page, you’ll find details on how to contribute a resource type to the repository. You can find instructions on building a resource type here.
Submitting a Resource Type
Resource types can be submitted directly to this repo through a fork-and-PR workflow:
Add a yaml file for your resource type directly in the same folder as this README.md.
Follow the schema:
[OWNER_NAME]-[RESOURCE_TYPE_NAME].ymlfor file name (e.g. concourse-git-resource.yml)
... /README.md /your-new-yaml.yml ...
Populate your file with the resource type name, repo url and the description of the resource type. For example:
name: git repo: https://github.com/concourse/git-resource ## Add the full url of the image if it is not listed under dockerhub container_image: concourse/git-resource description: | tracks commits in a branch of a Git repository
When you're ready, push your code and submit a pull request!
Your pull request will be reviewed by one or more maintainers, and you might receive feedback or requests for additional changes to your code.
In order to approve a resource type, we check the following:
- You are the primary maintainer of the resource type or affiliated to the maintaining org.
- The repository url of the resource type is valid.
- The container image of the resource type exits.
When a maintainer accepts your changes, they will merge your pull request.
Where to get help
There are two main channels that the Concourse community uses for getting help and discussing potential changes.