Register an existing component

Your component already has a catalog-info.yaml file in its repository. Give its URL to Astrolabe: the component appears in the catalog.

Before you start

• The URL of the catalog-info.yaml file, as your browser shows it. Example: https://github.com/acme/shop-api/blob/main/catalog-info.yaml.
• The integration of the tool that hosts the file (GitHub, GitLab…) in Company connections. See Integrations.

📥 Register the component

1. In the left sidebar, click Catalog.

2. At the top right of the page, click Register an existing component.

3. In URL, paste the URL of the catalog-info.yaml file.

4. Click Analyze. Astrolabe reads the file and lists The following entities will be added to the catalog:.

5. Check the list, then click Import. The screen says The following entities have been added to the catalog:.

6. Click View Component to open its page.

✅ That's it!

To add another one, click Register another.

Common problems

What you see	What to do
Nothing was found at this address. Check that the file exists on …, on the branch you typed, then try again.	The file is not at this address. Open the URL in your browser, copy the address of the catalog-info.yaml file itself, and paste it again.
Astrolabe is not connected to …. Ask an administrator to add it in Administration › Company connections, then try again.	Astrolabe has no integration for this host. Ask your Astrolabe administrator to add it in Company connections.
The file was found, but it is not a valid component description. Check that it starts with apiVersion, kind and metadata, then try again.	The file is not a component description. Open it and check that it starts with apiVersion, kind and metadata.
Astrolabe could not read this address. Check the address, then try again.	Check the address for a typo, then click Analyze again.
The following locations already exist in the catalog:	The file is already registered. Click Refresh to read it again, or Back to enter another URL.