Skip to content
Permalink
Browse files

Rename VSTS => Azure DevOps

* Renamed VSTS Marketplace to Visual Studio Marketplace
* Renamed VSTS to Azure DevOps
* Updated security scopes
* Renamed Account to Organisation
* Fixed build badges
  • Loading branch information...
jessehouwing committed Oct 12, 2018
1 parent 5f4875f commit 6a5807e04527db4646658a75d9d385fa202f74c1
@@ -44,16 +44,16 @@
"label": "Connect to",
"required": true,
"defaultValue": "VsTeam",
"helpMarkDown": "Publish to Visual Studio Team Services or a local TFS server.",
"helpMarkDown": "Connect to Visual Studio Marketplace or a local TFS server.",
"options": {
"VsTeam": "Visual Studio Team Services",
"VsTeam": "Visual Studio Marketplace",
"TFS": "Team Foundation Server"
}
},
{
"name": "connectedServiceName",
"type": "connectedService:VstsMarketplacePublishing",
"label": "VSTS Marketplace connection",
"label": "Visual Studio Marketplace",
"required": true,
"helpMarkDown": "Service endpoint connection to install the extension.",
"visibleRule": "connectTo=VsTeam"
@@ -2,7 +2,7 @@
"id": "47a0f73c-f8e6-4fc5-a759-4d560031ef75",
"name": "InstallExtension",
"friendlyName": "Install Extension",
"description": "Install a published extension to a Team Services account",
"description": "Install a published extension to an Azure DevOps organisation or Team Foundation Server",
"author": "Microsoft Corporation",
"helpMarkDown": "",
"category": "Deploy",
@@ -44,16 +44,16 @@
"label": "Connect to",
"required": true,
"defaultValue": "VsTeam",
"helpMarkDown": "Publish to Visual Studio Team Services.",
"helpMarkDown": "Connect to Visual Studio Marketplace.",
"options": {
"VsTeam": "Visual Studio Team Services",
"TFS": "Visual Studio Team Foundation Server"
"VsTeam": "Visual Studio Marketplace",
"TFS": "Team Foundation Server"
}
},
{
"name": "connectedServiceName",
"type": "connectedService:VstsMarketplacePublishing",
"label": "VSTS Marketplace connection",
"label": "Visual Studio Marketplace",
"required": true,
"helpMarkDown": "Service endpoint connection to install the extension.",
"visibleRule": "connectTo=VsTeam"
@@ -124,7 +124,7 @@
"type": "string",
"label": "Install in",
"defaultValue": "",
"helpMarkDown": "Comma separated list of accounts where to install the extension (e.g. account_x,account_y,account_z) Or fully qualified TFS Collection URL (e.g. `https://yourserver/tfs/DefaultCollection`).",
"helpMarkDown": "Comma separated list of organisations where to install the extension (e.g. org_x,org_y,org_z) Or fully qualified TFS Collection URL (e.g. `https://yourserver/tfs/DefaultCollection`).",
"required": true,
"groupName": "installation"
},
@@ -35,15 +35,15 @@
"label": "Connect to",
"required": true,
"defaultValue": "VsTeam",
"helpMarkDown": "Publish to Visual Studio Team Services.",
"helpMarkDown": "Connect to Visual Studio Marketplace.",
"options": {
"VsTeam": "Visual Studio Team Services"
"VsTeam": "Visual Studio Marketplace"
}
},
{
"name": "connectedServiceName",
"type": "connectedService:VstsMarketplacePublishing",
"label": "VSTS Marketplace connection",
"label": "Visual Studio Marketplace",
"required": true,
"helpMarkDown": "Service endpoint connection to install the extension.",
"visibleRule": "connectTo=VsTeam"
@@ -2,7 +2,7 @@
"id": "b86cdd2a-0579-4d40-b28f-18197ffaf520",
"name": "Check Marketplace validation status.",
"friendlyName": "Is valid Extension",
"description": "Check Marketplace validation status.",
"description": "Check Visual Studio Marketplace validation status.",
"author": "Microsoft Corporation",
"helpMarkDown": "",
"category": "Deploy",
@@ -43,15 +43,15 @@
"label": "Connect to",
"required": true,
"defaultValue": "VsTeam",
"helpMarkDown": "Publish to Visual Studio Team Services.",
"helpMarkDown": "Connect to Visual Studio Marketplace.",
"options": {
"VsTeam": "Visual Studio Team Services"
"VsTeam": "Azure DevOps"
}
},
{
"name": "connectedServiceName",
"type": "connectedService:VstsMarketplacePublishing",
"label": "VSTS Marketplace connection",
"label": "Visual Studio Marketplace connection",
"required": true,
"helpMarkDown": "Service endpoint connection to install the extension.",
"visibleRule": "connectTo=VsTeam"
@@ -2,7 +2,7 @@
"id": "e59022e0-667a-11e5-ad4c-dd75b69a0d2c",
"name": "PackageVSTSExtension",
"friendlyName": "Package Extension",
"description": "Package a Team Services extension into a VSIX file",
"description": "Package an Azure DevOps extension into a VSIX file",
"author": "Microsoft Corporation",
"helpMarkDown": "",
"category": "Package",
@@ -148,7 +148,7 @@
"label": "Override task id",
"defaultValue": "false",
"required": false,
"helpMarkDown": "EXPERIMENTAL - Search for contributed tasks in extension manifests and updates the id specified in each Build and Release task found based on the Publisher, ExtensionId and TaskName.",
"helpMarkDown": "Search for contributed tasks in extension manifests and updates the id specified in each Build and Release task found based on the Publisher, ExtensionId and TaskName.",
"groupName": "overrides"
},
{
@@ -2,7 +2,7 @@
"id": "631511B4-50AB-47C8-B766-7AE2AA672733",
"name": "PublishExtension",
"friendlyName": "Publish Extension",
"description": "Publish a Team Services extension to the Visual Studio Marketplace",
"description": "Publish an Azure DevOps extension to the Visual Studio Marketplace",
"author": "Microsoft Corporation",
"helpMarkDown": "",
"category": "Deploy",
@@ -39,16 +39,16 @@
"label": "Connect to",
"required": true,
"defaultValue": "VsTeam",
"helpMarkDown": "Publish to Visual Studio Team Services or a local TFS server.",
"helpMarkDown": "Publish to Visual Studio Marketplace or a local TFS server.",
"options": {
"VsTeam": "Visual Studio Team Services",
"VsTeam": "Visual Studio Marketplace",
"TFS": "Team Foundation Server"
}
},
{
"name": "connectedServiceName",
"type": "connectedService:VstsMarketplacePublishing",
"label": "VSTS Marketplace connection",
"label": "Visual Studio Marketplace connection",
"required": true,
"helpMarkDown": "Service endpoint connection to install the extension.",
"visibleRule": "connectTo=VsTeam"
@@ -235,7 +235,7 @@
"type": "string",
"label": "Share with",
"defaultValue": "",
"helpMarkDown": "Comma separated list of accounts with which to share the extension if it's private (e.g. account_x,account_y,account_z). Share is ignored for public extensions and when publishing to TFS.",
"helpMarkDown": "Comma separated list of organisations with which to share the extension if it's private (e.g. org_x,org_y,org_z). Share is ignored for public extensions and when publishing to TFS.",
"required": false,
"groupName": "manifest",
"visibleRule": "extensionVisibility = private || extensionVisibility = privatepreview || extensionVisibility = default"
@@ -2,7 +2,7 @@
"id": "22683a08-0dbe-4fe8-8c53-4606fcb32752",
"name": "ShareExtension",
"friendlyName": "Share Extension",
"description": "Share a published extension with a Team Services account",
"description": "Share a published extension with a Azure Devops organisation",
"author": "Microsoft Corporation",
"helpMarkDown": "",
"category": "Deploy",
@@ -44,15 +44,15 @@
"label": "Connect to",
"required": true,
"defaultValue": "VsTeam",
"helpMarkDown": "Connect to Visual Studio Team Services. TFS is not supported for the Share command.",
"helpMarkDown": "Connect to Visual Studio Marketplace. TFS is not supported for the Share command.",
"options": {
"VsTeam": "Visual Studio Team Services"
"VsTeam": "Visual Studio Marketplace"
}
},
{
"name": "connectedServiceName",
"type": "connectedService:VstsMarketplacePublishing",
"label": "VSTS Marketplace connection",
"label": "Visual Studio Marketplace connection",
"required": true,
"helpMarkDown": "Service endpoint connection to install the extension.",
"visibleRule": "connectTo=VsTeam"
@@ -115,7 +115,7 @@
"type": "string",
"label": "Share with",
"defaultValue": "",
"helpMarkDown": "Comma separated list of accounts where to install the extension (e.g. account_x,account_y,account_z)",
"helpMarkDown": "Comma separated list of organisations where to install the extension (e.g. org_x,org_y,org_z)",
"required": true,
"groupName": "share"
},
@@ -1,32 +1,29 @@
![cistatus](https://mseng.visualstudio.com/_apis/public/build/definitions/b924d696-3eae-4116-8443-9a18392d8544/3646/badge)

# CI/CD Tools for VSTS extensions
[![Build status](https://almrangers.visualstudio.com/ALM/_apis/build/status/Extensions/Azure%20DevOps%20Extension%20Tasks)](https://almrangers.visualstudio.com/ALM/_build/latest?definitionId=127) [![Release status](https://almrangers.vsrm.visualstudio.com/_apis/public/Release/badge/7f3cfb9a-d1cb-4e66-9d36-1af87b906fe9/25/70)](https://almrangers.visualstudio.com/ALM/_releaseDefinition?definitionId=25)

This extension provides build and release tasks for packaging and publishing Visual Studio Team Services (VSTS) extensions to the [Visual Studio Marketplace](https://marketplace.visualstudio.com). There are also tasks to share and install your extension to your VSTS account.
This extension provides build and release tasks for packaging and publishing Azure Devops Extensions to the [Visual Studio Marketplace](https://marketplace.visualstudio.com). There are also tasks to share and install your extension to your Azure Devops organisation or Team Foundation Server.

## To use

[Learn more](https://marketplace.visualstudio.com/items?itemName=ms-devlabs.vsts-developer-tools-build-tasks) about this extension about and install the extension into your VSTS account via the Visual Studio Marketplace.

[Learn more](https://marketplace.visualstudio.com/items?itemName=ms-devlabs.vsts-developer-tools-build-tasks) about this extension about and install the extension into your Azure DevOps Organisation via the Visual Studio Marketplace.

## Available tasks

* **Package**: package a VSTS extension into an extension package (.VSIX) file
Azure DevOps

* **Package**: package an Azure DevOps extension into an extension package (.VSIX) file
* **Publish**: optionally package and publish an extension (either privately or publicly) to the Visual Studio Marketplace
* **Share**: share an extension with a VSTS account
* **Install**: install an extension to a VSTS account
* **Share**: share an extension with an Azure DevOps organisation
* **Install**: install an extension to an Azure DevOps organisation
* **Query version**: query an extension's version (to make it easy to increment on your next package or publish)
* **Wait for validation**: waits for the Marketplace validation to come through.

## Contribute
* **Wait for validation**: waits for the Visual Studio Marketplace validation to come through.

1. From the root of the repo run `npm run initdev`. This will pull down the necessary modules and TypeScript declare files.
2. Run `npm run build:tasks` to compile the build tasks
3. Run `npm run package:tasks` to create a .vsix extension package that includes the build tasks
Visual Studio (Coming soon...)

If you make a change to one or more of the actual tasks, you need to update the task(s) version in the appropriate task.json file. You can also run `setTaskVersion.js` and pass version to apply to all tasks, for example:
* **Publish**: Publish a Visual Studio extension to the Visual Studio Marketplace

```
node scripts/setTaskVersion.js 1.1.71
```
## Contribute

1. From the root of the repo run `npm run initdev`. This will pull down the necessary modules and TypeScript declare files.
2. Run `npm run build` to compile the build tasks.
3. Run `npm run package` to create a .vsix extension package that includes the build tasks.
@@ -1,42 +1,47 @@
This extension provides build and release tasks for packaging and publishing Azure Devops Extensions to the [Visual Studio Marketplace](https://marketplace.visualstudio.com). There are also tasks to share and install your extension to your Azure Devops organisation or Team Foundation Server.

This extension provides build and release tasks for packaging and publishing Visual Studio Team Services (VSTS) extensions to the [Visual Studio Marketplace](https://marketplace.visualstudio.com). There are also tasks to share and install your extension to your VSTS account.
## How to use

After installing the extension, you can add one (or more) of the tasks to a new or existing [build definition](https://www.visualstudio.com/en-us/docs/build/define/create) or [release definition](https://www.visualstudio.com/en-us/docs/release/author-release-definition/more-release-definition)

## Release Notes
![add-task](add-task.png)

* EXPERIMENTAL - Added support for generating build task Id's based on publisher, extension id and taskname.
If you plan to publish to the Marketplace, you will need to [create a personal access token](https://www.visualstudio.com/docs/setup-admin/team-services/use-personal-access-tokens-to-authenticate).

## Tasks included
## Available tasks

Azure DevOps

* **Package**: package a VSTS extension into an extension package (.VSIX) file
* **Publish**: publish an extension (either privately or publicly) to the Visual Studio Marketplace
* **Share**: share a private extension with a VSTS account so it can be installed
* **Install**: install an extension to a VSTS account
* **Publish**: optionally package and publish an extension (either privately or publicly) to the Visual Studio Marketplace
* **Share**: share an extension with an Azure DevOps organisation
* **Install**: install an extension to an Azure DevOps organisation or Team Foundation Server
* **Query version**: query an extension's version (to make it easy to increment on your next package or publish)
* **Wait for validation**: waits for the Marketplace validation to come through.

## How to use
Visual Studio (Coming soon...)

After installing the extension, you can add one (or more) of the tasks to a new or existing [build definition](https://www.visualstudio.com/en-us/docs/build/define/create) or [release definition](https://www.visualstudio.com/en-us/docs/release/author-release-definition/more-release-definition)
* **Publish**: Publish a Visual Studio extension to the Visual Studio Marketplace

![add-task](add-task.png)

If you plan to publish to the Marketplace, you will need to [create a personal access token](https://www.visualstudio.com/docs/setup-admin/team-services/use-personal-access-tokens-to-authenticate).

### Required scopes

When creating a personal access token for use by your build/release, make sure the token has at least the following scopes for the task(s) you are using:

* **Publish**: All Accounts, `Marketplace (publish)`
* **Share**: All Accounts, `Marketplace (publish)`
* **Install**: All Accounts or a Specific Account, `Extensions (read and manage)`, `Marketplace`
* **Query Version**: All Accounts, `Marketplace`


When creating a personal access token for use by your pipeline, make sure the token has at least the following scopes for the task(s) you are using:

* **Publish**: `All accessible organisations`, `Marketplace (publish)`
* **Share**: `All accessible organisations`, `Marketplace (publish)`
* **Install**: `All accessible organisations` or a specific Organisation, `Extensions (read and manage)`, `Marketplace (acquire)`
* **Query Version**: `All accessible organisations`, `Marketplace (read)`
* **Is Valid**: `All accessible organisations`, `Marketplace (read)`

![Permissions](permissions.png)

## Get the source

The [source](https://github.com/Microsoft/vsts-extension-build-release-tasks) for this extension is on GitHub. Take, fork, and extend.

## Contribute

This extension was created by Microsoft with help from the community. We'd like to thank Wouter de Kort and Jesse Houwing for their contributions.
This extension was created by Microsoft with help from the community. We'd like to thank [Wouter de Kort](https://wouterdekort.com/) and [Jesse Houwing](https://jessehouwing.net/) for their contributions.

## Feedback and issues

Some generated files are not rendered by default. Learn more.

Oops, something went wrong.
@@ -1,6 +1,6 @@
{
"name": "vsts-developer-tools",
"description": "Visual Studio Team Services Build and Release Tasks for Extensions",
"description": "Azure DevOps Extension Tasks",
"repository": {
"type": "git",
"url": "https://github.com/Microsoft/vsts-extension-build-release-tasks.git"
BIN +63.1 KB permissions.png
Binary file not shown.
Oops, something went wrong.

0 comments on commit 6a5807e

Please sign in to comment.
You can’t perform that action at this time.