Interface ContainerRuntime

agent/internal/container/container_runtime.go:17–46

ContainerRuntime is our interface for interacting with runtimes like Docker.

// ContainerRuntime is our interface for interacting with runtimes like Docker.
type ContainerRuntime interface {
	ReattachContainer(
		ctx context.Context,
		id cproto.ID,
	) (*docker.Container, *aproto.ExitCode, error)

	PullImage(ctx context.Context, req docker.PullImage, p events.Publisher[docker.Event]) error

	// TODO(DET-9075): Refactor Create and Run to not be separate calls.
	CreateContainer(
		ctx context.Context,
		id cproto.ID,
		req cproto.RunSpec,
		p events.Publisher[docker.Event],
	) (string, error)

	// TODO(DET-9075): Make a custom return type rather than just reusing the Docker type.
	RunContainer(
		ctx context.Context,
		waitCtx context.Context,
		id string,
		p events.Publisher[docker.Event],
	) (*docker.Container, error)

	SignalContainer(ctx context.Context, id string, sig syscall.Signal) error

	RemoveContainer(ctx context.Context, id string, force bool) error

	ListRunningContainers(ctx context.Context, fs filters.Args) (map[cproto.ID]types.Container, error)
}