Container Runtime
01README
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.
02Release Notes
New
- Podman driver — rootless container support
- Compose model —
up,down,scalefor multi-container stacks - Deploy workflow — pull images then start stack
- Container
inspectmethod
Fixed
- Docker driver now reconnects on socket timeout
03Models
@swampadmin/container-runtime/containerv1.0.0container.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| runtime? | string | Container runtime (docker, podman) |
fn run(image: string, env?: record, ports?: array)
run operation
| Argument | Type | Description |
|---|---|---|
| image | string | Container image reference |
| env? | record | Environment variables |
| ports? | array | Port mappings (host:container) |
fn stop(id: string, graceful?: boolean)
stop operation
| Argument | Type | Description |
|---|---|---|
| id | string | Instance identifier to stop |
| graceful? | boolean | Wait for in-flight requests to complete |
fn logs(id: string, tail?: number, follow?: boolean)
logs operation
| Argument | Type | Description |
|---|---|---|
| id | string | Container identifier |
| tail? | number | Number of lines from the end |
| follow? | boolean | Stream logs in real time |
fn exec(command: string, timeout?: number)
exec operation
| Argument | Type | Description |
|---|---|---|
| command | string | Command to execute |
| timeout? | number | Timeout in seconds |
fn inspect(id: string)
inspect operation
| Argument | Type | Description |
|---|---|---|
| id | string | Resource identifier |
Resources
container.state(persistent)— Managed resource state
container.lock(ephemeral)— Concurrency lock
@swampadmin/container-runtime/composev1.0.0compose.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| runtime? | string | Container runtime (docker, podman) |
fn up(name: string)
up operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
fn down(name: string)
down operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
fn scale(name: string)
scale operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
Files
compose.log(text/plain)— Operation audit log
compose.json(application/json)— Structured output
04Workflows
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
05Drivers
docker-engineconfigurable
driverdocker.ts
docker-engine execution driver
Config Fields
| Field | Type | Description |
|---|---|---|
| socket_path? | string | Docker daemon socket (default: /var/run/docker.sock) |
| api_version? | string | Docker API version (e.g. 1.43) |
podman-engine
driverpodman.ts
podman-engine execution driver
06Previous Versions
2025.12.01.0Feb 14, 2026
07Stats
Downloads
0
Archive size
125.0 KB
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
08Platforms
09Labels