Class CmdStop

source code

stop [options] <cluster_tag> ...

Stop a running EBS-backed cluster

Example:

    $ starcluster stop mycluster

The above command will put all flat-rate EBS-backed nodes in 'mycluster'
into a 'stopped' state preserving the local disks. You can then use the
start command with the -x (--no-create) option to resume the cluster later
on without losing data on the local disks:

    $ starcluster start -x mycluster

This will 'start' all 'stopped' non-spot EBS-backed instances and
reconfigure the cluster.

In general, all nodes in the cluster must be 'stoppable' meaning all nodes
are backed by flat-rate EBS-backed instances. If any 'unstoppable' nodes
are found an error is raised. A node is 'unstoppable' if it is backed by
either a spot or S3-backed instance.

However, if the cluster contains a mix of 'stoppable' and 'unstoppable'
nodes you can stop all stoppable nodes and terminate any unstoppable nodes
using the --terminate-unstoppable (-t) option:

    $ starcluster stop --terminate-unstoppable mycluster

This will stop all nodes that can be stopped and terminate the rest.