pcluster delete
Deletes a cluster.
pcluster delete [ -h ] [ -c
CONFIG_FILE
] [ -rREGION
] [ -nw ]cluster_name
Positional arguments
cluster_name
-
Specifies the name of the cluster to delete.
Named arguments
-h, --help
-
Shows the help text for
pcluster delete
. -c
CONFIG_FILE
, --configCONFIG_FILE
-
Specifies the alternative configuration file to use.
Defaults to
~/.parallelcluster/config
. --keep-logs
-
Keep the CloudWatch Logs data after deleting the cluster. The log group remains until you delete it manually, but the log events expire based on the retention_days setting. The setting defaults to 14 days.
Note
Support for the
argument was added in Amazon ParallelCluster version 2.6.0.--keep-logs
-r
REGION
, --regionREGION
-
Specifies the Amazon Web Services Region to use. Defaults to the Amazon Web Services Region specified by using the pcluster configure command.
When the command is called and begins polling for the status of that call, it's safe to use "Ctrl-C" to exit.
You can return to viewing the current status by calling pcluster status mycluster
.
Example using Amazon ParallelCluster version 2.11.7:
$
pcluster delete -c
path/to/config
-rus-east-1
mycluster
Deleting: mycluster Status: RootRole - DELETE_COMPLETE Cluster deleted successfully.
To delete the network resources in the VPC, you can delete the CloudFormation networking stack. The stack name starts with "parallelclusternetworking-" and contains the creation time in "YYYYMMDDHHMMSS" format. You can list the stacks using the list-stacks command.
$
aws --region
us-east-1
cloudformation list-stacks \ --stack-status-filter "CREATE_COMPLETE" \ --query "StackSummaries[].StackName" | \ grep -e "parallelclusternetworking-""parallelclusternetworking-pubpriv-20191029205804"
The stack can be deleted using the delete-stack command.
$
aws --region
us-east-1
cloudformation delete-stack \ --stack-nameparallelclusternetworking-pubpriv-20191029205804
The VPC that pcluster configure creates for you is not created in the CloudFormation networking stack. You can delete that VPC manually in the console or by using the Amazon CLI.
$
aws --region
us-east-1
ec2 delete-vpc --vpc-idvpc-0b4ad9c4678d3c7ad