mattermost-marketplace

module
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 16, 2023 License: Apache-2.0

README

Plugin Marketplace

The Plugin Marketplace is a collection of plugins for use with Mattermost. This repository houses the stateless HTTP service that is run at https://api.integrations.mattermost.com. It is meant to be queried by the Mattermost server to enable plugin discovery by System Admins.

Although Mattermost hosts the Marketplace as an AWS Lambda function backed by S3 and CloudFront, the core feature set is designed for use in any hosting environment, enabling private, self-hosted collections of plugins.

Read more about the Plugin Marketplace Architecture.

Other Resources

This repository houses the open-source components of the Plugin Marketplace. Other resources are linked below:

Get Involved

Developing

Environment Setup
  1. Install Go
Running

Simply run the following:

$ make run-server
Testing

Running all tests:

$ make test
Proxying upstream

The marketplace can be configured to proxy to an upstream marketplace, overlaying any locally defined plugins on top of the remote service. Invoke the server with the appropriate flag:

go run ./cmd/marketplace server --upstream https://api.integrations.mattermost.com

To compile this flag into the binary such as when building the lambda function, define the appropriate environment variable:

export BUILD_UPSTREAM_URL=https://api.integrations.mattermost.com
make build-lambda
Add a new release of a plugin to the Marketplace

To add a new release for a plugins, run

go run ./cmd/generator/ add $REPOSITORY $VERSION [--official|--community]

e.g.

go run ./cmd/generator/ add mattermost-plugin-jitsi v2.0.0 --official

generator add supports additional flags. See generator add --help for more details.

Make sure to double check the diff of plugins.json to ensure the release get added correctly.

Deploying as a Lambda Function

In addition to running as a standalone server, the Marketplace is also designed to run as a Lambda function, compiling the plugins.json database into the binary for immediate access without further configuration.

Automatic Deployment

Changes merged to master are automatically deployed to https://api.staging.integrations.mattermost.com.

Changes merged to production are automatically deployed to https://api.integrations.mattermost.com.

When adding or updating the plugins database (or corresponding tooling), submit the changes directly to production, and then merge production immediately back to master to reduce unnecessary merge conflicts. All other changes should be committed directly to master. Changes pending release from master should be merged to production after qualification and in coordination with any supporting Mattermost server release.

Manual Deployment

Simply run the following:

$ SLS_STAGE=staging make deploy-lambda

To iterate quickly after the Cloud Formation stack is up, simply run:

$ SLS_STAGE=staging make deploy-lambda-fast

Directories

Path Synopsis
cmd
marketplace
Package main is the entry point to the Plugin Marketplace server.
Package main is the entry point to the Plugin Marketplace server.
internal
api

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL