Docs menu
MENU

Marketplace

The platform provides a software solution Marketplace, which helps end-users with hosting by automatically installing pre-configured applications specially optimized for the platform. This feature is fully configurable:

Enable/Disable Marketplace

You can manage the availability of the feature via the appropriate APPSTORE_ENABLED parameter in the admin panel’s System Settings > User Interface section.

marketplace interface setting

Edit this setting to either enable (true) or disable (false) the Marketplace option for end-users.

Manage Package List

All the management operations with the Marketplace packages can be performed via the admin panel’s Marketplace section. Check a list below for a short overview of the available actions (the detailed description is provided in the linked documentation):

  • manage (add, edit, view, remove) packages
  • publish and unpublish solutions to make them available within the Marketplace
  • set rating to control the order of packages in JCA and the end-user dashboard
  • configure visibility levels (All Users, Admins with Full Access, Admins with View Rights, Platform Owner, Resellers)

manage packages in marketplace

When working with the Marketplace in the developers' dashboard as a platform admin, the additional System tab can be displayed. It provides access to the packages restricted for the regular users (based on the Visibility Levels configured via admin panel).

marketplace system solutions for cluster admins

These solutions can be run in the same way as any other; however, they are not displayed via the Search functionality.

Add Custom Package

To add a custom package to platform Marketplace and make it available for your users at the dashboard, follow the next simple steps:

Tip: You can check solutions provided at the Package Collection on GitHub. For example, you can fork repositories for yourself to test various customization before adding an adjusted package to the platform.

1. Navigate to the Marketplace section and click on the New installation / Add-on option inside the Add menu.

marketplace add custom package

2. In the opened code editor, you need to provide your application manifest (or refer to the Cloud Scripting documentation). Use the Template drop-down list at the top pane to get some sample code for different programming languages.

marketplace new package code editor

For example, select the Docker option and edit the strings inside with information, required for the desired Docker image addition. In this case, the following main parameters should be specified:

  • jpsType - defines if a new environment (application) should be created or existing one (add-on) configured, install or update value respectively
  • jpsVersion - shows the CS engine used in the package (i.e., if an application is compatible with the current platform version)
  • id - provides unique application identifier
  • name - defines an application name
  • categories - sets the categories of the Marketplace, this application should be shown in; if not specified, the Others category will be used

Click on the Save button below the editor when finished.

3. Before providing a new package to the end-users, you should test the deployment process. Log in and add the following parameter at the end of your dashboard URL (this will initiate the process of template installation):

1

?manifest={link}

Here, the {link} should be substituted with the URL to the manifest file of your package (the one you’ve composed in the previous step), uploaded anywhere on the Internet.

Note: If the manifest file link contains the question mark “?”, you need to use some URL shortener. Otherwise, your installation won’t work correctly.

If everything works fine, you can publish your new package in the platform’s Marketplace for end-users.

What’s next?