1ae5485998
The registry currently only accepts storage driver versions with the same major version and an equal or lower minor version as its own current storage driver api version, but this may be changed in the future if we decide to implement specific version cross-compatibility.
98 lines
2.5 KiB
Go
98 lines
2.5 KiB
Go
package ipc
|
|
|
|
import (
|
|
"fmt"
|
|
"io"
|
|
"reflect"
|
|
|
|
"github.com/docker/docker-registry/storagedriver"
|
|
"github.com/docker/libchan"
|
|
)
|
|
|
|
// IPCStorageDriver is the interface which IPC storage drivers must implement. As external storage
|
|
// drivers may be defined to use a different version of the storagedriver.StorageDriver interface,
|
|
// we use an additional version check to determine compatiblity.
|
|
type IPCStorageDriver interface {
|
|
// Version returns the storagedriver.StorageDriver interface version which this storage driver
|
|
// implements, which is used to determine driver compatibility
|
|
Version() (storagedriver.Version, error)
|
|
}
|
|
|
|
// IncompatibleVersionError is returned when a storage driver is using an incompatible version of
|
|
// the storagedriver.StorageDriver api
|
|
type IncompatibleVersionError struct {
|
|
version storagedriver.Version
|
|
}
|
|
|
|
func (e IncompatibleVersionError) Error() string {
|
|
return fmt.Sprintf("Incompatible storage driver version: %s", e.version)
|
|
}
|
|
|
|
// Request defines a remote method call request
|
|
// A return value struct is to be sent over the ResponseChannel
|
|
type Request struct {
|
|
Type string
|
|
Parameters map[string]interface{}
|
|
ResponseChannel libchan.Sender
|
|
}
|
|
|
|
type responseError struct {
|
|
Type string
|
|
Message string
|
|
}
|
|
|
|
// ResponseError wraps an error in a serializable struct containing the error's type and message
|
|
func ResponseError(err error) *responseError {
|
|
if err == nil {
|
|
return nil
|
|
}
|
|
return &responseError{
|
|
Type: reflect.TypeOf(err).String(),
|
|
Message: err.Error(),
|
|
}
|
|
}
|
|
|
|
func (err *responseError) Error() string {
|
|
return fmt.Sprintf("%s: %s", err.Type, err.Message)
|
|
}
|
|
|
|
// IPC method call response object definitions
|
|
|
|
// VersionResponse is a response for a Version request
|
|
type VersionResponse struct {
|
|
Version storagedriver.Version
|
|
Error *responseError
|
|
}
|
|
|
|
// ReadStreamResponse is a response for a ReadStream request
|
|
type ReadStreamResponse struct {
|
|
Reader io.ReadCloser
|
|
Error *responseError
|
|
}
|
|
|
|
// WriteStreamResponse is a response for a WriteStream request
|
|
type WriteStreamResponse struct {
|
|
Error *responseError
|
|
}
|
|
|
|
// ResumeWritePositionResponse is a response for a ResumeWritePosition request
|
|
type ResumeWritePositionResponse struct {
|
|
Position uint64
|
|
Error *responseError
|
|
}
|
|
|
|
// ListResponse is a response for a List request
|
|
type ListResponse struct {
|
|
Keys []string
|
|
Error *responseError
|
|
}
|
|
|
|
// MoveResponse is a response for a Move request
|
|
type MoveResponse struct {
|
|
Error *responseError
|
|
}
|
|
|
|
// DeleteResponse is a response for a Delete request
|
|
type DeleteResponse struct {
|
|
Error *responseError
|
|
}
|