Skip to main content
← back to extensions

@swampadmin/container-runtime

v2026.02.15.0

Container execution drivers for Docker and Podman with Compose-based orchestration.

Drivers

  • Docker Engine — connects via /var/run/docker.sock
  • Podman — rootless containers, systemd integration

Both drivers support run, stop, logs, exec, and inspect through a unified container model.

Repository

https://github.com/swamp-club/container-runtime

Platforms

linux-x86_64linux-aarch64

Labels

containersdockerpodmanruntime

Install

$ swamp extension pull @swampadmin/container-runtime

Release Notes

New

  • Podman driver — rootless container support
  • Compose model — up, down, scale for multi-container stacks
  • Deploy workflow — pull images then start stack
  • Container inspect method

Fixed

  • Docker driver now reconnects on socket timeout

@swampadmin/container-runtime/containerv1.0.0container.ts

Global Arguments

ArgumentTypeDescription
runtime?stringContainer runtime (docker, podman)
runrun operation
ArgumentTypeDescription
imagestringContainer image reference
env?recordEnvironment variables
ports?arrayPort mappings (host:container)
stopstop operation
ArgumentTypeDescription
idstringInstance identifier to stop
graceful?booleanWait for in-flight requests to complete
logslogs operation
ArgumentTypeDescription
idstringContainer identifier
tail?numberNumber of lines from the end
follow?booleanStream logs in real time
execexec operation
ArgumentTypeDescription
commandstringCommand to execute
timeout?numberTimeout in seconds
inspectinspect operation
ArgumentTypeDescription
idstringResource identifier

Resources

container.state(persistent)— Managed resource state
container.lock(ephemeral)— Concurrency lock
@swampadmin/container-runtime/composev1.0.0compose.ts

Global Arguments

ArgumentTypeDescription
runtime?stringContainer runtime (docker, podman)
upup operation
ArgumentTypeDescription
namestringResource name
downdown operation
ArgumentTypeDescription
namestringResource name
scalescale operation
ArgumentTypeDescription
namestringResource name

Files

compose.log(text/plain)— Operation audit log
compose.json(application/json)— Structured output

Deploy Compose Stackdeploy-compose

Deploy Compose Stack workflow

deploy-compose-jobExecute Deploy Compose Stack
1.Pull Images@swampadmin/container-runtime/container.run— Pull Images step
2.Start Stack@swampadmin/container-runtime/compose.up— Start Stack step

docker-engineconfigurable
driverdocker.ts

docker-engine execution driver

Config Fields

FieldTypeDescription
socket_path?stringDocker daemon socket (default: /var/run/docker.sock)
api_version?stringDocker API version (e.g. 1.43)
podman-engine
driverpodman.ts

podman-engine execution driver