Choose what the catalog imports
The catalog fills itself from your providers: GitLab, GitHub, Azure DevOps, Bitbucket, Microsoft Graph. In Administration › Catalog you choose which providers run, and what each one reads.
You do it as an administrator.
Before you start
A provider reads your tool with the connection you added in Company connections. Add it first: without it, the card of the provider says Configure the github integration first: without it, this provider cannot read anything. (with the name of its tool) and its switch stays off.
🔧 Turn a provider on
-
In the left sidebar, at the bottom, click Administration.
-
Under PLATFORM, click Catalog. The Providers tab opens, with one card per provider.
-
On the card of your provider, click Configure.
-
Fill in the form. Each ? next to a field explains it.
-
Click Install.
-
The window Reloading configuration says Please wait while the instance is reloading... Wait until the page comes back.
The fields depend on the provider: follow the page of yours.
| Provider | Page |
|---|---|
| GitLab | Import your GitLab projects |
| GitHub | Import your GitHub repositories |
| Azure DevOps | Azure DevOps |
| Bitbucket Server | Import your Bitbucket Server repositories |
| Bitbucket Cloud | Import your Bitbucket Cloud repositories |
| Microsoft Graph | Entra ID |
🔍 Narrow what a provider imports
On the Configure form of GitLab, these fields keep the catalog from filling with everything:
| Field | What it does |
|---|---|
| Group | Only this group and its subgroups. |
| Only projects I am a member of | Only the projects of the token's user. |
| Project Regex | Only the projects whose name matches, for example ^api-.*. |
| Skip Forked Repositories | Leaves out forked projects. |
| Branches | The branches to read. |
| Catalog File | The file to read at the root of each project. Default: catalog-info.yaml. |
To change them later, click Configure on the card again, edit, and click Update Configuration. Astrolabe reloads the same way.
📋 See how the collections went
Once a provider is installed, the Providers tab shows the Catalog collection table above the cards:
| Column | What it says |
|---|---|
| Provider | The provider. |
| State | Done, Running, Failed or Unknown. |
| Last run / Next run | When it last ran, when it runs next. |
| Detail | What happened, in a sentence. |
| Actions | The play button of the row, for example Run the GitLab projects collection now. |
To collect right now, click the play button on the row of the provider: see Run a catalog collection now.
⛔ Turn a provider off
-
On the card of the provider, click Configure.
-
Click Uninstall.
✅ That's it!
Next: Run a catalog collection now.