NOVA CLI reference 0.5.0 GitHub
  1. nova

nova flow

Manage NovaFlow and its flows on the current cell

Synopsis

Manage NovaFlow on the configured cell ('nova config set cellname <name>').

NovaFlow composes robot behavior as flows (behavior trees) that a control plane executes. These commands install it on a cell, open its editor, and read, edit, write, delete, back up and restore flows.

Commands that need NovaFlow check that it runs on the cell. 'open', 'push' and 'backup restore' offer to install it when it is missing (use --yes to install without asking).

Custom actions for flows are Python services: create one with 'nova flow action create <name>'.

nova flow [flags]

Examples

# which cell, and does NovaFlow run there?
nova config view
nova flow status

# install it (or: answer yes when 'open', 'push' or 'backup restore' offer it)
nova flow install

# edit a flow in your editor ('nova config set editor "code --wait"'), saved when you close it
nova flow list
nova flow edit pick-and-place

# or as a file and save it back (fails if it changed on the instance meanwhile)
nova flow get pick-and-place -o pick-and-place.json
nova flow push pick-and-place.json --validate

# back up flows and globals, restore them on another cell
nova flow backup download
nova config set cellname other-cell
nova flow backup restore novaflow-backup.tar.gz

Options

  -h, --help   help for flow
  -y, --yes    Answer yes to questions, e.g. to install NovaFlow when it is missing

Options inherited from parent commands

      --debug                      Write diagnostic output to stderr: HTTP requests and responses, external commands, the resolved instance. Known secrets are redacted, but bodies (app environments, kubeconfigs) can still contain some: don't share the output unreviewed (env: NOVA_DEBUG=1)
      --env string                 (Wandelbots internal) Portal environment for this invocation: prod, stg or dev (default: the environment of the cloud instance, else of the last 'nova login'; env: NOVA_ENV)
      --insecure-skip-tls-verify   If true, the server's certificate will not be checked for validity (disables TLS verification for all requests)
      --instance string            Name of the instance to work against for this invocation (overrides the selected instance; env: NOVA_INSTANCE)

SEE ALSO