backstage-catalog-importer

command module

v0.24.2 Latest Latest Go to latest Published: Jan 12, 2026 License: Apache-2.0 Imports: 1 Imported by: 0

README ¶

Backstage catalog importer

A Go CLI to generate Backstage catalog YAML for Backstage instances like the Giant Swarm developer portal. It is highly opinionated and tailored to our specific needs.

A container image is available via

gsoci.azurecr.io/giantswarm/backstage-catalog-importer:[tag]

See the docs folder for information on usage and development.

The usual

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

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

Path	Synopsis
cmd Package cmd contains CLI commands.	Package cmd contains CLI commands.
appcatalogs Provides the 'appcatalogs' command to export Giant Swarm app catalogs as Backstage entities.	Provides the 'appcatalogs' command to export Giant Swarm app catalogs as Backstage entities.
charts Provides the 'charts' command to export OCI registry charts as Backstage entities.	Provides the 'charts' command to export OCI registry charts as Backstage entities.
installations Provides the 'installations' command to export an installations catalog.	Provides the 'installations' command to export an installations catalog.
users Provides the 'users' command to export a users catalog.	Provides the 'users' command to export a users catalog.
pkg
input/githubrepo Functions to fetch data about / from an individual Github repository.	Functions to fetch data about / from an individual Github repository.
input/helmchart
input/helmrepoindex Package helmrepoindex provides a means to read information form a Giant Swarm app catalog, which is technically a Helm repository index with conventional metadata.	Package helmrepoindex provides a means to read information form a Giant Swarm app catalog, which is technically a Helm repository index with conventional metadata.
input/installations Reads Giant Swarm installations info from the giantswarm/installations repository	Reads Giant Swarm installations info from the giantswarm/installations repository
input/ociregistry Package ociregistry provides a means to read repositories from an OCI registry.	Package ociregistry provides a means to read repositories from an OCI registry.
input/personio
input/repositories Package repositories provides types and tools to deal with Giant Swarm's repository configuration data maintained in https://github.com/giantswarm/github/tree/master/repositories	Package repositories provides types and tools to deal with Giant Swarm's repository configuration data maintained in https://github.com/giantswarm/github/tree/master/repositories
input/teams Package teams provides means to export GitHub teams to Backstage group entities.	Package teams provides means to export GitHub teams to Backstage group entities.
output/bscatalog/v1alpha1
output/catalog/component Package component provides high level structs and functions to create catalog entities of type "component" in an opinionated way.	Package component provides high level structs and functions to create catalog entities of type "component" in an opinionated way.
output/catalog/group
output/catalog/resource
output/catalog/user Represents a user to be exported into a Backstage catalog as a User entity.	Represents a user to be exported into a Backstage catalog as a User entity.
output/export Package export takes bscatalog entities and writes them to YAML files.	Package export takes bscatalog entities and writes them to YAML files.
util/component Package component provides utility functions for component metadata handling.	Package component provides utility functions for component metadata handling.