delonix workload

Camada unificada sobre containers E VMs: ls, describe, stop, rm (ADR-0002).

Unified layer over containers AND VMs: ls, describe, stop, rm (ADR-0002).

O grupo workload é o lado imperativo do Runtime Abstraction Layer: um trait ComputeDriver despacha por nome para o motor de containers ou de VMs, para geres os dois como uma coisa só. A criação é declarativa — kind: Workload num manifesto (spec.type: container|vm|pod|microvm) baixa para o Kind respectivo no manifest::load; ver Kinds e examples/workload.yaml.

The workload group is the imperative side of the Runtime Abstraction Layer: a ComputeDriver trait dispatches by name to either the container or the VM engine, so you can manage both as one thing. Creation stays declarative — a kind: Workload in a manifest (spec.type: container|vm|pod|microvm) lowers to the matching Kind in manifest::load; see Kinds and examples/workload.yaml.

📄 Implementação real em Rust: cmd/workload.rs

Usage: dlx workload [OPTIONS] <COMMAND>

Commands:
  ls        List all workloads — containers AND VMs — in one table (or `-o json`)
  describe  Describe a workload by name (routed to the owning backend, kubectl-style)
  stop      Stop a workload by name (routed to the owning backend)
  rm        Remove a workload by name
  help      Print this message or the help of the given subcommand(s)

Options:
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -h, --help          Print help

`workload ls`

List all workloads — containers AND VMs — in one table (or -o json)

Usage: dlx workload ls [OPTIONS]

Options:
      --l18n <en|pt>     Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -o, --output <OUTPUT>  Output format: `table` (default, human) or `json` (machine, stable field names — see ADR-0005). `-o json | jq` is the automation path [default: table] [possible values: table, json]
  -h, --help             Print help

Routing por nome exacto, fail-closed: um nome inexistente dá no such workload; um container E uma vm com o mesmo nome dão ambiguous (aponta para o comando específico, nunca adivinha).

Exemplos

Containers E VMs numa só tabela

delonix workload ls

Saída estruturada para automação (chaves estáveis, independentes de língua)

delonix workload ls -o json | jq '.[] | select(.type=="vm")'

`workload describe`

Describe a workload by name (routed to the owning backend, kubectl-style)

Usage: dlx workload describe [OPTIONS] <NAME>

Arguments:
  <NAME>  Workload name

Options:
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -h, --help          Print help

Exemplos

Detalhe do workload, com routing automático para o motor certo

delonix workload describe web

`workload stop`

Stop a workload by name (routed to the owning backend)

Usage: dlx workload stop [OPTIONS] <NAME>

Arguments:
  <NAME>  Workload name

Options:
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -h, --help          Print help

Exemplos

Parar por nome, seja container ou vm

delonix workload stop web

`workload rm`

Remove a workload by name

Usage: dlx workload rm [OPTIONS] <NAME>

Arguments:
  <NAME>  Workload name

Options:
  -f, --force         Force removal even if running / if backend cleanup refuses
      --l18n <en|pt>  Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
  -h, --help          Print help

Exemplos

Remover por nome

delonix workload rm -f web

LaboratórioLab

Cria um container normal e observa-o pela lente unificada — o mesmo workload que também sabe falar de VMs.

delonix container run -d --name api nginx
delonix workload ls
delonix workload describe api
delonix workload stop api

Create a plain container and look at it through the unified lens — the same workload group that also knows how to talk about VMs.

delonix container run -d --name api nginx
delonix workload ls
delonix workload describe api
delonix workload stop api

DesafioChallenge

Cria um container E uma VM com o MESMO nome e chama workload describe <nome> — confirma que o comando recusa por ambiguidade em vez de adivinhar qual dos dois querias, e que a mensagem aponta para o comando específico.

Create a container AND a VM with the SAME name and call workload describe <name> — confirm the command refuses for ambiguity instead of guessing which of the two you meant, and that the message points at the specific command.