Skip to main content
Matrix42 Self-Service Help Center

Publish your Extension

This is a step-by-step guide on how to use Matrix42 DevOps Services to publish and install a Digital Workspace Platform Extension.

Prerequisites

Publish your Extension

  1. Visit the Matrix42 DevOps Portal (https://extensions.matrix42.com/portal) and login with your Matrix42 Cloud Account.
  2. Choose the Extension you want to publish and click on the "View" link next to the successful and failed Release counts.

You can see if you have permissions to publish Releases by the "Owner", "Manager" or "Publisher" badge which will be shown next to the actions you can perform on the Extension.

clipboard_e5c1aee310b5a1d72393a91789b25045a.png

  1. In the Release overview, you can see all Releases of the currently selected Extension. Choose a Release that has the "Available" status badge.

Releases are named by a number, which increments with each consecutive release of the Extension.

clipboard_eafb916a63303e737a99d20bf9e3745ba.png

  1. Click on the clipboard_e6f63b0522cd2ac59531ef97a841ec6f7.png (Publish) action on the Release. (Might be hidden in the clipboard_ecc57ff82f29647abda70c55127de16cf.png action menu.)
  2. Now define the name and description as well as the visibility of the Extension you want to publish to the Matrix42 Extension Gallery. (https://extensions.matrix42.com)

We recommend starting to publish an Extension with the lowest visibility first and gradually upgrading it for a controlled rollout.

clipboard_e77d61048598bcc39ac2ebcfdc22e064f.png

Be aware that you cannot undo the publishing of a Release or decrease the visibility after publishing.

Meaning you can set the visibility from "For Contributors on the Extension" to "For Members of my Vendor" but not otherwise.

This also counts for upgrading from Community Release to Non-Community Release. (A downgrade is not possible)

Visibility of a published Extension in the Matrix42 Extension Gallery

When publishing a Digital Workspace Platform Extension to the Matrix42 Extension Gallery (https://extensions.matrix42.com) you will have to define who will be able to see the published version of the Extension.

Therefore, you have three options:

  • For Contributors of the Extension: Only people who are added as a contributor to the Extension itself (at least "Participant" permission level) are able to see the published version in the Matrix42 Extension Gallery. This extension is additionally marked with a "Private" badge. (Learn more about permissions)
  • For Members of my Vendor: All contributors of the Extension itself and those who are a member of your vendor (a.k.a company or enterprise) are able to see the published version in the Matrix42 Extension Gallery.
  • For Everyone (Public): Everyone who has a Matrix42 Cloud Account (which is a requirement for accessing the Matrix42 Extension Gallery) can see the published version.

Support for published Extensions in the Matrix42 Extension Gallery

If and how your published Extension is supported by the Matrix42 AG depends on your vendors partner status:

  • No Matrix42 Certified Partner Status: All of your published Extensions will be marked as a 'Community' Release and are not supported by the Matrix42 AG. This fact will be made transparent to the end-user once installing this Extension version.
  • Matrix42 Certified Partner Status: You can decide to either publish your Extensions as a 'Community' Release or not (which will result in a 'Certified Partner' Release). Only Extension versions marked as 'Certified Partner' Release are supported by the Matrix42 AG. (See the support agreement of your Matrix42 Partner contract)

Once an Extension version is published as a Certified Partner Release you cannot downgrade to a Community Release.

  • Packages published by Matrix42 AG itself: Extensions which are marked as a 'Matrix42' Release are of course directly supported by the Matrix42 AG. Extensions which are published by the Matrix42 AG but are marked as a 'Community' Release are not supported by the Matrix42 AG.

All mentioned tags are visualized as shown in below table

Tag Meaning
clipboard_e07df2862d31fb728faef1ba8e0159b85.png Community Extension which is not supported by Matrix42
clipboard_e73da93a7cb4475fd1c575b243b82a288.png Extension of Certified Parnter
clipboard_e2082f72014f1967ee53573769075effb.png Extension provided by Matrix42 AG

Upgrading the published Extension visibility

If you want to upgrade the visibility of your published Extension version or upgrade from a Community Release to a Non-Community Release, you can do that by clicking on the clipboard_ec166d244dbb2af76d1b20c7e97b6fe8d.png (Edit Visibility) action (May be hidden in the clipboard_ecc57ff82f29647abda70c55127de16cf.png action menu) on the published Release in the Matrix42 DevOps Portal. (https://extensions.matrix42.com/portal)

Be aware that you cannot undo the publishing of a Release or decrease the visibility after publishing.

Meaning you can set the visibility from "For Contributors on the Extension" to "For Members of my Vendor" but not otherwise.

This also counts for upgrading from Community Release to Non-Community Release. (A downgrade is not possible)

 

  • Was this article helpful?