NOVA CLI reference 0.5.0 GitHub
  1. nova

nova instance

Manage the NOVA instances the CLI works against

Synopsis

Manage the NOVA instances the CLI works against.

The CLI keeps a local list of named instances. Each has a kind: cloud an instance on portal.wandelbots.io (create, start, stop, delete via this command) host any reachable NOVA host, e.g. an on-prem IPC (register with 'nova instance add') k8srun a Wandelbots-internal Kubernetes cluster with a kubeconfig (see 'nova k8srun')

Commands work against the selected instance ('nova instance select'). Override it for a single invocation with the global --instance <name> flag or the NOVA_INSTANCE environment variable; neither changes the selection. Settings such as host, cellname, nucleus-host and nucleus-token are stored per instance.

nova instance [flags]

Examples

# register an on-prem instance and select it
$ nova instance add lab --host 192.168.1.10 --cell line1
$ nova instance select lab

# list all instances, '*' marks the selected one
$ nova instance list

# run a single command against another instance
$ nova --instance my-cloud-instance app list
$ NOVA_INSTANCE=lab nova cell list

Options

  -h, --help   help for instance

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