Skip to content

An app that handles responding to Github's Status API with the current state of the reflected Pivotal Story within a Pull Request

Notifications You must be signed in to change notification settings

xogroup/pivotal-status-check

Repository files navigation

Pivotal Status Check

CircleCI Known Vulnerabilities

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.

Workflow That This Supports

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

Usage:

  1. Pull down docker image: Dockerhub
  2. Set up your deployment environment (eb create, etc)
  3. Run the release command related to that application deployment environment
  4. 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]
  1. 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
  1. Set up your webhook on your Pivotal Project
  • YOUR_APPLICATION_URL/accepted
  1. Github branch format with Pivotal Story ID at the end (snakecase) (eg: some_feature_PIVOTAL_STORY_ID )

  2. Profit

Note

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.

Deployment

Out of Box Supported Deployment Environments:

If you want to deploy your version of the app, simply call the above make command.

Development

Make changes and run make test

Gotchas

  • If you receive a 404 ensure that the token you're using has access to the repository, the status check is running on

About

An app that handles responding to Github's Status API with the current state of the reflected Pivotal Story within a Pull Request

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published