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

nova instance prune

Remove instances that no longer exist from the local list

Synopsis

Remove entries of instances that no longer exist from the local list.

Only a definite answer removes an entry: cloud the portal doesn't list the instance for the account logged in to the entry's environment (an instance of another account counts as gone) k8srun the cluster service doesn't know the cluster id, or has a kubeconfig with another CA for it than the stored one ('nova k8srun prune' also asks the cluster); never if the stored kubeconfig has more than one context (remove it explicitly) host never removed: an unreachable host can't be told apart from one that is off

Entries that can't be checked (no login for their environment, network error, any other answer) are kept, and the command fails so that scripts notice.

nova instance prune [flags]

Examples

$ nova instance prune --dry-run
$ nova instance prune

Options

      --dry-run         Only print the entries that would be removed
  -h, --help            help for prune
  -o, --output format   Output format: text or json (default text)

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