Creating a cluster with Amazon CloudFormation

1. Sign in to the Amazon Web Services Management Console.

2. Open the CloudFormation quick-create link to create the following resources in the CloudFormation console:

   • A nested CloudFormation stack with a VPC with a public and private subnet for running the cluster head node and compute nodes, respectively.

   • A nested CloudFormation stack with an Amazon ParallelCluster custom resource for managing the cluster.

   • A nested CloudFormation stack with the default policies for managing the cluster.

   • A root CloudFormation stack for the nested stacks.

   • An Amazon ParallelCluster cluster with the Slurm scheduler and a defined number of compute nodes.

   

3. In the Quick create stack Parameters section, enter values for the following parameters:

   1. For KeyName, enter the name of your EC2 key pair.

   2. For AvailabilityZone, choose an AZ for your cluster nodes, for example, us-east-1a.

4. Check the boxes to acknowledge each of the access capabilities at the bottom of the page.

5. Choose Create stack.

6. Wait for the CloudFormation stack to reach the CREATE_COMPLETE state.

1. Create a CloudFormation template named cluster_template.yaml with the following content:

   AWSTemplateFormatVersion: '2010-09-09'
   Description: >
     AmazonParallelCluster CloudFormation Template
   
   Parameters:
     KeyName:
       Description: KeyPair to login to the head node
       Type: AWS::EC2::KeyPair::KeyName
   
     AvailabilityZone:
       Description: Availability zone where instances will be launched
       Type: AWS::EC2::AvailabilityZone::Name
       Default: us-east-2a
   
   Mappings:
     ParallelCluster:
       Constants:
         Version: 3.7.0
   
   Resources:
     PclusterClusterProvider:
       Type: AWS::CloudFormation::Stack
       Properties:
         TemplateURL: !Sub
           - https://${AWS::Region}-aws-parallelcluster.s3.${AWS::Region}.${AWS::URLSuffix}/parallelcluster/${Version}/templates/custom_resource/cluster.yaml
           - { Version: !FindInMap [ParallelCluster, Constants, Version] }
   
     PclusterVpc:
       Type: AWS::CloudFormation::Stack
       Properties:
         Parameters:
           PublicCIDR: 10.0.0.0/24
           PrivateCIDR: 10.0.16.0/20
           AvailabilityZone: !Ref AvailabilityZone
         TemplateURL: !Sub
           - https://${AWS::Region}-aws-parallelcluster.s3.${AWS::Region}.${AWS::URLSuffix}/parallelcluster/${Version}/templates/networking/public-private-${Version}.cfn.json
           - { Version: !FindInMap [ParallelCluster, Constants, Version ] }
   
     PclusterCluster:
       Type: Custom::PclusterCluster
       Properties:
         ServiceToken: !GetAtt [ PclusterClusterProvider , Outputs.ServiceToken ]
         ClusterName: !Sub 'c-${AWS::StackName}'
         ClusterConfiguration:
           Image:
             Os: alinux2
           HeadNode:
             InstanceType: t2.medium
             Networking:
               SubnetId: !GetAtt [ PclusterVpc , Outputs.PublicSubnetId ]
             Ssh:
               KeyName: !Ref KeyName
           Scheduling:
             Scheduler: slurm
             SlurmQueues:
             - Name: queue0
               ComputeResources:
               - Name: queue0-cr0
                 InstanceType: t2.micro
               Networking:
                 SubnetIds:
                 -  !GetAtt [ PclusterVpc , Outputs.PrivateSubnetId ]
   Outputs:
     HeadNodeIp:
       Description: The Public IP address of the HeadNode
       Value: !GetAtt [ PclusterCluster, headNode.publicIpAddress ]

2. Run the following Amazon CLI command to deploy the CloudFormation stack for cluster creation and management.

   $ aws cloudformation deploy --template-file ./cluster_template.yaml \
     --stack-name mycluster \
     --parameter-overrides KeyName=keypair \
                           AvailabilityZone=us-east-2b \
     --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND

1. Navigate to the CloudFormation console and select the stack that includes your Amazon ParallelCluster custom resource.

2. Choose Stack details, and select the Outputs tab.

   

   Validation messages might be truncated. For more information about how to retrieve logs, see Amazon ParallelCluster troubleshooting.

ssh into the cluster head node

1. After the CloudFormation stack deployment is complete, obtain the IP address of the head node with the following command:

   $ HEAD_NODE_IP=$(aws cloudformation describe-stacks --stack-name=mycluster --query "Stacks|[0].Outputs[?OutputKey=='HeadNodeIp']|[0].OutputValue" --output=text)

   You can also retrieve the head node IP address from HeadNodeIp parameter in the cluster stack Outputs tab in the CloudFormation console.

   You can find the head node IP address here because it was added in the Outputs section of the cluster CloudFormation template, specifically for this example cluster.

2. Connect to the cluster head node by running the following command:

   $ ssh -i keyname.pem ec2-user@$HEAD_NODE_IP

1. Run the following Amazon CLI command to delete the CloudFormation stack and cluster.

   $ aws cloudformation delete-stack --stack-name=mycluster

2. Check the stack delete status by running the following command.

   $ aws cloudformation describe-stacks --stack-name=mycluster