nodus shell

nodus shell

Open an interactive shell in a Sandbox, creating it if it is not there

Synopsis

shell opens a terminal in a Sandbox. A name that does not exist yet is created from the same flags as nodus create sandbox (image nodus/agent-tools unless –image says otherwise), and the Sandbox stays after the shell exits, so the next nodus shell finds /workspace as you left it; –rm deletes a Sandbox this command created when the shell exits. Without a name the shell gets a Sandbox of its own, which is deleted when it exits unless –keep is set. The command after – replaces bash.

nodus shell [sandbox/NAME] [flags] [-- COMMAND...]

Examples

  nodus shell sandbox/dev
  nodus shell sandbox/dev --cpu 4 --memory 8Gi
  nodus shell sandbox/dev --rm
  nodus shell
  nodus shell sandbox/dev -- zsh

Options

      --cpu string            vCPU floor
      --disk string           Disk floor, such as 50Gi
      --gpu string            Accelerator TYPE[:COUNT], such as L4 or H100:8
  -h, --help                  help for shell
      --idle-timeout string   Stop after this idle time
      --image string          Container image (default "nodus/agent-tools")
      --keep                  Without a name: keep the Sandbox after the shell exits
      --max-cost string       Spend limit in USD
      --memory string         Memory floor, such as 16Gi
      --rm                    Delete the Sandbox when the shell exits (only one this command created)
      --secret stringArray    Secret to mount (repeatable)

Options inherited from parent commands

      --context string   Context from the config file to use
      --org string       Organization (selects the context for that org)
  -p, --project string   Project to work in
  -v, --verbose          Log each API request (never credentials)

SEE ALSO

• nodus - Run compute Jobs on Nodus

Tested examples

These invocations run in CI against the CLI’s fake API.

nodus shell sandbox/lab
nodus shell sandbox/lab -- zsh
nodus shell sandbox/scratch --rm
nodus shell