/taskcluster-github

Services for integrating TaskCluster with GitHub.
  1. JavaScript 94.2%
  2. Shell 5.8%
JavaScript Shell
Find file
Latest commit e0c5dce Aug 8, 2016 1 @imbstack imbstack committed on GitHub Merge pull request #66 from taskcluster/add_base_sha 
Publish base sha in push pulse messages
Failed to load latest commit information.
docker Merge pull request #24 from rail/entrypoint Sep 14, 2015
docs Add a doc on how to use this Jul 11, 2016
schemas Update to newer base Aug 2, 2016
src Merge pull request #66 from taskcluster/add_base_sha Aug 8, 2016
test Cleanup and simplify code a bit May 19, 2016
.eslintrc Add eslint to project Apr 22, 2016
.gitignore Almost working. Procfile doesn't work yet but tests pass Apr 21, 2016
.taskcluster.yml Use sha instead of ref May 24, 2016
.travis.yml Add travis to go alongside tc-github tests Apr 22, 2016
LICENSE Initial commit Jul 10, 2015
Procfile Almost working. Procfile doesn't work yet but tests pass Apr 21, 2016
README.md Add deployment instructions May 10, 2016
config.yml Use new tc-base May 20, 2016
npm-shrinkwrap.json Use newer lib-docs to fix double-encoded schemas in docs Aug 3, 2016
package.json Use newer lib-docs to fix double-encoded schemas in docs Aug 3, 2016
user-config-example.yml Move to node 5 and shrinkwrap Apr 22, 2016

README.md

TaskCluster GitHub Service

Build Status

This service monitors all of the repositories associated with an organization for changes and schedules TaskCluster tasks for any repository which contains a .taskcluster.yml configuration file. The goal of this project is to provide project owners a method for scheduling jobs in TaskCluster which is quick and straight forward.

This project is tested in both Travis and Taskcluster.

Docs

See: https://docs.taskcluster.net/manual/vcs/github

Components

API Server

Listens for WebHooks and, if they are valid, forwards them to a pulse exchange.

Worker

Listens for WebHook triggered pulse messages and attempts to schedule TaskCluster tasks for any events related to a repository which contains a .taskcluster.yml file.

Contributing

Run Tests

From the project's base run npm test note: Initially, this will only run unit tests. To run integration tests add pulse credentials to user-config.yml. An example is available at user-config-example.yml.

Deploying

This service will auto-deploy in Heroku once merged into master and CI runs are successful. If you need to force a deploy because we've broken CI in some way and this urgently needs to be deployed, you can do it from the Heroku console. Once the new version has been deployed, you can verify it is working by making a throw-away pull request into this project. If it is tested and has the status updated by this service, it is working.