2016-03-18 21:50:19 +03:00
|
|
|
package libcontainerd
|
|
|
|
|
2016-07-16 00:12:07 +03:00
|
|
|
import (
|
|
|
|
"io"
|
|
|
|
|
2016-10-25 01:18:58 +03:00
|
|
|
containerd "github.com/docker/containerd/api/grpc/types"
|
2016-09-27 20:26:59 +03:00
|
|
|
"github.com/opencontainers/runtime-spec/specs-go"
|
2016-07-16 00:12:07 +03:00
|
|
|
"golang.org/x/net/context"
|
|
|
|
)
|
2016-03-18 21:50:19 +03:00
|
|
|
|
|
|
|
// State constants used in state change reporting.
|
|
|
|
const (
|
2016-10-28 07:55:08 +03:00
|
|
|
StateStart = "start-container"
|
|
|
|
StatePause = "pause"
|
|
|
|
StateResume = "resume"
|
|
|
|
StateExit = "exit"
|
|
|
|
StateRestore = "restore"
|
|
|
|
StateExitProcess = "exit-process"
|
|
|
|
StateOOM = "oom" // fake state
|
2016-03-18 21:50:19 +03:00
|
|
|
)
|
|
|
|
|
2016-04-02 03:02:38 +03:00
|
|
|
// CommonStateInfo contains the state info common to all platforms.
|
|
|
|
type CommonStateInfo struct { // FIXME: event?
|
2016-03-18 21:50:19 +03:00
|
|
|
State string
|
|
|
|
Pid uint32
|
|
|
|
ExitCode uint32
|
|
|
|
ProcessID string
|
|
|
|
}
|
|
|
|
|
|
|
|
// Backend defines callbacks that the client of the library needs to implement.
|
|
|
|
type Backend interface {
|
|
|
|
StateChanged(containerID string, state StateInfo) error
|
|
|
|
}
|
|
|
|
|
|
|
|
// Client provides access to containerd features.
|
|
|
|
type Client interface {
|
2016-10-25 01:18:58 +03:00
|
|
|
GetServerVersion(ctx context.Context) (*ServerVersion, error)
|
2016-10-18 00:39:52 +03:00
|
|
|
Create(containerID string, checkpoint string, checkpointDir string, spec specs.Spec, attachStdio StdioCallback, options ...CreateOption) error
|
2016-03-18 21:50:19 +03:00
|
|
|
Signal(containerID string, sig int) error
|
2016-04-18 12:48:13 +03:00
|
|
|
SignalProcess(containerID string, processFriendlyName string, sig int) error
|
2016-10-18 00:39:52 +03:00
|
|
|
AddProcess(ctx context.Context, containerID, processFriendlyName string, process Process, attachStdio StdioCallback) (int, error)
|
2016-03-18 21:50:19 +03:00
|
|
|
Resize(containerID, processFriendlyName string, width, height int) error
|
|
|
|
Pause(containerID string) error
|
|
|
|
Resume(containerID string) error
|
2016-10-18 00:39:52 +03:00
|
|
|
Restore(containerID string, attachStdio StdioCallback, options ...CreateOption) error
|
2016-03-18 21:50:19 +03:00
|
|
|
Stats(containerID string) (*Stats, error)
|
|
|
|
GetPidsForContainer(containerID string) ([]int, error)
|
2016-03-21 01:58:23 +03:00
|
|
|
Summary(containerID string) ([]Summary, error)
|
2016-03-18 21:50:19 +03:00
|
|
|
UpdateResources(containerID string, resources Resources) error
|
2016-05-12 17:52:00 +03:00
|
|
|
CreateCheckpoint(containerID string, checkpointID string, checkpointDir string, exit bool) error
|
|
|
|
DeleteCheckpoint(containerID string, checkpointID string, checkpointDir string) error
|
|
|
|
ListCheckpoints(containerID string, checkpointDir string) (*Checkpoints, error)
|
2016-03-18 21:50:19 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
// CreateOption allows to configure parameters of container creation.
|
|
|
|
type CreateOption interface {
|
|
|
|
Apply(interface{}) error
|
|
|
|
}
|
|
|
|
|
2016-10-18 00:39:52 +03:00
|
|
|
// StdioCallback is called to connect a container or process stdio.
|
|
|
|
type StdioCallback func(IOPipe) error
|
|
|
|
|
2016-03-18 21:50:19 +03:00
|
|
|
// IOPipe contains the stdio streams.
|
|
|
|
type IOPipe struct {
|
|
|
|
Stdin io.WriteCloser
|
2016-10-15 02:31:27 +03:00
|
|
|
Stdout io.ReadCloser
|
|
|
|
Stderr io.ReadCloser
|
2016-03-18 21:50:19 +03:00
|
|
|
Terminal bool // Whether stderr is connected on Windows
|
|
|
|
}
|
2016-10-25 01:18:58 +03:00
|
|
|
|
|
|
|
// ServerVersion contains version information as retrieved from the
|
|
|
|
// server
|
|
|
|
type ServerVersion struct {
|
|
|
|
containerd.GetServerVersionResponse
|
|
|
|
}
|