2016-12-14 18:41:48 +03:00
|
|
|
// Package registry is an interface for service discovery
|
2015-01-14 02:31:27 +03:00
|
|
|
package registry
|
|
|
|
|
2016-02-25 15:42:31 +03:00
|
|
|
import (
|
2020-10-16 09:38:57 +03:00
|
|
|
"context"
|
2016-02-25 15:42:31 +03:00
|
|
|
"errors"
|
|
|
|
)
|
|
|
|
|
2020-06-17 15:23:41 +03:00
|
|
|
const (
|
|
|
|
// WildcardDomain indicates any domain
|
|
|
|
WildcardDomain = "*"
|
2020-06-19 12:34:12 +03:00
|
|
|
// DefaultDomain to use if none was provided in options
|
|
|
|
DefaultDomain = "micro"
|
2020-06-17 15:23:41 +03:00
|
|
|
)
|
|
|
|
|
2019-09-23 22:46:12 +03:00
|
|
|
var (
|
2020-11-03 01:08:23 +03:00
|
|
|
// DefaultRegistry is the global default registry
|
2020-10-16 09:38:57 +03:00
|
|
|
DefaultRegistry Registry = NewRegistry()
|
2020-08-25 14:33:36 +03:00
|
|
|
// ErrNotFound returned when GetService is called and no services found
|
2019-09-23 22:46:12 +03:00
|
|
|
ErrNotFound = errors.New("service not found")
|
2020-08-25 14:33:36 +03:00
|
|
|
// ErrWatcherStopped returned when when watcher is stopped
|
2019-09-23 22:46:12 +03:00
|
|
|
ErrWatcherStopped = errors.New("watcher stopped")
|
|
|
|
)
|
|
|
|
|
2016-01-31 00:13:34 +03:00
|
|
|
// The registry provides an interface for service discovery
|
|
|
|
// and an abstraction over varying implementations
|
|
|
|
// {consul, etcd, zookeeper, ...}
|
2015-01-14 02:31:27 +03:00
|
|
|
type Registry interface {
|
2018-08-08 20:57:29 +03:00
|
|
|
Init(...Option) error
|
|
|
|
Options() Options
|
2020-10-16 09:38:57 +03:00
|
|
|
Connect(context.Context) error
|
|
|
|
Disconnect(context.Context) error
|
2016-01-27 02:32:27 +03:00
|
|
|
Register(*Service, ...RegisterOption) error
|
2020-04-14 14:32:59 +03:00
|
|
|
Deregister(*Service, ...DeregisterOption) error
|
|
|
|
GetService(string, ...GetOption) ([]*Service, error)
|
|
|
|
ListServices(...ListOption) ([]*Service, error)
|
2018-02-19 20:12:37 +03:00
|
|
|
Watch(...WatchOption) (Watcher, error)
|
2015-12-20 00:56:14 +03:00
|
|
|
String() string
|
2015-06-01 20:55:27 +03:00
|
|
|
}
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// Service holds service registry info
|
2020-04-12 12:58:12 +03:00
|
|
|
type Service struct {
|
|
|
|
Name string `json:"name"`
|
|
|
|
Version string `json:"version"`
|
|
|
|
Metadata map[string]string `json:"metadata"`
|
|
|
|
Endpoints []*Endpoint `json:"endpoints"`
|
|
|
|
Nodes []*Node `json:"nodes"`
|
|
|
|
}
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// Node holds node registry info
|
2020-04-12 12:58:12 +03:00
|
|
|
type Node struct {
|
|
|
|
Id string `json:"id"`
|
|
|
|
Address string `json:"address"`
|
|
|
|
Metadata map[string]string `json:"metadata"`
|
|
|
|
}
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// Endpoint holds endpoint registry info
|
2020-04-12 12:58:12 +03:00
|
|
|
type Endpoint struct {
|
|
|
|
Name string `json:"name"`
|
|
|
|
Request *Value `json:"request"`
|
|
|
|
Response *Value `json:"response"`
|
|
|
|
Metadata map[string]string `json:"metadata"`
|
|
|
|
}
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// Valud holds additional kv stuff
|
2020-04-12 12:58:12 +03:00
|
|
|
type Value struct {
|
|
|
|
Name string `json:"name"`
|
|
|
|
Type string `json:"type"`
|
|
|
|
Values []*Value `json:"values"`
|
|
|
|
}
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// Option func signature
|
2015-12-19 21:28:08 +03:00
|
|
|
type Option func(*Options)
|
2015-05-16 02:34:02 +03:00
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// RegisterOption option is used to register service
|
2016-01-27 02:32:27 +03:00
|
|
|
type RegisterOption func(*RegisterOptions)
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// WatchOption option is used to watch service changes
|
2018-02-19 20:12:37 +03:00
|
|
|
type WatchOption func(*WatchOptions)
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// DeregisterOption option is used to deregister service
|
2020-04-14 14:32:59 +03:00
|
|
|
type DeregisterOption func(*DeregisterOptions)
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// GetOption option is used to get service
|
2020-04-14 14:32:59 +03:00
|
|
|
type GetOption func(*GetOptions)
|
|
|
|
|
2020-08-25 14:33:36 +03:00
|
|
|
// ListOption option is used to list services
|
2020-04-14 14:32:59 +03:00
|
|
|
type ListOption func(*ListOptions)
|