pw cluster create

Create a cluster

Synopsis

The pw cluster create command creates a cluster record. Pass the full definition with --definition (a JSON or YAML file, or - for stdin) to create a ready-to-start cluster in one step, or --from to copy another cluster's definition and alerts, the way the web's Duplicate action does. Without either, the cluster is created empty and configured later with pw cluster definition set.

Names may only contain lowercase letters and digits; the name becomes the display name unless --display-name is given.

Pass --start to provision the cluster as soon as it is created; the -o and --wait flags then behave as in pw cluster start.

pw cluster create <name> [flags]

Examples

  pw cluster create --type aws-slurm --definition cluster.yaml --start myhpc
  
  # Copy an existing cluster's definition under a new name
  pw cluster create --from pw://Jake.Thayne/prodhpc myhpc
  
  # Create an empty Google cluster to configure later
  pw cluster create --type google-slurm --description "scratch" myhpc
  pw cluster definition get myhpc > def.json
  pw cluster definition set -f def.json myhpc
  
  # Register an existing (on-prem) cluster
  pw cluster create --type existing onprem

Options

      --definition string     JSON or YAML file with the cluster definition (- for stdin)
      --description string    Description
      --display-name string   Display name (defaults to the name)
      --from string           Cluster whose definition and alerts to copy
  -h, --help                  help for create
  -o, --output string         Output format (interactive, text, json); interactive opens the live view when --start is given (default "interactive")
      --start                 Provision the cluster once it is created
      --type string           Cluster type: aws-slurm, google-slurm, azure-slurm, oracle-slurm, openstack-slurm, existing (required unless --from is given)
      --wait                  With --start, wait for the cluster to be active before exiting

Options inherited from parent commands

      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Overrides PW_PLATFORM_HOST environment variable and the current context's server.
  -v, --verbose                Enable verbose logging

pw cluster create