GitHub Tool Task provide full implementation to Create and Modify GitHub Release to Azure DevOps Build and Release Management. Learn More
- Create or Modify GitHub Release: Create or modify GitHub Release, allowing to upload assets, check manifest content and more.
Options include:
- GitHub Connection: Connect to a service endpoint for your GitHub Connection. More Info.
- 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. More Info.
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.
- Edit Release Check to allow to edit release name, notes, type (
draft, prerelease, release
) and target commitsh. More Info. - Delete Empty Tag Check to delete tag if it's editing release type from
prerelease
orrelease
todraft
. - 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'.
Modify will only be valid if the release has the same tag as the other one, and you have to allow Reuse Release or/and Reuse only Draft Release
- The release tag option should have the same tag of the release you want to change.
- The assets should have the same name to replace.
- Leave unchecked
Skip Duplicated Assets
insideAdvanced
options.
This option allow to edit release properties based on tag name
, changing the release name, notes, type (draft, prerelease, release
) and target commitsh.
- The release tag option should have the same tag of the release you want to change.
- Write different name, notes, target commitsh or change the type of the release.
- Check
Edit Release
insideAdvanced
options.
Tip:
Delete Empty Tag
option allow to prevent an empty tag (without release) by deleting it when you edit release type fromprerelease
orrelease
todraft
The manifest is a json file (commonly called package.json
) that include some information about your application, the GitHub Tool can extract these information when you indicate in Manifest JSON
field where json file is located. Your json should be like this example below.
{
"version": "2.0.0",
"repository": {
"type": "git",
"url": "https://github.com/owner/repo"
}
}
This option is one of the mandatory fields to allow GitHub Tool interact with GitHub API. For this, you have two options to create this connection:
This service provides you direct and fast connection with GitHub authentication. If you need to modify some access and grant new authorizations you will have to access your GitHub acoount, go to Settings
> Applications
> Authorized OAuth Apps
, found Azure Pipelines (OAuth)
and modify permissions and organization access.
This option needs a personal access token from GitHub, you can create it by going to your GitHub account, Settings
> Developer settings
> Personal access tokens
and click on Generate New Token
.
Scope | Description |
---|---|
repo | Allow access to private repositories |
public_repo | Allow access to public repositories |
Service endpoints can be created from the Azure Devops project dashboard, login and go to Project Settings
> Service connections
> New service connection
. Select Github
from the list. Chose authentication method (e.g. OAuth
or Personal Access Token
). Then Authorsize
, then Complete other details and finall Save
.
I was disappointed with all the current GitHub extensions tools solutions. Most of them don't have most of the options GitHub can provide and don't are maintained anymore. So, I found publish-release repository with almost every option that I need, helped them to finish some issues and use that to create this extension for Azure DevOps Releases and Builds.
You can find the latest stable version of the Azure DevOps Extension tasks on the Visual Studio Marketplace.
Please refer to our debug wiki page
Contributions, issues and feature requests are very welcome. Please make sure to read the Contributing Guide before making a pull request.
Please refer to our wiki page
Thanks goes to these wonderful people (emoji key):
Marcelo Formentão 💻 🎨 📖 🤔 🚇 |
Heath Stewart 💻 |
---|
This project follows the all-contributors specification. Contributions of any kind welcome!