This repo represents a huge catalog of components, apis, teams, domains and systems to simulate a real world backstage instance.
I have defined 2 approaches to use this catalog:
- Centralized catalog
- Decentralized catalog
For more information about the approaches, please check the excalidraw
diagram in the docs
folder.
In this approach, the catalog is defined in a single file all.yaml
and all the entities are referenced from this file using the Location kind. Using this approach the catalog will be generated from one single file.
You will have something like this:
all-apis.yaml
all-components.yaml
all-domains.yaml
all-entities.yaml
all-groups.yaml
all-systems.yaml
|____apis
| |____api-0.yaml
| |____api-n.yaml
|____components
| |____component-0.yaml
| |____component-n.yaml
|____domain
| |____domain-0.yaml
| |____domain-n.yaml
|____groups
| |____group-0.yaml
| |____group-n.yaml
|____systems
| |____system-0.yaml
| |____system-n.yaml
In this approach, the catalog is generated using different folders to represent repos
and each folder contains a catalog-info.yaml
file that defines the entities for that repo. Using this approach the catalog can be generated using a provider to filter the information or using the discovery option.
You will have something like the next example, where each folder represents a repo:
.
|____petstore
| |____catalog-info.yaml
|____artist-lookup
| |____catalog-info.yaml
|____n
| |____catalog-info.yaml
If you want to see a real example on Github with this approach, please check the next organization, where I have created a catalog with the next entities:
"generator": {
"groups": 10,
"components": 1000,
"apis": 1000,
"domains": 5,
"systems": 10,
},
https://github.com/ricteam
Running the script will generate a lot of traffict to Github GraphQL API, so you may get the error GraphQL error: You have created too many repositories, too quickly. Please try again later.
, for more information about this error, please check the next link - rate-limit.
This Backstage Huge Catalog
will help to test the performance of the catalog and the different approaches to generate the catalog. Also, it will help to test the different plugins that are using the catalog.
I have already generated a catalog according to the 2 approaches, these catalog contains about 10,000 entities each one. If you want to play with your own settings, you can use the backstage-toolkit
to generate the catalog.