feat: add Compass catalog manifests for ocp-admin pack#133
Draft
r2dedios wants to merge 11 commits into
Draft
Conversation
Add catalog-info.yaml manifests to register the repository and ocp-admin agentic pack in Red Hat Compass (Backstage). Includes: - Root Location pointing to all agentic packs - ocp-admin pack Location aggregating skills and MCP servers - 7 AiResource entities for skills (cluster-creator, cluster-inventory, cluster-report, container-cve-validator, coreos-cve-validator, cve-recon, image-inspect) - 3 MCPServer entities (openshift-self-managed, openshift-ocm-managed, openshift-administration) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add 19 centralized MCP server manifests in ./mcps/ (flat structure) with deduplication by functional variant for shared images - Add 68 skill (AiResource) manifests across 6 new packs: rh-sre (13), rh-virt (10), rh-developer (17), rh-basic (6), rh-ai-engineer (11), rh-automation (11) - Add pack Location manifests for rh-sre, rh-virt, rh-developer, rh-basic, rh-ai-engineer, rh-automation - Update root Location to reference all 7 packs + 19 MCPs - Update ocp-admin Location: remove MCP targets, add labels - Update ocp-admin skill dependsOn refs to use default namespace - Remove old ocp-admin/mcps/ catalog-info.yaml files - Add domain-prefixed labels on all Locations: agentic-plugins.redhat.com/version and agentic-plugins.redhat.com/repo
Create a Domain entity (agentic-plugins) as the top-level parent and 7 System entities (one per pack) to provide rich grouping pages in Compass. Skills already reference their pack System via spec.system, so Backstage will auto-generate hasPart relations once these exist.
Merge 19 MCP manifests into 9 by grouping variants that share the same container image or server technology: - 4 openshift-mcp-server variants → openshift-mcp-server - 2 assisted-service-mcp variants → assisted-installer - 2 lightspeed variants → red-hat-lightspeed - 6 AAP endpoint variants → ansible-automation-platform - 5 unique MCPs unchanged Update all 75 skill dependsOn references and deduplicate where a skill previously referenced multiple variants of the same MCP.
Domain kind is not allowed for GitHub-based Location registration in Compass. Remove domain.yaml target and domain references from all System manifests to unblock registration.
Add backstage.io/techdocs-ref annotation to each pack's system.yaml pointing to the pack README.md on GitHub main branch.
Add dedicated namespace to all 9 MCPServer manifests and update all 71 skill dependsOn references accordingly.
…tions - Create System entity for shared MCPs (rh-agentic-plugins-mcps) - Add spec.system to all 9 MCPServer manifests - Add spec.dependsOn to 7 pack Systems linking to their MCPs - Add agentic.redhat.com/* annotations to all pack Locations and Systems - Fix repo label from "redhat-agentic-plugins" to "agentic-plugins" - Remove domain.yaml (Compass rejects Domain from GitHub Locations)
Point each MCPServer to its upstream repo README: - openshift-mcp-server → openshift/openshift-mcp-server - assisted-installer → openshift-assisted/assisted-service-mcp - red-hat-lightspeed → RedHatInsights/insights-mcp - ansible-automation-platform → ansible/aap-mcp-server - ai-observability → rh-ai-quickstart/ai-observability-summarizer - rhoai → opendatahub-io/rhoai-mcp - podman → manusa/podman-mcp-server - github → github/github-mcp-server red-hat-security skipped (no public repo, hosted service).
Add airesource dependsOn entries for orchestration skills that directly invoke other skills via the Skill tool. Covers 37 dependencies across 8 skills in rh-sre, rh-developer, rh-automation, and rh-ai-engineer. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
TechDocs builder expects mkdocs.yml + docs/ in the target repo, but our techdocs-ref URLs pointed to bare README.md files causing ENOENT errors. Move upstream MCP repo URLs to metadata.links instead, where they render as navigable links without triggering the builder. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
catalog-info.yamlmanifests to register the repository and ocp-admin agentic pack in Red Hat Compass (Backstage)Entities
Test plan
validate-entityAPIcatalog-info.yamlin Compass and verify all entities appear🤖 Generated with Claude Code