docker

package

v1.0.0 Latest Latest Go to latest Published: May 9, 2026 License: MIT Imports: 7 Imported by: 0

Details

Package docker wraps the Docker Engine API for container operations.

This section is empty.

This section is empty.

func ValidateServiceName(name string) error

ValidateServiceName checks that a service name conforms to Docker Compose naming rules.

type Client struct {
	// contains filtered or unexported fields
}

Client provides high-level container operations on top of the Docker SDK.

func NewClient() (*Client, error)

NewClient connects to the Docker daemon using environment configuration.

func (c *Client) Close() error

Close releases the underlying Docker client connection.

func (c *Client) ContainerIDByName(serviceName string) (string, error)

ContainerIDByName finds a running container by its compose service label.

func (c *Client) ExecShell(ctx context.Context, containerID string, in io.Reader, out io.Writer) error

ExecShell opens an interactive shell (bash or sh) inside the container.

func (c *Client) Logs(ctx context.Context, containerID string, follow bool, w io.Writer) error

Logs streams container logs to w, optionally following new output.

func (c *Client) Raw() *dockerclient.Client

Raw returns the underlying Docker SDK client for advanced operations.

func (c *Client) Restart(ctx context.Context, containerID string) error

Restart stops and restarts a container.

func (c *Client) Status(ctx context.Context, containerID string) (string, error)

Status returns the health or running state of a container.

func (c *Client) TailLogs(ctx context.Context, containerID string, lines int, w io.Writer) error

TailLogs writes the last N lines of container logs to w.