GitHub Pages Publish

A build and release task to update GitHub Pages as part of a VSTS build or release. Ideal for publishing package documentation in conjunction with DocFX and something I use as part of my automated package and release pipeline for AzureFromTheTrenches.Commanding.

Prerequisites

To use the plugin you need to:

1. Have configured GitHub Pages to be hosted within the gh-pages(or other specified) branch of your repository. Setup instructions can be found here.
2. Obtain a Personal Access Token that the build task can use to commit to your gh-pages(or other specified) branch. Instructions for doing that can be found here.

Installation

You can find the plugin in the VSTS marketplace - just search for Publish to GitHub Pages, you will probably see it in the list after typing Publish then just add the task to your build or release pipeline.

In general I recommend having a build that compiles your documentation (and if you are using DocFX their are extensions in the marketplace for doing that easily) and a release that takes the artifacts from that and publishes them to GitHub Pages.

Parameters

You'll then need to set the required parameters for the publishing process:

Bits and Pieces

It's really just a wrapper over some Git commands which you can see in the PowerShell script if you want to take a look or use this as a baseline for something slightly different.

Any issues log them in the Issues area for this GitHub repository or message me on Twitter.