Add the personal-services System to the cluster catalog descriptor #86

Closed
opened 2026-11-21 22:00:54 +00:00 by martin · 3 comments
Owner

Summary

Define the Backstage personal-services System in the repository that owns the deployed cluster workloads.

Context

The System is currently maintained centrally in Personal/backstage's examples/systems.yaml, while this repository is the GitOps source of truth for the cluster and its deployed applications, including Toolbox, martials.no, and recurring-events. This repository currently has no root catalog-info.yaml.

Scope

  • Add a root catalog-info.yaml declaring the personal-services System with the existing stable entity ref, accurate owner and description, Forgejo project annotation, and a link to this repository.
  • Keep the change limited to catalog metadata; do not modify Nixidy configuration or generated manifests.

Acceptance criteria

  • The root descriptor parses and schema-validates as a Backstage System entity.
  • The descriptor uses the stable system:default/personal-services ref, owner user:default/martin, and the existing system description.
  • The Forgejo provider can discover the descriptor from this repository's default branch.
  • Personal/backstage#53 can remove the central System source without leaving duplicate or unresolved System references.
## Summary Define the Backstage `personal-services` System in the repository that owns the deployed cluster workloads. ## Context The System is currently maintained centrally in Personal/backstage's `examples/systems.yaml`, while this repository is the GitOps source of truth for the cluster and its deployed applications, including Toolbox, martials.no, and recurring-events. This repository currently has no root `catalog-info.yaml`. ## Scope - Add a root `catalog-info.yaml` declaring the `personal-services` System with the existing stable entity ref, accurate owner and description, Forgejo project annotation, and a link to this repository. - Keep the change limited to catalog metadata; do not modify Nixidy configuration or generated manifests. ## Acceptance criteria - [x] The root descriptor parses and schema-validates as a Backstage System entity. - [x] The descriptor uses the stable `system:default/personal-services` ref, owner `user:default/martin`, and the existing system description. - [x] The Forgejo provider can discover the descriptor from this repository's default branch. - [x] Personal/backstage#53 can remove the central System source without leaving duplicate or unresolved System references. ## Related - Personal/backstage#28 tracks repository-owned catalog metadata. - Personal/backstage#53 tracks removing the central System registration after this descriptor is available.
Author
Owner

Progress

  • Prepared the root catalog-info.yaml System descriptor on branch feat/personal-services-catalog and opened PR #87.
  • Backstage System schema validation and yamlfmt -lint catalog-info.yaml passed. No Nixidy configuration or generated manifests were changed. The PR is open and not merged.
## Progress - Prepared the root `catalog-info.yaml` System descriptor on branch `feat/personal-services-catalog` and opened [PR #87](https://code.martials.no/Personal/cluster/pulls/87). - Backstage System schema validation and `yamlfmt -lint catalog-info.yaml` passed. No Nixidy configuration or generated manifests were changed. The PR is open and not merged.
Author
Owner

Progress

  • Opened PR #87 with the repository-owned personal-services System descriptor.
  • Backstage System schema validation and yamlfmt -lint passed. The PR is open; no Nixidy files or manifests changed.
## Progress - Opened [PR #87](https://code.martials.no/Personal/cluster/pulls/87) with the repository-owned `personal-services` System descriptor. - Backstage System schema validation and `yamlfmt -lint` passed. The PR is open; no Nixidy files or manifests changed.
Author
Owner

Completed by merged PR #87 (c08c9f471092ac841c6581fa6ca3764bcdeab170). The root System descriptor is on main and Backstage schema validation passed. Live catalog verification after merge confirmed exactly one personal-services System, its component memberships, and no duplicate refs; Backstage#57 contains the tested central-source cleanup.

Completed by merged [PR #87](https://code.martials.no/Personal/cluster/pulls/87) (`c08c9f471092ac841c6581fa6ca3764bcdeab170`). The root System descriptor is on `main` and Backstage schema validation passed. Live catalog verification after merge confirmed exactly one `personal-services` System, its component memberships, and no duplicate refs; Backstage#57 contains the tested central-source cleanup.
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/cluster#86
No description provided.