View a markdown version of this page

[aws] section - Amazon ParallelCluster
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

This documentation references Amazon ParallelCluster. For running HPC and AI workloads, we recommend Amazon Parallel Computing Service (Amazon PCS), our managed Slurm service that lets you focus on running your workloads rather than managing infrastructure.

[aws] section

(Optional) Used to select the Amazon Web Services Region.

Cluster creation uses this priority order to select the Amazon Web Services Region for a new cluster:

  1. -r or --region parameter to pcluster create.

  2. AWS_DEFAULT_REGION environment variable.

  3. aws_region_name setting in [aws] section of Amazon ParallelCluster config file (default location is ~/.parallelcluster/config.) This is the location updated by the pcluster configure command.

  4. region setting in [default] section of Amazon CLI config file (~/.aws/config.)

Note

Before Amazon ParallelCluster version 2.10.0, these settings were required and applied to all clusters.

To store credentials, you can use the environment, IAM roles for Amazon EC2, or the Amazon CLI, rather than saving credentials into the Amazon ParallelCluster config file.

[aws]
aws_region_name = Region

Update policy: This setting is not analyzed during an update.