Configure and create a cluster with the Amazon ParallelCluster UI
The Amazon ParallelCluster UI is a web-based user interface that mirrors the Amazon ParallelCluster
pcluster
CLI, while providing a console-like experience. You install and access
the Amazon ParallelCluster UI in your Amazon Web Services account. When you run it, the Amazon ParallelCluster UI accesses an instance of the
Amazon ParallelCluster API hosted on Amazon API Gateway in your Amazon Web Services account.
Note
The Amazon ParallelCluster UI wizard may not have UI options for all the supported features in the latest supported Amazon ParallelCluster version. You can manually edit the configuration file as needed or use the Amazon ParallelCluster CLI.
In this section, we guide you through configuring and creating a cluster by using the Amazon ParallelCluster UI.
Prerequisites:
-
Access to a running instance of Amazon ParallelCluster UI. For more information, see Installing the Amazon ParallelCluster UI.
Configure and create a cluster
-
In the Amazon ParallelCluster UI Clusters view, choose Create cluster, Step by step.
-
In Cluster, Name, enter a name for your cluster.
-
Choose a VPC with a public subnet for your cluster, and choose Next.
-
In Head node, choose Add SSM session, and choose Next.
-
In Queues, Compute resources, choose 1 for Static nodes.
-
For Instance type, remove the selected default instance type, choose t2.micro, and choose Next.
-
In Storage, choose Next.
-
In Cluster configuration, review the cluster configuration YAML and choose Dry run to validate it.
-
Choose Create to create your cluster, based on the validated configuration.
-
After a few seconds, the Amazon ParallelCluster UI automatically navigates you back to Clusters, where you can monitor the cluster create status and Stack events.
-
Choose Details to see cluster details, such as the version and status.
-
Choose Instances to see the list of Amazon EC2 instances and status.
-
Choose Stack events to view cluster stack events, and a Amazon Web Services Management Console link to the CloudFormation stack that creates the cluster.
-
In Details, after cluster creation completes, choose View YAML to view or download the cluster configuration YAML file.
-
After cluster creation completes, choose Shell to access the cluster head node.
Note
When you choose Shell, Amazon ParallelCluster opens an Amazon EC2 Systems Manager session and adds an
ssm-user
to/etc/sudoers
. For more information, see Turn on or turn offssm-user
account administrative permissions in the Amazon EC2 Systems Manager User Guide. -
To clean up, in the Clusters view, select the cluster, and choose Actions, Delete cluster.