

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Einen Cluster erstellen mit CloudFormation
<a name="tutorials_09_cfn-custom-resource-v3"></a>

Erfahren Sie, wie Sie einen Cluster mit einer AWS ParallelCluster CloudFormation benutzerdefinierten Ressource erstellen. Weitere Informationen finden Sie unter [AWS CloudFormation benutzerdefinierte Ressource](cloudformation-v3.md).

Bei der Nutzung AWS ParallelCluster zahlen Sie nur für die AWS Ressourcen, die beim Erstellen oder Aktualisieren von AWS ParallelCluster Images und Clustern erstellt werden. Weitere Informationen finden Sie unter [AWS Dienste verwendet von AWS ParallelCluster](aws-services-v3.md).

**Voraussetzungen:**
+ Das AWS CLI [ist installiert und konfiguriert.](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)
+ Ein [Amazon EC2 EC2-Schlüsselpaar](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html).
+ Eine IAM-Rolle mit den [Berechtigungen, die für](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-example-user-policies) die Ausführung der [`pcluster`](pcluster-v3.md) CLI erforderlich sind.

## Clustererstellung mit einem CloudFormation Schnellerstellungsstapel
<a name="cfn-custom-resource-quick-v3"></a>

In diesem Tutorial verwenden Sie einen Schnellerstellungsstapel, um eine CloudFormation Vorlage bereitzustellen, die einen Cluster und die folgenden Ressourcen erstellt: AWS 
+ Ein CloudFormation Root-Stack, der mithilfe eines CloudFormation Schnellerstellungsstapels erstellt wurde.
+ Verschachtelte CloudFormation Stacks, die Standardrichtlinien, eine Standard-VPC-Einrichtung und einen benutzerdefinierten Ressourcenanbieter enthalten.
+ Ein Beispiel für einen AWS ParallelCluster Cluster-Stack und einen Cluster, bei dem Sie sich anmelden und Jobs ausführen können.

**Erstellen Sie einen Cluster mit AWS CloudFormation**

1. Melden Sie sich bei der an AWS-Managementkonsole.

1. Öffnen Sie den [Link zur CloudFormation Schnellerstellung](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?stackName=mycluster&templateURL=https://us-east-1-aws-parallelcluster.s3.amazonaws.com/parallelcluster/3.15.0/templates/1-click/cluster-example.yaml), um die folgenden Ressourcen in der CloudFormation Konsole zu erstellen:
   + Ein verschachtelter CloudFormation Stack mit einer VPC mit einem öffentlichen und einem privaten Subnetz für den Betrieb des Cluster-Kopfknotens bzw. der Rechenknoten.
   + Ein verschachtelter CloudFormation Stack mit einer AWS ParallelCluster benutzerdefinierten Ressource für die Verwaltung des Clusters.
   + Ein verschachtelter CloudFormation Stack mit den Standardrichtlinien für die Verwaltung des Clusters.
   + Ein CloudFormation Root-Stack für die verschachtelten Stacks.
   + Ein AWS ParallelCluster Cluster mit dem Slurm Scheduler und einer definierten Anzahl von Rechenknoten.  
![\[Die CloudFormation schnell zu erstellende Benutzeroberfläche der Konsole.\]](http://docs.aws.amazon.com/de_de/parallelcluster/latest/ug/images/cfn-quick-create.png)

1. Geben Sie im Abschnitt ****Stack-Parameter** für die Schnellerstellung** Werte für die folgenden Parameter ein:

   1. Geben Sie für **KeyName**den Namen Ihres Amazon EC2 EC2-Schlüsselpaars key pair.

   1. Wählen Sie für **AvailabilityZone**eine AZ für Ihre Clusterknoten, zum Beispiel. `us-east-1a`

1. Markieren Sie die Kästchen, um die einzelnen Zugriffsmöglichkeiten unten auf der Seite zu bestätigen.

1. Wählen Sie **Stack erstellen** aus.

1. Warten Sie, bis der CloudFormation Stack den `CREATE_COMPLETE` Status erreicht hat.

## Clustererstellung mit der CloudFormation Befehlszeilenschnittstelle (CLI)
<a name="cfn-custom-resource-cli-v3"></a>

In diesem Tutorial verwenden Sie die AWS Befehlszeilenschnittstelle (CLI) CloudFormation , um eine CloudFormation Vorlage bereitzustellen, die einen Cluster erstellt.

**Erstellen Sie die folgenden AWS Ressourcen:**
+ Ein CloudFormation Root-Stack, der mithilfe eines CloudFormation Schnellerstellungsstapels erstellt wurde.
+ Verschachtelte CloudFormation Stacks, die Standardrichtlinien, Standard-VPC-Setup und einen benutzerdefinierten Ressourcenanbieter enthalten.
+ Ein Beispiel für einen AWS ParallelCluster Cluster-Stack und einen Cluster, bei dem Sie sich anmelden und Jobs ausführen können.

Ersetzen Sie *inputs highlighted in red* z. *keypair* B. durch Ihre eigenen Werte.

**Erstellen Sie einen Cluster mit AWS CloudFormation**

1. Erstellen Sie eine CloudFormation Vorlage `cluster_template.yaml` mit dem folgenden Namen:

   ```
   AWSTemplateFormatVersion: '2010-09-09'
   Description: > AWS ParallelCluster 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.15.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 ]
   ```

1. Führen Sie den folgenden AWS CLI-Befehl aus, um den CloudFormation Stack für die Clustererstellung und -verwaltung bereitzustellen.

   ```
   $ 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
   ```

## CloudFormation Cluster-Ausgabe anzeigen
<a name="cfn-custom-resource-view-v3"></a>

Sehen Sie sich die CloudFormation Cluster-Ausgabe an, um nützliche Cluster-Details zu erhalten. Die hinzugefügte `ValidationMessages` Eigenschaft ermöglicht den Zugriff auf Bestätigungsmeldungen aus Clustererstellungs- und -aktualisierungsvorgängen.

1. Navigieren Sie zur [CloudFormation Konsole](https://console.aws.amazon.com/cloudformation/home) und wählen Sie den Stack aus, der Ihre AWS ParallelCluster benutzerdefinierte Ressource enthält.

1. Wählen Sie **Stack-Details** und dann die Registerkarte **Ausgaben** aus.  
![\[Die Konsole CloudFormation gibt eine Tabelle mit Werten für HeadNodeIp und aus ValidationMessages.\]](http://docs.aws.amazon.com/de_de/parallelcluster/latest/ug/images/cfn-outputs.png)

   Bestätigungsnachrichten werden möglicherweise gekürzt. Weitere Informationen zum Abrufen von Protokollen finden Sie unter[AWS ParallelCluster Problembehandlung](troubleshooting-v3.md).

## Greifen Sie auf Ihren Cluster zu
<a name="cfn-custom-resource-access-v3"></a>

Greifen Sie auf den Cluster zu.

**`ssh`in den Cluster-Kopfknoten**

1. Rufen Sie nach Abschluss der CloudFormation Stack-Bereitstellung die IP-Adresse des Hauptknotens mit dem folgenden Befehl ab:

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

   Sie können die IP-Adresse des Hauptknotens auch über den **HeadNodeIp**Parameter auf der Registerkarte **Cluster-Stack-Ausgaben** in der CloudFormation Konsole abrufen.

   Die IP-Adresse des Hauptknotens finden Sie hier, da sie im `Outputs` Abschnitt der CloudFormation Clustervorlage speziell für diesen Beispielcluster hinzugefügt wurde.

1. Connect zum Cluster-Kopfknoten her, indem Sie den folgenden Befehl ausführen:

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

## Bereinigen
<a name="cfn-custom-resource-cleanup-v3"></a>

Löschen Sie den Cluster.

1. Führen Sie den folgenden AWS CLI-Befehl aus, um den CloudFormation Stack und den Cluster zu löschen.

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

1. Überprüfen Sie den Status des Stack-Löschvorgangs, indem Sie den folgenden Befehl ausführen.

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