HomeGuidesChangelog
GuidesLog In

Contribute to the Komand Marketplace

In order to contribute to the marketplace, you need to be a customer of Komand and a registered marketplace user. Not a customer? Visit the Marketplace website to get started. Not a registered marketplace user? Register here.

How to Contribute Workflows

To contribute a workflow to the Komand Marketplace, you must first export it from your own Komand UI, and then upload it to the marketplace.

To export your workflow:

  1. From the “Workflows” tab, choose the workflow you want to share on the marketplace, and expand the options menu on the right side of the card

  2. Click “Export”

510
  1. In the modal that appears, you will have the option to choose to export your connection data in addition to your workflow. Click “No” otherwise you might accidentally share credentials with third parties.

🚧

Exporting Connections

If you do choose to export connections, credentials will NOT be encrypted.

  1. Download the file. It will save to your browser’s default download location.

To upload your workflow to the marketplace:

  1. Go to https://market.komand.com/ and log in. If you’re not already a registered user, you can sign up at https://market.komand.com/register

  2. Click “Upload.” Upload your workflow in the modal, either by dragging the workflow .kom file into the drag & drop area, or by click the area and searching for the file on your computer

740
  1. You will see all of your workflow’s details, including its name, tags, and descriptions. Provide any additional details here so that other users know what your workflow does and how they can integrate it into their own environments.
732
  1. There is also a place to upload screenshots of your workflow. We recommend taking a few shots -- one of the entire workflow, and a few zoomed in, depending on how large the workflow is -- to show users what you’ve built!

  2. Click “Continue” to upload your workflow.

  3. Congratulations! You’ve become a marketplace contributor!

How to Contribute Plugins

Marketplace Requirements

To build and contribute plugins, you must have Docker installed and running, and your environment variables set correctly.

1. Installing the Marketplace Plugin Tooling

To get started, you need to install the komunity-plugin tooling.

MacOS

  1. Download the komunity-plugin-2.0.0-darwin.tar.gz
  2. Installation:
    • Locally to your home directory: tar xvzf komunity-plugin-2.0.0-darwin.tar.gz -C ~/
    • Follow README.md for rest of directions.

Linux

  1. Download the komand-plugin-2.0.0-linux.tar.gz
  2. Extract the komunity-plugin tool:
    • Locally to your home directory: tar xvzf komand-plugin-2.0.0-linux.tar.gz -C ~/
    • Follow README.md for rest of directions.

2. Creating Plugins

You can develop plugins with out the Komand product but you must have Komand installed to orchestrate your plugins. You can learn about how to build plugins by viewing our Plugin SDK documentation.

Contact [email protected] for help.

3. Uploading Plugins

To upload a plugin package to the Marketplace, use the komand-plugin tool with the upload command:

/opt/komunity/bin/komunity-plugin upload test-myplugin.tar.gz

Enter username: test
Enter password:
2017/03/02 12:20:51 Building plugin komunity-plugins.komand.com:443/test/myplugin:0.1.0...