promote-ontology-relationship

Promote provider-specific relationships to canonical ontology edges with RelConstraint enforcement.

4.0k|550|Updated Feb 27, 2019
One-click install
npx skills add https://github.com/cartography-cncf/cartography --skill promote-ontology-relationship
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: promote-ontology-relationship
Source: https://github.com/cartography-cncf/cartography/tree/main/.agents/skills/promote-ontology-relationship
Command: npx skills add https://github.com/cartography-cncf/cartography --skill promote-ontology-relationship

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill promotes governance by aligning provider-specific relationships to a single canonical ontology edge, reducing divergence and enabling consistent graph queries across platforms.

Core Features & Use Cases

  • Canonical edge creation: adds a parallel canonical relationship while retaining the original edge for backward compatibility.
  • Ontology constraint enforcement: registers RelConstraint to enforce canonical edges across ontology-labeled nodes.
  • Migration guidance: provides step-by-step guidance for migrating edges with guardrails and tests to ensure safe rollout.

Quick Start

Use the promote-ontology-relationship skill to align a provider-specific edge to its canonical ontology edge across your environment.

Frequently Asked Questions about promote-ontology-relationship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map provider-specific graph edges to a canonical ontology schema?

Promoting provider-specific edges to a canonical ontology edge standardizes cross-provider graph schemas. It applies to migrations where ontology labels exist on both endpoints, handling direct edges and those derived via binding nodes.

How do I enforce relationship constraints during a graph schema migration?

You enforce relationship constraints during a graph schema migration by registering a RelConstraint via a CI guard. This updates the ONTOLOGY_REL_CONSTRAINTS registry to validate collisions and enforce canonical edges across ontology-labeled nodes.

Can I retain original provider edges while adding parallel canonical ontology edges?

Yes, you can retain original provider edges while adding parallel canonical ontology edges. This approach ensures backward compatibility while enabling consistent graph queries across platforms during migration.

What is the best way to unify divergent relationship mappings across multiple cloud providers?

The best way to unify divergent relationship mappings across providers is to promote them to a single canonical ontology edge. This reduces divergence and aligns provider-specific relationships for consistent graph queries.

How do I handle graph migrations involving binding nodes and ontology labels?

To handle graph migrations involving binding nodes and ontology labels, promote the provider-specific relationships to canonical edges. This requires ontology labels on both endpoints and supports edges derived via binding nodes with migration guardrails.

Why do I need to update the CartographyRelSchema definitions for ontology relationship mapping?

You need to update the CartographyRelSchema definitions to implement the promotion of provider-specific relationships to canonical edges. This ensures the schema changes are validated with tests for collisions and backward compatibility.