NOVA CLI reference 0.5.0 GitHub
  1. nova
  2. nova instance

nova instance keep-alive

Keep a cloud instance or k8srun cluster from expiring while you work with it

Synopsis

Keep a cloud instance or k8srun cluster from expiring while you or an agent work with it, like caffeinate does for a Mac. Extends the lifetime whenever less than --margin is left. If no name is given, the targeted instance is kept alive.

Without a command, runs until interrupted (Ctrl-C or SIGTERM). With a command after '--', runs it and keeps the instance alive until it exits; nova then exits with the command's exit code.

A stopped cloud instance is not started: the command waits until it runs again. Once the instance no longer exists, keep-alive stops (with a command, the command keeps running). Progress goes to stderr.

nova instance keep-alive [name] [-- command [args...]] [flags]

Examples

# keep the targeted instance alive until Ctrl-C
$ nova instance keep-alive

# keep it alive in the background of an agent session
$ nova instance keep-alive my-instance &

# keep it alive while a command runs
$ nova instance keep-alive -- claude
$ nova instance keep-alive my-cluster -- skaffold dev

Options

  -h, --help              help for keep-alive
      --margin duration   Extend the lifetime when less than this is left (default 15m0s)

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 instance - Manage the NOVA instances the CLI works against