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
- nova - CLI for interacting with Wandelbots NOVA OS
- nova instance add - Registers a reachable NOVA host (e.g. an on-prem IPC) as instance
- nova instance create - Creates a new cloud instance
- nova instance delete - Deletes a cloud instance
- nova instance env - Prints shell commands that point this shell to an instance
- nova instance extend - Extend the lifetime of a cloud instance or k8srun cluster
- nova instance info - Show information about an instance
- nova instance keep-alive - Keep a cloud instance or k8srun cluster from expiring while you work with it
- nova instance kubeconfig - Prints the path of the instance's kubeconfig, fetching it over ssh for hosts
- nova instance list - Lists all instances
- nova instance prune - Remove instances that no longer exist from the local list
- nova instance remove - Removes an instance from the local list (does not delete it)
- nova instance select - Selects the instance commands work against
- nova instance start - Start a suspended or stopped cloud instance
- nova instance stop - Stop a running cloud instance