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 clipboard_e07df2862d31fb728faef1ba8e0159b85.png 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 clipboard_ed1f5da537a86c296b3b69a61d0cf4a4c.png Release or not (which will result in a clipboard_e73da93a7cb4475fd1c575b243b82a288.png Release). Only Extension versions marked as clipboard_e118af05b0e3d82536773a79400bba709.png 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 clipboard_e2082f72014f1967ee53573769075effb.png Release are of course directly supported by the Matrix42 AG. Extensions which are published by the Matrix42 AG but are marked as a clipboard_ed1f5da537a86c296b3b69a61d0cf4a4c.png Release are not supported by the 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?