A vendor-agnostic specification developed in the CNCF (by the same friendly people who made CloudEvents) to define, discover, validate, and version metadata across systems
The xRegistry project defines an model-driven approach to managing metadata like schemas or event definitions and provides a REST-based interface and a document format that are structurally symmetric. You can use the standard registries for event-driven applications that are included, or you can define your own registries for other types of metadata. Multiple registries can be used together to form a single registry for all of your metadata, forming a metadata graph that can be used to discover and validate metadata across systems.
Key Capabilities
Discovery
Centralized registry providing a single source of truth across organizational boundaries.
Vendor-Agnostic
Common foundation across different registry solutions, reducing integration friction.
Versioning
Compatibility strategies for evolving systems without breaking existing consumers.
Validation
Shared location for schema definitions serving as contracts between publishers and consumers.
Payload Reduction
Enables lightweight serialization like Protobuf and Avro.
Code Generation
Enables data contracts and client code directly from the registry.
Implementation Options
File Representation
Single JSON file for local projects/repos
Static File Server
Multiple JSON files via static hosting
API Server
Full implementation with search & write
Documentation
Core Specification
Technical details of the xRegistry core model and APIs
Primer
Overview of history, motivation, and design goals
Endpoints Specification
Domain-specific extension for endpoints discovery
Schemas Specification
Domain-specific extension for schema management
Message Specification
Domain-specific extension for message definitions
Ready to Get Started?
Explore the specifications and examples to begin your journey with xRegistry.
Explore on GitHub