The Extensible Registry for Metadata Management

A vendor-agnostic specification developed in the CNCF (by the same friendly people who made CloudEvents Logo 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

Ready to Get Started?

Explore the specifications and examples to begin your journey with xRegistry.

Explore on GitHub