containers

func CreateWithSpec ¶ added in v1.8.1

func CreateWithSpec(ctx context.Context, s *specgen.SpecGenerator) (utils.ContainerCreateResponse, error)

func Exists ¶

func Exists(ctx context.Context, nameOrID string) (bool, error)

Exists is a quick, light-weight way to determine if a given container exists in local storage. The nameOrID can be a container name or a partial/full ID.

func GetMountedContainerPaths ¶

func GetMountedContainerPaths(ctx context.Context) (map[string]string, error)

GetMountedContainerPaths returns a map of mounted containers and their mount locations.

func Inspect ¶

func Inspect(ctx context.Context, nameOrID string, size *bool) (*libpod.InspectContainerData, error)

Inspect returns low level information about a Container. The nameOrID can be a container name or a partial/full ID. The size bool determines whether the size of the container's root filesystem should be calculated. Calculating the size of a container requires extra work from the filesystem and is therefore slower.

func Kill ¶

func Kill(ctx context.Context, nameOrID string, signal string) error

Kill sends a given signal to a given container. The signal should be the string representation of a signal like 'SIGKILL'. The nameOrID can be a container name or a partial/full ID

func List ¶

func List(ctx context.Context, filters map[string][]string, all *bool, last *int, pod, size, sync *bool) ([]lpapiv2.ListContainer, error)

List obtains a list of containers in local storage. All parameters to this method are optional. The filters are used to determine which containers are listed. The last parameter indicates to only return the most recent number of containers. The pod and size booleans indicate that pod information and rootfs size information should also be included. Finally, the sync bool synchronizes the OCI runtime and container state.

func Logs ¶

func Logs()

func Mount ¶

func Mount(ctx context.Context, nameOrID string) (string, error)

Mount mounts an existing container to the filesystem. It returns the path of the mounted container in string format.

func Pause ¶

func Pause(ctx context.Context, nameOrID string) error

Pause pauses a given container. The nameOrID can be a container name or a partial/full ID.

func Prune ¶

func Prune(ctx context.Context, filters map[string][]string) ([]string, error)

Prune removes stopped and exited containers from local storage. The optional filters can be used for more granular selection of containers. The main error returned indicates if there were runtime errors like finding containers. Errors specific to the removal of a container are in the PruneContainerResponse structure.

func Remove ¶

func Remove(ctx context.Context, nameOrID string, force, volumes *bool) error

Remove removes a container from local storage. The force bool designates that the container should be removed forcibly (example, even it is running). The volumes bool dictates that a container's volumes should also be removed.

func Restart ¶

func Restart(ctx context.Context, nameOrID string, timeout *int) error

Restart restarts a running container. The nameOrID can be a container name or a partial/full ID. The optional timeout specifies the number of seconds to wait for the running container to stop before killing it.

func RunHealthCheck ¶

func RunHealthCheck(ctx context.Context, nameOrID string) (*libpod.HealthCheckStatus, error)

RunHealthCheck executes the container's healthcheck and returns the health status of the container.

func Start ¶

func Start(ctx context.Context, nameOrID string, detachKeys *string) error

Start starts a non-running container.The nameOrID can be a container name or a partial/full ID. The optional parameter for detach keys are to override the default detach key sequence.

func Stats ¶

func Stats()

func Stop ¶

func Stop(ctx context.Context, nameOrID string, timeout *int) error

Stop stops a running container. The timeout is optional. The nameOrID can be a container name or a partial/full ID

func Top ¶

func Top()

func Unmount ¶

func Unmount(ctx context.Context, nameOrID string) error

Unmount unmounts a container from the filesystem. The container must not be running or the unmount will fail.

func Unpause ¶

func Unpause(ctx context.Context, nameOrID string) error

Unpause resumes the given paused container. The nameOrID can be a container name or a partial/full ID.

func Wait ¶

func Wait(ctx context.Context, nameOrID string, condition *string) (int32, error)

Wait blocks until the given container reaches a condition. If not provided, the condition will default to stopped. If the condition is stopped, an exit code for the container will be provided. The nameOrID can be a container name or a partial/full ID.