Skip to main content

Introduction

Added in eventcatalog@2.18.0
License: Dual-license

EventCatalog Federation is a feature that allows you to merge multiple EventCatalog instances into a single catalog.

This is useful if you:

  • Have multiple teams that want to own there own EventCatalog / Documentation
  • Want to keep your documentation close to your code
  • Want to give ownership of documentation to different teams and still have a single source of truth

EventCatalog Federation

How it works​

EventCatalog Federation is powered by the EventCatalog Federation Generator.

  1. Your teams create their own EventCatalog instances
  2. Your teams document their services, messages and domains in their own EventCatalog
  3. Your teams commit their EventCatalog to a git repository, either in the same repo as your code or in a separate repo
  4. You setup a main catalog that will be the source of truth for your documentation
  5. You use the federation generator to merge your teams catalogs into the main catalog
  6. You setup CI/CD to keep your main catalog up to date with your teams catalogs (or just rebuild every X time)

To use the federation generator you will need a License Key from EventCatalog Cloud. You can get a free 14 day trial license key for the plugin.

You can read more documentation:

Commercial Use​

This plugin is governed by a dual-license. To ensure the sustainability of the project, you can freely make use of this software if usage is also Open Source. Otherwise for proprietary use, internal use, and private modifications you must obtain a commercial license.

You can get a 14 day trial license key to try the plugin out by going to EventCatalog Cloud.

After the trial you can purchase a license to continue using this plugin, we have different plans to suit your organization.

See pricing for more information.

Have any questions? You can email us at hello@eventcatalog.dev.

Login to EventCatalog Dashboard