/gocd-build-github-pull-requests

GoCD plugin to build PRs for a Github repo

Primary LanguageJava

Build Status

GoCD - Git feature branch support

This is a GoCD SCM plugin for Git feature branch support. Discussion Thread

Supported (as seperate plugins):

  • Git repository for branches
  • Github repository for Pull Requests
  • Stash repository for Pull Requests
  • Gerrit repository for Change Sets

Requirements

These plugins require GoCD version v15.x or above.

Get Started

Installation:

  • Download the latest plugin jar from the Releases section. Place it in <go-server-location>/plugins/external & restart Go Server. You can find the location of the Go Server installation here.

Usage:

  • Make sure plugins are loaded. Note: You can use GoCD build status notifier to update status of Pull Requests with build status. Plugins listing page

  • Assuming you already have a pipeline "ProjectA" for one of your repos Original pipeline Original pipeline material listing page

  • 'Extract Template' from the pipeline, if its not templatized already (this is optional step) Pipelines listing page Extract template pop-up

  • Create new pipeline say "ProjectA-FeatureBranch" off of the extracted template. You can clone "ProjectA" pipeline to achieve this. Pipelines listing page after extract template Clone pipeline pop-up

  • In the materials configuration for your newly created pipeline, you will see that there is a new material for each of the plugins you have installed (Git Feature Branch, Github, Stash or Gerrit). Select one of these new materials, fill in the details and the plugin will build the pull requests from the given material. Select GitHub drop-down Add GitHub drop-down New pipeline material listing page

  • You can delete the old material that is left over from cloning your pipeline. Delete old material pop-up

Behavior

  • First run of the new pipeline will be off of 'master' branch. This creates base PR-Revision map. It also serves as sanity check for newly created pipeline.

  • From then on, any new change (new PR create / new commits to existing PR) will trigger the new pipeline. Only the top commit in the PR will show up in build cause. New pipeine schedule

  • PR details (id, author etc.) will be available as environement variable for tasks to consume.

  • Build status notifier plugin will update Pull Request with build status On successful run of new pipeline

Github

Authentication:

  • You can create a file ~/.github with the following contents: (Note: ~/.github needs to be available on Go Server and on all Go Agent machines)
login=johndoe
password=thisaintapassword
  • You can also generate & use oauth token. To do so create a file ~/.github with the following contents: (Note: ~/.github needs to be available on Go Server and on all Go Agent machines)
login=johndoe
oauth=thisaintatoken

Github Enterprise:

  • If you intend to use this plugin with 'Github Enterprise' then add the following content in ~/.github (Note: ~/.github needs to be available on Go Server and on all Go Agent machines)
# for enterprise installations - Make sure to add /api/v3 to the hostname
# ignore this field or have the value to https://api.github.com
endpoint=http://code.yourcompany.com/api/v3

Stash

Authentication

If authentication is required, place a file named .netrc under the Go user's home directory. The file needs to be created in both the server and any number of agents that will build this material. You can find the home directory for Go server here and for Go Agent here.

The .netrc file takes the following format:

machine stash.vm.com 
login myusername
password mypassword

To Dos

  • Clean up the code esp. the JSON SerDe part
  • Add proper tests around the plugin

FAQs

Pull Request isn't being built

  • If more than 1 PR gets updated (create/update) Go bunches them together for the next pipeline run & uses the top change in the "build-cause" to build. You can force trigger pipeline with other revisions until this get fixed (thread).