EXPERIMENTAL: Interact with an Omniverse Nucleus server
Synopsis
EXPERIMENTAL: Commands for listing, copying, and removing files on an Omniverse Nucleus server.
Configuration: Nucleus servers are kept in their own list, independent of the NOVA instance. The commands work against the selected server, or the one named with --nucleus <name> / NOVA_NUCLEUS for a single invocation.
Add a server with its API token (read from stdin), list and select servers
nova nucleus server add dev --host nucleus.dev.wandelbots.io --token-stdin < token.txt nova nucleus server list nova nucleus server select dev
Or set host and token of the selected server
nova config set nucleus-host nucleus.dev.wandelbots.io nova config set nucleus-token <your-token>
--nucleus-host, --nucleus-token and the NUCLEUS_TOKEN environment variable override them for one invocation; the token of a server is never sent to another host. TLS is enabled by default and can be disabled with --nucleus-tls=false.
Verify your configuration with: nova nucleus server list
Usage examples: nova nucleus ls / nova nucleus ls -l /Projects/ nova nucleus cp ./Scene.usd n:/Projects/Scene.usd nova nucleus cp n:/Projects/Scene.usd ./local.usd nova nucleus mv /Projects/Old.usd /Projects/New.usd nova nucleus rm /Projects/Unused.usd nova nucleus mkdir /Projects/NewFolder/ nova nucleus stat /Projects/Scene.usd
nova nucleus [flags]
Options
-h, --help help for nucleus
--nucleus string Name of the Nucleus server for this invocation (overrides the selected one; env: NOVA_NUCLEUS)
--nucleus-host string Nucleus server host (overrides config)
--nucleus-tls Use TLS (wss://) (default true)
--nucleus-token string Nucleus API token (overrides NUCLEUS_TOKEN env)
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 nucleus cp - Copy files between local filesystem and Nucleus
- nova nucleus ls - List files and directories
- nova nucleus mkdir - Create a directory
- nova nucleus mv - Move or rename a file or directory
- nova nucleus rm - Remove a file or directory
- nova nucleus server - Manage the Nucleus servers the CLI knows
- nova nucleus stat - Show details about a file or directory