Skip to content

Home

Jump to bottom
Marcelo Formentão edited this page Feb 1, 2018 · 14 revisions

GitHub Tools
GitHub Tool

Create and modify GitHub Releases. For VSTS Builds and Releases.

PRs Welcome Dependency Status

Create or Modify GitHub Release Task

GitHub Tool Task provide full implementation to Create and Modify GitHub Release to Visual Studio Team Services Build and Release Management. Create or modify GitHub Release, allowing to upload assets, check manifest content and more.

task-create-modify-release

create-modify-release

Options include:

  • GitHub Connection: Connect to a service endpoint for your GitHub Connection.
  • Repository: List all repositories based on Endpoint. If empty, it will be extracted from manifest file.
  • Tag: Create a tag to release. If empty, the version will be extracted from manifest file.
  • Release Title: Create a title to release. If empty, it will be the same as tag.
  • Release Notes: Create a note to release. If empty, it will be left undefined.
  • Draft: Check to release tagged as Draft.
  • Pre Release: Check to release tagged as Pre Release.
  • Ignore Assets: Check to skip upload assets to release.
  • Files to Upload as Assets: Include files to upload as artifacts to release. Minimatch pattern are supported.
  • Manifest JSON: Include the manifest file from which default values will be extracted if options are missing.

Advanced Options include:

  • Reuse Release: Check to allow to reuse a release with the same tag.
  • Reuse only Draft Release: Check to allow to reuse only draft release. Prevents from editing already published releases.
  • Skip Duplicated Assets: Check to prevent the plugin to replace assets with the same name.
  • Target Commitsh: Specifies the commitsh value that determines where the Git tag is created from. Can be any branch or commit SHA. Defaults to the default branch of the repository.
  • API URL: Allow to use a custom API URL to connect to GitHub Enterprise instead of github.com. Defaults to 'https://api.github.com'.

Install the extension to your account

You can find the latest stable version of the VSTS Extension tasks on the Visual Studio Marketplace.

Prerelease channel

Our tasks are build and published in continuous (thanks to VSTS, and @sandor of course). If you are interested or want to contribute, you can ask us the access of the private prerelease extension to install it to your account. By definition, this prerelease extension could introduce breaking changes, or could be very unstable, so it is not recommended to use it for your builds and releases, but only for testing purposes.

How-to's

Clone this wiki locally