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: delonix workload [OPTIONS] <COMMAND>

Commands:
  rm        Remove a workload by name
  stop      Stop a workload by name (routed to the owning backend)
  describe  Describe a workload by name (routed to the owning backend, kubectl-style)
  ls        List all workloads — containers AND VMs — in one table (or `-o json`)
  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 (see a summary with '-h')

COMMAND MAP:
  Lifecycle  stop · rm
  Inspect    ls · describe

EXAMPLES:
  # containers AND VMs in one table, so you stop guessing which group owns
  # what
  delonix workload ls

  # stop something by name — routed to whichever backend owns it
  delonix workload stop web

SEE ALSO:
  delonix workload ls · delonix container ps · delonix vm ls · delonix stack
  apply

  delonix › workload

`workload ls`

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

Usage: delonix 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]

  -n, --namespace <NAMESPACE>
          Show only the workloads of this isolation namespace. Omit to list every one

  -h, --help
          Print help (see a summary with '-h')

EXAMPLES:
  # every workload of the node — containers and VMs — in a single table
  delonix workload ls

  # as JSON, with stable field names, for automation
  delonix workload ls -o json

SEE ALSO:
  delonix workload describe · delonix container ps · delonix vm ls

  delonix › workload › ls

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).

Exact-name routing, fail-closed: a name that doesn't exist gives no such workload; a container AND a vm with the same name give ambiguous (points at the specific command, never guesses).

ExemplosExamples

Containers E VMs numa só tabela

Containers AND VMs in one table

delonix workload ls

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

Structured output for automation (stable keys, language-independent)

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

`workload describe`

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

Usage: delonix 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 (see a summary with '-h')

EXAMPLES:
  # the details of a workload, routed to the backend that owns the name
  delonix workload describe web

SEE ALSO:
  delonix workload ls · delonix container describe · delonix describe

  delonix › workload › describe

ExemplosExamples

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

Workload detail, auto-routed to the right engine

delonix workload describe web

`workload stop`

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

Usage: delonix 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 (see a summary with '-h')

EXAMPLES:
  # stop by exact name, container or VM — a name owned by both is refused,
  # never guessed
  delonix workload stop web

SEE ALSO:
  delonix workload rm · delonix workload ls · delonix container stop

  delonix › workload › stop

ExemplosExamples

Parar por nome, seja container ou vm

Stop by name, whether container or vm

delonix workload stop web

`workload rm`

Remove a workload by name

Usage: delonix 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 (see a summary with '-h')

EXAMPLES:
  # remove a workload by name, whichever backend holds it
  delonix workload rm web

  # force it even if it is still running or the backend cleanup refuses
  delonix workload rm -f web

SEE ALSO:
  delonix workload stop · delonix workload ls · delonix container rm

  delonix › workload › rm

ExemplosExamples

Remover por nome

Remove by name

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.