Workloads

Overview

The oblien workloads command manages workloads (containers/processes) within workspaces including full CRUD, lifecycle control, and log/stats streaming.

Commands

Create Workload

oblien workloads create <ws-id> [flags]

Flag	Description
`--name <name>`	Workload name
`--image <image>`	Container image
`--cmd <command>`	Command to run
`--port <port>`	Exposed port
`--env <KEY=VAL,...>`	Comma-separated environment variables
`--max-log-size-mb <n>`	Maximum MiB per log file, 1–64; two files retained
`--log-retention-hours <n>`	Maximum retained age, 1–720 hours

List Workloads

oblien workloads list <ws-id> [--limit <n>]

Get Workload

oblien workloads get <ws-id> <wl-id>

Update Workload

oblien workloads update <ws-id> <wl-id> [--key value ...]
oblien workloads patch <ws-id> <wl-id> [--key value ...]

Both commands update the supplied fields and preserve unspecified settings.

Delete Workload

oblien workloads delete <ws-id> <wl-id>

Delete All Workloads

oblien workloads delete-all <ws-id>

Destructive operation — prompts for confirmation.

Start / Stop

oblien workloads start <ws-id> <wl-id>
oblien workloads stop <ws-id> <wl-id>

Status

oblien workloads status <ws-id> <wl-id>

Logs

oblien workloads logs <ws-id> <wl-id>
oblien workloads logs <ws-id> <wl-id> --stream
oblien workloads logs <ws-id> <wl-id> --config
oblien workloads logs <ws-id> <wl-id> --clear

With --stream, logs are streamed in real-time.

--config shows the applied retention and stored size. --clear deletes retained logs without stopping the workload. Logs default to two 10 MiB files and up to 7 days. These flags require a CLI release containing log controls and an updated workspace agent; the REST endpoints are also available.

Stats

oblien workloads stats <ws-id> <wl-id>
oblien workloads stats <ws-id> <wl-id> --stream

With --stream, resource stats are streamed as NDJSON.

Examples

oblien workloads create ws_abc123 --name web --image nginx --port 80
oblien workloads list ws_abc123
oblien workloads start ws_abc123 wl_def456
oblien workloads logs ws_abc123 wl_def456 --stream
oblien workloads stats ws_abc123 wl_def456 --stream
oblien workloads delete ws_abc123 wl_def456

On this page