Expand description
Fabric-wide service registry for grafOS.
RegistryRegion stores service registrations in a FabricHashMap backed
by leased fabric memory. Services register via RegistryWriter and are
discovered via RegistryReader. Change detection uses a monotonic version
counter exposed through RegistryWatcher.
§Quick start
use grafos_registry::{RegistryBuilder, ServiceRegistration, ServiceEndpoint, HealthStatus};
let (mut writer, _reader) = RegistryBuilder::new()
.capacity(64)
.build()?;
let reg = ServiceRegistration::new("my-service", "1.0.0", 1)
.with_endpoint(ServiceEndpoint::net([10, 0, 0, 1], 8080))
.with_tag("region", "us-east");
writer.register(reg)?;
let results = writer.lookup("my-service")?;
assert_eq!(results.len(), 1);§Feature flags
| Feature | Default | Effect |
|---|---|---|
std | Yes | Enables std in grafos-std |
observe | No | Enables grafos-observe metrics |
rpc | No | Adds grafos-rpc RpcResolver integration |
durable | No | Cold-start checkpoint to block storage |
Structs§
- Registry
Builder - Builder for creating a registry writer/reader pair.
- Registry
Filter - Filter criteria for registry lookups.
- Registry
Reader - Read handle for the service registry.
- Registry
Region - Fabric-backed registry storage.
- Registry
Watcher - Tracks the last-seen registry version and detects changes.
- Registry
Writer - Write handle for the service registry.
- Service
Registration - A single service registration in the registry.
Enums§
- Health
Status - Health status of a service instance.
- Service
Endpoint - A reachable endpoint for a service instance.