This app is intended to let you have your acceptance state in Pivotal Tracker be reflected as a status check within your pull requests.
It hooks into a Github webhook which communicates with it when a pull request has been created or updated. This app then checks the status of the pivotal story related to it. If the story has been accepted, it'll return as a success to Github.
Our pull requests get merged into Master (and deployed to Production) once they fulfilled the criteria below.. You are not allowed to merge to master unless these criteria are met:
- 2 peer reviews
- CI Tests pass
- Pivotal Story accepted
- Pull down docker image: Dockerhub
- Set up your deployment environment (
eb create, etc) - Run the release command related to that application deployment environment
- Setup your environment with these environment variables (see
.env.default)
-
Github Token [GITHUB_ACCESS_TOKEN]
-
Github Org/Repository [GITHUB_REPO]
-
Pivotal API Token [PIVOTAL_TRACKER_TOKEN]
-
Pivotal Project ID [PIVOTAL_PROJECT_ID]
-
For Github Enterprise Support:
- Github Enterprise API URL (eg: yourdomain.com/api/v3) [GITHUB_ENTERPRISE_API]
- Set up your webhook on your Github repository
- Payload URL:
- YOUR_APPLICATION_URL/accepted_status_check
- Let me select individual events.
- Choose the following events:
- Pull request
- Set up your webhook on your Pivotal Project
- YOUR_APPLICATION_URL/accepted
-
Github branch format with Pivotal Story ID at the end (snakecase) (eg:
some_feature_PIVOTAL_STORY_ID) -
Profit
Pivotal Projects are associated with Github Repositories so you will need to deploy a NEW instance for EACH Pivotal Project ID for EACH Github Repository.
Out of Box Supported Deployment Environments:
- AWS ElasticBeanstalk
make eb_release
- Heroku
make heroku_release
If you want to deploy your version of the app, simply call the above make command.
Make changes and run make test
- If you receive a 404 ensure that the token you're using has access to the repository, the status check is running on