Cluster configuration file

AWS ParallelCluster version 3 uses separate configuration files to control the definition of cluster infrastructure and the definition of custom AMIs. All configuration files use YAML 1.1 files. Detailed information for each of these configuration files is linked below. For some example configurations, see https://github.com/aws/aws-parallelcluster/tree/release-3.0/cli/tests/pcluster/example_configs.

These objects are used for the AWS ParallelCluster version 3 cluster configuration.

Topics

• Cluster configuration file properties
• Imds section
• Image section
• HeadNode section
• Scheduling section
• SharedStorage section
• Iam section
• LoginNodes section
• Monitoring section
• Tags section
• AdditionalPackages section
• DirectoryService section
• DeploymentSettings section

Cluster configuration file properties

Region (Optional, String)

Specifies the AWS Region for the cluster. For example, us-east-2.

Update policy: If this setting is changed, the update is not allowed.

CustomS3Bucket (Optional, String)

Specifies the name of an Amazon S3 bucket that's created in your AWS account to store resources that are used by your clusters, such as the cluster configuration file. AWS ParallelCluster maintains one Amazon S3 bucket in each AWS Region that you create clusters in. By default, these Amazon S3 buckets are named parallelcluster-hash-v1-DO-NOT-DELETE.

Update policy: If this setting is changed, the update is not allowed. If you force the update, the new value will be ignored and the old value will be used.

AdditionalResources (Optional, String)

Defines an additional AWS CloudFormation template to launch along with the cluster. This additional template is used for creating resources that are outside of the cluster but are part of the cluster's lifecycle.

The value must be an HTTPS URL to a public template, with all parameters provided.

There is no default value.

Update policy: This setting can be changed during an update.