How to install and configure Matrix42 Extensions Publishing Tools for Azure DevOps
This is a step-by-step guide to installing and configuring Matrix42 Extensions Publishing Tools for Azure DevOps.
Prerequisites
- A Matrix42 Cloud Account. (https://accounts.matrix42.com)
- A Personal Access Token generated for the Matrix42 Cloud Account (https://accounts.matrix42.com/my/account)
- An Azure DevOps Organization and privileges to install extensions into it.
Installing
You can simply install the Matrix42 Extensions Publishing Tools from the Visual Studio Marketplace:
Matrix42 Extensions Publishing Tools - Visual Studio Marketplace
Configuration
- Visit your Azure DevOps Organization site.
- Choose the project for which you want to configure the Matrix42 Extensions Publishing Tools and go to the project settings.
- Under "Pipelines" navigate to "Service Connections" and click on "New service connection".
- Search for "Matrix42 Extension Gallery" and click on "Next".
- Copy the Personal Access Token of your Matrix42 Cloud Account into the "API Token" field.
The account which was used to generate the Personal Access Token will be the referenced contributor in all Enterprise Automation Platform Extensions uploaded with the Matrix42 Extensions Publishing Tools.
This requires the account to be added as a contributor with at least the "Contributor" permission level. (Learn more about permissions)
Also keep in mind that the Personal Access Token will expire in the configured time (90, 180, 360 days) and has to be renewed.
- Choose a name and an optional description for your service connection.
- Click on "Save" and you will see the new service connection appear in the list of service connections.
- Optional: You can click on the service connection and use the "More actions"-menu (three dots) to manage the permissions on the service connection (Security).
Read more about Azure DevOps service connections in general:
Service connections in Azure Pipelines & TFS - Azure Pipelines | Microsoft Docs