@oandriie/backstage-plugin-catalog-backend-module-marketplace

This is an extension module to the plugin-catalog-backend plugin, providing new kinds of entity and processors that can be used to ingest marketplace plugin data.

Getting Started

This marketplace catalog module introduces two new kinds to the software catalog called Plugin and PluginList.

Installation

Install the package

# From your Backstage root directory
yarn --cwd packages/backend add @oandriie/backstage-plugin-catalog-backend-module-marketplace

Adding the plugin to your packages/backend

backend.add(
  import(
    '@oandriie/backstage-plugin-catalog-backend-module-marketplace'
  ),
);

Allow Plugin and PluginList to import via catalog

Add Plugin and PluginList kinds to the catalog rules in app-config.yaml to import this entities from external locations.

catalog:
  rules:
    - allow: [Component, System, API, Resource, Location, Plugin, PluginList]

Plugin configuration YAML Guide:

This YAML file is used to add marketplace plugin to the Software catalog in your backstage application.

apiVersion: extensions.backstage.io/v1alpha1
kind: Plugin
metadata:
  name: tekton
  title: Pipelines with Tekton
  description: Easily view Tekton PipelineRun status for your services in Backstage.
spec:
  type: frontend-plugin
  lifecycle: production
  owner: redhat
  categories:
    - CI/CD
  developer: Red Hat
  icon: https://janus-idp.io/images/plugins/tekton.svg
  description: |
    # Tekton plugin for Backstage
  installation:
    markdown: |
      # Setting up the Tekton plugin
  packages:
    - name: '@backstage/plugin-search-backend'
      version: '^1.0.0, ^1.1.1'

Structure Overview

The YAML file is structured into the following sections:

• spec.type: Defines type of the plugin. Possible values are frontend-plugin, backend-plugin, backend-plugin-module

• spec.categories: Defines the categories for the plugin.

• spec.description: Description to show in the sidebar.

• spec.installation.markdown: Installation guide for the plugin.

• spec.packages - Defines all the package names to identify the installation status of the plugin. This field accepts both array of plugin names and JSON format. ie: name, version, backstage and distribution information.

  NOTE: more examples of the plugins can be seen here.

PluginList configuration YAML Guide:

This entity allows you to create a curated list of plugins. This YAML file is used to add marketplace PluginList to the Software catalog in your backstage application.

apiVersion: extensions.backstage.io/v1alpha1
kind: PluginList
metadata:
  name: featured-plugins
  title: Featured Plugins
  description: A set of great plugins! :)
spec:
  type: curated-list
  lifecycle: production
  owner: redhat
  plugins:
    - quay
    - 3scale
    - tekton
    - topology

Structure Overview

The YAML file is structured into the following sections:

• spec.plugins: Defines a list of the plugins.

  NOTE: more examples of the plugins can be seen here.

Processors

This module provides different process used to ingest the plugin and pluginList entity into the software catalog.

• MarketplacePluginProcessors - Ingests Plugin entity into the catalog.
• MarketplaceCollectionProcessors - Ingests PluginList entity into the catalog.
• LocalPluginInstallStatusProcessor - Add and Update entity.spec.installStatus based on the packages installed in backstage workspaces.
• DynamicPluginInstallStatusProcessor - Add and Update entity.spec.installStatus based on the dynamic plugin installed in RHDH. This processor will work only when you have scalprum-backend installed in your backstage instance.