Trebejo.Docker (Trebejo v1.0.0)

Docker / Podman container lifecycle management.

Detects the available container runtime (Docker or Podman) and provides a unified interface for container and compose operations.

All command execution is routed through Arrea.Command.execute/2 with validate: false. Runtime is auto-detected via Trebejo.Proc.command_exists?/1; environment variable CONTAINER_RUNTIME (docker | podman) overrides the detection.

Container detection

Use runtime/0 to detect the available runtime, or set the CONTAINER_RUNTIME environment variable to override.

Summary

Types

runtime()

Functions

build(opts \\ [])

Builds images.

down(opts \\ [])

Stops and removes services.

exec(service, command, opts \\ [])

Executes a command in a service container.

in_container?()

Returns true if running inside a container.

logs(opts \\ [])

Shows logs.

network_create(name, opts \\ [])

Creates a network.

network_list(opts \\ [])

Lists networks.

network_remove(name, opts \\ [])

Removes a network.

ps(opts \\ [])

Lists running services.

pull(opts \\ [])

Pulls images.

restart(opts \\ [])

Restarts services.

runtime()

Detects the available container runtime.

up(opts \\ [])

Starts services defined in docker-compose.yml.

volume_create(name, opts \\ [])

Creates a volume.

volume_list(opts \\ [])

Lists volumes.

volume_remove(name, opts \\ [])

Removes a volume.

Types

runtime()

@type runtime() :: :docker | :podman

Functions

build(opts \\ [])

@spec build(keyword()) :: {:ok, binary()} | {:error, binary()}

Builds images.

down(opts \\ [])

@spec down(keyword()) :: {:ok, binary()} | {:error, binary()}

Stops and removes services.

exec(service, command, opts \\ [])

@spec exec(binary(), [binary()], keyword()) :: {:ok, binary()} | {:error, binary()}

Executes a command in a service container.

in_container?()

@spec in_container?() :: boolean()

Returns true if running inside a container.

logs(opts \\ [])

@spec logs(keyword()) :: {:ok, binary()} | {:error, binary()}

Shows logs.

network_create(name, opts \\ [])

@spec network_create(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Creates a network.

network_list(opts \\ [])

@spec network_list(keyword()) :: {:ok, binary()} | {:error, binary()}

Lists networks.

network_remove(name, opts \\ [])

@spec network_remove(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Removes a network.

ps(opts \\ [])

@spec ps(keyword()) :: {:ok, binary()} | {:error, binary()}

Lists running services.

pull(opts \\ [])

@spec pull(keyword()) :: {:ok, binary()} | {:error, binary()}

Pulls images.

restart(opts \\ [])

@spec restart(keyword()) :: {:ok, binary()} | {:error, binary()}

Restarts services.

runtime()

@spec runtime() :: runtime() | :none

Detects the available container runtime.

up(opts \\ [])

@spec up(keyword()) :: {:ok, binary()} | {:error, binary()}

Starts services defined in docker-compose.yml.

volume_create(name, opts \\ [])

@spec volume_create(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Creates a volume.

volume_list(opts \\ [])

@spec volume_list(keyword()) :: {:ok, binary()} | {:error, binary()}

Lists volumes.

volume_remove(name, opts \\ [])

@spec volume_remove(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Removes a volume.