pcluster create-cluster
Creates an AWS ParallelCluster cluster.
pcluster create-cluster [-h] --cluster-configuration
CLUSTER_CONFIGURATION
--cluster-nameCLUSTER_NAME
[--debug] [--dryrunDRYRUN
] [--queryQUERY
] [--regionREGION
] [--rollback-on-failureROLLBACK_ON_FAILURE
] [--suppress-validatorsSUPPRESS_VALIDATORS
[SUPPRESS_VALIDATORS
...]] [--validation-failure-level {INFO
,WARNING
,ERROR
}]
Named arguments
-h, --help
-
Shows the help text for
pcluster create-cluster
. --cluster-configuration, -c
CLUSTER_CONFIGURATION
-
Specifies the YAML cluster configuration file.
--cluster-name, -n
CLUSTER_NAME
-
Specifies the name of the cluster to be created.
--debug
-
Enables debug logging.
--dryrun
DRYRUN
-
When
true
, the command performs validation without creating any resources. You can use this to validate the cluster configuration. (Defaults tofalse
.) --query
QUERY
-
Specifies the JMESPath query to perform on the output.
--region, -r
REGION
-
Specifies the AWS Region to use. The Region must be specified, using the Region setting in the cluster configuration file, the
AWS_DEFAULT_REGION
environment variable, theregion
setting in the[default]
section of the~/.aws/config
file, or the--region
parameter. --rollback-on-failure
ROLLBACK_ON_FAILURE
-
When
true
, automatically initiates a cluster stack rollback on failures. (Defaults totrue
.) --suppress-validators
SUPPRESS_VALIDATORS
[SUPPRESS_VALIDATORS
...]-
Identifies one or more config validators to suppress.
Format: (
ALL
|type:[A-Za-z0-9]+
) --validation-failure-level {
INFO
,WARNING
,ERROR
}-
Specifies the minimum validation level that will cause the creation to fail. (Defaults to
ERROR
.)
Example using AWS ParallelCluster version 3.1.4:
$
pcluster create-cluster -c
cluster-config.yaml
-ncluster-v3
{ "cluster": { "clusterName": "cluster-v3", "cloudformationStackStatus": "CREATE_IN_PROGRESS", "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh", "region": "us-east-1", "version": "3.1.4", "clusterStatus": "CREATE_IN_PROGRESS" } }