Add a Backstage catalog descriptor #64

Closed
opened 2026-11-21 21:12:49 +00:00 by martin · 3 comments
Owner

Summary

Add a root catalog-info.yaml so the Toolbox repository is discoverable as a Backstage Component.

Context

The Backstage Forgejo provider imports repositories only when their configured descriptor exists. The current portal fixture represents this repository as the stable Component toolbox, but the default branch does not currently contain a root descriptor.

Scope

  • Add a root Component descriptor for Toolbox.
  • Verify the current owner, lifecycle, system membership, project identity, description, and useful links against this repository; use the portal fixture as a compatibility reference, not as the source of truth.

Acceptance criteria

  • A valid root catalog-info.yaml defines the stable Component:default/toolbox entity.
  • Owner, lifecycle, system membership, Forgejo project annotation, and useful repository/service links are accurate and resolve.
  • The descriptor is ready for the Backstage provider to import without duplicate entity refs.
## Summary Add a root catalog-info.yaml so the Toolbox repository is discoverable as a Backstage Component. ## Context The Backstage Forgejo provider imports repositories only when their configured descriptor exists. The current portal fixture represents this repository as the stable Component toolbox, but the default branch does not currently contain a root descriptor. ## Scope - Add a root Component descriptor for Toolbox. - Verify the current owner, lifecycle, system membership, project identity, description, and useful links against this repository; use the portal fixture as a compatibility reference, not as the source of truth. ## Acceptance criteria - [x] A valid root catalog-info.yaml defines the stable Component:default/toolbox entity. - [x] Owner, lifecycle, system membership, Forgejo project annotation, and useful repository/service links are accurate and resolve. - [x] The descriptor is ready for the Backstage provider to import without duplicate entity refs. ## Related - Personal/backstage#28 tracks the catalog support and depends on this repository change.
Author
Owner

Progress

  • Opened PR #65 adding the root Component descriptor.
  • Backstage YAML parsing and Component schema validation passed; git diff --check passed. The PR is open and not merged.
## Progress - Opened [PR #65](https://code.martials.no/Personal/toolbox/pulls/65) adding the root Component descriptor. - Backstage YAML parsing and Component schema validation passed; `git diff --check` passed. The PR is open and not merged.
Author
Owner

Progress

  • PR #65 was merged as 2201bdf3dc2c2a4cd7afbdb7196da5cc5e61ceec; the root catalog-info.yaml is present on main.
  • Backstage descriptor parsing/schema validation and git diff --check passed. Portal-level ingestion is still tracked under Personal/backstage#28.
## Progress - [PR #65](https://code.martials.no/Personal/toolbox/pulls/65) was merged as `2201bdf3dc2c2a4cd7afbdb7196da5cc5e61ceec`; the root `catalog-info.yaml` is present on `main`. - Backstage descriptor parsing/schema validation and `git diff --check` passed. Portal-level ingestion is still tracked under Personal/backstage#28.
Author
Owner

Completed by merged PR #65 (2201bdf3dc2c2a4cd7afbdb7196da5cc5e61ceec). The root descriptor is on main, passed Backstage parsing/schema validation, and contains the stable entity ref and verified metadata. Closing this repository-level task; portal-wide ingestion remains in Personal/backstage#28.

Completed by merged [PR #65](https://code.martials.no/Personal/toolbox/pulls/65) (`2201bdf3dc2c2a4cd7afbdb7196da5cc5e61ceec`). The root descriptor is on `main`, passed Backstage parsing/schema validation, and contains the stable entity ref and verified metadata. Closing this repository-level task; portal-wide ingestion remains in Personal/backstage#28.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
Personal/toolbox#64
No description provided.