micro/runtime/runtime.go

111 lines
2.2 KiB
Go
Raw Normal View History

2019-09-14 07:33:14 +03:00
// Package runtime is a service runtime manager
package runtime
2020-01-18 05:13:24 +03:00
import (
"errors"
"time"
)
var (
// DefaultRuntime is default micro runtime
DefaultRuntime Runtime = NewRuntime()
2019-11-20 17:54:42 +03:00
// DefaultName is default runtime service name
DefaultName = "go.micro.runtime"
2020-01-18 05:13:24 +03:00
ErrAlreadyExists = errors.New("already exists")
)
2019-09-14 07:33:14 +03:00
// Runtime is a service runtime manager
type Runtime interface {
2020-02-03 18:56:16 +03:00
// String describes runtime
String() string
// Init initializes runtime
Init(...Option) error
// Create registers a service
2019-09-24 20:32:35 +03:00
Create(*Service, ...CreateOption) error
// Read returns the service
2019-11-29 14:35:00 +03:00
Read(...ReadOption) ([]*Service, error)
2019-10-29 15:29:21 +03:00
// Update the service in place
Update(*Service) error
// Remove a service
Delete(*Service) error
2019-10-29 15:29:21 +03:00
// List the managed services
List() ([]*Service, error)
// Start starts the runtime
Start() error
// Stop shuts down the runtime
2019-09-14 07:33:14 +03:00
Stop() error
// Logs
Logs(*Service, ...LogsOption) (LogStream, error)
}
// Stream returns a log stream
type LogStream interface {
Error() error
Chan() chan LogRecord
Stop() error
}
type LogRecord struct {
Message string
Metadata map[string]string
2019-09-14 07:33:14 +03:00
}
2020-01-16 16:34:04 +03:00
// Scheduler is a runtime service scheduler
type Scheduler interface {
// Notify publishes schedule events
Notify() (<-chan Event, error)
2020-01-16 16:34:04 +03:00
// Close stops the scheduler
Close() error
2019-09-14 07:33:14 +03:00
}
2020-01-16 16:34:04 +03:00
// EventType defines schedule event
type EventType int
const (
// Create is emitted when a new build has been craeted
Create EventType = iota
// Update is emitted when a new update become available
Update
// Delete is emitted when a build has been deleted
Delete
)
2019-10-29 15:29:21 +03:00
// String returns human readable event type
func (t EventType) String() string {
switch t {
case Create:
return "create"
case Delete:
return "delete"
case Update:
return "update"
default:
return "unknown"
}
2019-10-29 15:29:21 +03:00
}
// Event is notification event
type Event struct {
// Type is event type
Type EventType
// Timestamp is event timestamp
Timestamp time.Time
// Service is the name of the service
Service string
// Version of the build
Version string
2019-09-14 07:33:14 +03:00
}
// Service is runtime service
type Service struct {
// Name of the service
Name string
2019-11-24 01:50:13 +03:00
// Version of the service
Version string
// url location of source
Source string
// Metadata stores metadata
Metadata map[string]string
2019-09-14 07:33:14 +03:00
}