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. # Umstellung von AWS ParallelCluster 2.x auf 3.x In den folgenden Abschnitten wird beschrieben, was passiert, wenn Sie von AWS ParallelCluster 2.x auf 3.x wechseln, einschließlich der Änderungen von einer Version zur anderen. ## Benutzerdefinierte Bootstrap-Aktionen Mit AWS ParallelCluster 3 können Sie verschiedene benutzerdefinierte Bootstrap-Aktionsskripts für den Hauptknoten und die Rechenknoten angeben, indem Sie Parameter `OnNodeStart` (`pre_install`in AWS ParallelCluster Version 2) und `OnNodeConfigured` (`post_install`in AWS ParallelCluster Version 2) in den Abschnitten [`HeadNode`](HeadNode-v3.md)und [`Scheduling`](Scheduling-v3.md)/[`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)verwenden. Weitere Informationen finden Sie unter [Benutzerdefinierte Bootstrap-Aktionen](custom-bootstrap-actions-v3.md). Skripte für benutzerdefinierte Bootstrap-Aktionen, die für AWS ParallelCluster 2 entwickelt wurden, müssen für die Verwendung in AWS ParallelCluster 3 angepasst werden: + Wir raten davon ab, Head Nodes `/etc/parallelcluster/cfnconfig` und Compute Nodes `cfn_node_type` zu verwenden und zwischen diesen zu unterscheiden. Stattdessen empfehlen wir, dass Sie in den Feldern [`HeadNode`](HeadNode-v3.md)und [`Scheduling`](Scheduling-v3.md)/zwei verschiedene Skripts angeben [`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues). + Wenn Sie das Laden `/etc/parallelcluster/cfnconfig` zur Verwendung in Ihrem Bootstrap-Aktionsskript fortsetzen möchten, beachten Sie, dass der `cfn_node_type` Wert von von "" auf MasterServer "HeadNode" geändert wurde (siehe:[Inklusive Sprache](#inclusive_language)). + Bei AWS ParallelCluster 2 war das erste Eingabeargument für Bootstrap-Aktionsskripte die S3-URL zum Skript und war reserviert. In AWS ParallelCluster 3 werden nur die in der Konfiguration konfigurierten Argumente an die Skripts übergeben. **Warnung** Die Verwendung interner Variablen, die über die `/etc/parallelcluster/cfnconfig` Datei bereitgestellt werden, wird nicht offiziell unterstützt. Diese Datei wird möglicherweise als Teil einer future Version entfernt. ## AWS ParallelCluster 2.x und 3.x verwenden unterschiedliche Syntax für Konfigurationsdateien ******** AWS ParallelCluster Die 3.x-Konfiguration verwendet die YAML-Syntax. Die vollständige Referenz finden Sie unter. [Konfigurationsdateien](configuration-v3.md) In Version AWS ParallelCluster 3.x ist nicht nur ein YAML-Dateiformat erforderlich, sondern auch eine Reihe von Konfigurationsabschnitten, Einstellungen und Parameterwerten wurden aktualisiert. In diesem Abschnitt finden Sie wichtige Änderungen an der AWS ParallelCluster Konfiguration sowie side-by-side Beispiele, die diese Unterschiede zwischen den einzelnen Versionen von veranschaulichen. AWS ParallelCluster **Beispiel für die Konfiguration mehrerer Scheduler-Warteschlangen mit aktiviertem und deaktiviertem Hyperthreading** AWS ParallelCluster 2: ``` [cluster default] queue_settings = ht-enabled, ht-disabled ... [queue ht-enabled] compute_resource_settings = ht-enabled-i1 disable_hyperthreading = false [queue ht-disabled] compute_resource_settings = ht-disabled-i1 disable_hyperthreading = true [compute_resource ht-enabled-i1] instance_type = c5n.18xlarge [compute_resource ht-disabled-i1] instance_type = c5.xlarge ``` AWS ParallelCluster 3: ``` ... Scheduling: Scheduler: slurm SlurmQueues: - Name: ht-enabled Networking: SubnetIds: - {{compute_subnet_id}} ComputeResources: - Name: ht-enabled-i1 DisableSimultaneousMultithreading: true InstanceType: c5n.18xlarge - Name: ht-disabled Networking: SubnetIds: - {{compute_subnet_id}} ComputeResources: - Name: ht-disabled-i1 DisableSimultaneousMultithreading: false InstanceType: c5.xlarge ``` **Beispiel für eine neue FSx Dateisystemkonfiguration für Lustre** AWS ParallelCluster 2: ``` [cluster default] fsx_settings = fsx ... [fsx fsx] shared_dir = /shared-fsx storage_capacity = 1200 imported_file_chunk_size = 1024 import_path = s3://{{amzn-s3-demo-bucket}} export_path = s3://{{amzn-s3-demo-bucket}}/export_dir weekly_maintenance_start_time = 3:02:30 deployment_type = PERSISTENT_1 data_compression_type = LZ4 ``` AWS ParallelCluster 3: ``` ... SharedStorage: - Name: fsx MountDir: /shared-fsx StorageType: FsxLustre FsxLustreSettings: StorageCapacity: 1200 ImportedFileChunkSize: 1024 ImportPath: s3://{{amzn-s3-demo-bucket}} ExportPath: s3://{{amzn-s3-demo-bucket}}/export_dir WeeklyMaintenanceStartTime: "3:02:30" DeploymentType: PERSISTENT_1 DataCompressionType: LZ4 ``` **Beispiel für eine Cluster-Konfiguration, die ein bestehendes Dateisystem FSx für Lustre mountet** AWS ParallelCluster 2: ``` [cluster default] fsx_settings = fsx ... [fsx fsx] shared_dir = /shared-fsx fsx_fs_id = {{fsx_fs_id}} ``` AWS ParallelCluster 3: ``` ... SharedStorage: - Name: fsx MountDir: /shared-fsx StorageType: FsxLustre FsxLustreSettings: FileSystemId: {{fsx_fs_id}} ``` **Beispiel für einen Cluster mit dem Software-Stack der Intel HPC Platform Specification** AWS ParallelCluster 2: ``` [cluster default] enable_intel_hpc_platform = true ... ``` AWS ParallelCluster 3: ``` ... AdditionalPackages: IntelSoftware: IntelHpcPlatform: true ``` Hinweise: + Die Installation der Software mit der Intel HPC-Plattformspezifikation unterliegt den Bedingungen der geltenden [Intel Endbenutzer-Lizenzvereinbarung](https://software.intel.com/en-us/articles/end-user-license-agreement). **Beispiel für benutzerdefinierte IAM-Konfigurationen, einschließlich: Instance-Profil, Instance-Rolle, zusätzliche Richtlinien für Instances und die Rolle für die Lambda-Funktionen, die mit dem Cluster verknüpft sind** AWS ParallelCluster 2: ``` [cluster default] additional_iam_policies = arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess,arn:aws:iam::aws:policy/AmazonDynamoDBReadOnlyAccess ec2_iam_role = {{ec2_iam_role}} iam_lambda_role = {{lambda_iam_role}} ... ``` AWS ParallelCluster 3: ``` ... Iam: Roles: CustomLambdaResources: {{lambda_iam_role}} HeadNode: ... Iam: InstanceRole: {{ec2_iam_role}} Scheduling: Scheduler: slurm SlurmQueues: - Name: queue1 ... Iam: InstanceProfile: {{iam_instance_profile}} - Name: queue2 ... Iam: AdditionalIamPolicies: - Policy: arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess - Policy: arn:aws:iam::aws:policy/AmazonDynamoDBReadOnlyAccess ``` Hinweise: + Bei AWS ParallelCluster 2 werden die IAM-Einstellungen auf alle Instanzen eines Clusters angewendet und `additional_iam_policies` können nicht zusammen mit `ec2_iam_role` verwendet werden. + Bei AWS ParallelCluster 3 können Sie unterschiedliche IAM-Einstellungen für Kopf- und Rechenknoten verwenden und sogar unterschiedliche IAM-Einstellungen für jede Rechenwarteschlange angeben. + Für AWS ParallelCluster 3 können Sie ein IAM-Instanzprofil als Alternative zu einer IAM-Rolle verwenden. `InstanceProfile`, `InstanceRole` oder `AdditionalIamPolicies` kann nicht zusammen konfiguriert werden. **Beispiel für benutzerdefinierte Bootstrap-Aktionen** AWS ParallelCluster 2: ``` [cluster default] s3_read_resource = arn:aws:s3:::{{amzn-s3-demo-bucket}}/* pre_install = s3://{{amzn-s3-demo-bucket}}/scripts/pre_install.sh pre_install_args = 'R curl wget' post_install = s3://{{amzn-s3-demo-bucket}}/scripts/post_install.sh post_install_args = "R curl wget" ... ``` AWS ParallelCluster 3: ``` ... HeadNode: ... CustomActions: OnNodeStart: Script: s3://{{amzn-s3-demo-bucket}}/scripts/pre_install.sh Args: - R - curl - wget OnNodeConfigured: Script: s3://{{amzn-s3-demo-bucket}}/scripts/post_install.sh Args: ['R', 'curl', 'wget'] Iam: S3Access: - BucketName: {{amzn-s3-demo-bucket}} Scheduling: Scheduler: slurm SlurmQueues: - Name: queue1 ... CustomActions: OnNodeStart: Script: s3://{{amzn-s3-demo-bucket}}/scripts/pre_install.sh Args: ['R', 'curl', 'wget'] OnNodeConfigured: Script: s3://{{amzn-s3-demo-bucket}}/scripts/post_install.sh Args: ['R', 'curl', 'wget'] Iam: S3Access: - BucketName: {{amzn-s3-demo-bucket}} ``` **Beispiel für einen Cluster mit Lese- und Schreibzugriff auf die S3-Bucket-Ressourcen** AWS ParallelCluster 2: ``` [cluster default] s3_read_resource = arn:aws:s3:::{{amzn-s3-demo-bucket}}/read_only/* s3_read_write_resource = arn:aws:s3:::{{amzn-s3-demo-bucket}}/read_and_write/* ... ``` AWS ParallelCluster 3: ``` ... HeadNode: ... Iam: S3Access: - BucketName: {{amzn-s3-demo-bucket}} KeyName: read_only/ EnableWriteAccess: False - BucketName: {{amzn-s3-demo-bucket}} KeyName: read_and_write/ EnableWriteAccess: True Scheduling: Scheduler: slurm SlurmQueues: - Name: queue1 ... Iam: S3Access: - BucketName: {{amzn-s3-demo-bucket}} KeyName: read_only/ EnableWriteAccess: False - BucketName: {{amzn-s3-demo-bucket}} KeyName: read_and_write/ EnableWriteAccess: True ``` ## Inklusive Sprache AWS ParallelCluster 3 verwendet die Wörter „Kopfknoten“ an Stellen, an denen „Master“ in AWS ParallelCluster 2 verwendet wurde. Diese umfasst die folgenden Funktionen: + Die in der AWS Batch Jobumgebung exportierte Variable wurde geändert: von `MASTER_IP` bis`PCLUSTER_HEAD_NODE_IP`. + Alle CloudFormation Ausgaben wurden von `Master*` bis geändert`HeadNode*`. + Alle NodeType und die Tags haben sich von `Master` bis geändert`HeadNode`. ## Scheduler-Unterstützung AWS ParallelCluster 3.x unterstützt Son of Grid Engine (SGE) und Torque Scheduler nicht. Die AWS Batch Befehle`awsbhosts`,`awsbkill`,`awsbout`, `awsbqueues``awsbstat`, und `awsbsub` werden als separates `aws-parallelcluster-awsbatch-cli` PyPI-Paket verteilt. Dieses Paket wird AWS ParallelCluster auf dem Hauptknoten installiert. Sie können diese AWS Batch Befehle weiterhin vom Hauptknoten des Clusters aus verwenden. Wenn Sie jedoch AWS Batch Befehle von einem anderen Ort als dem Hauptknoten aus verwenden möchten, müssen Sie zuerst das `aws-parallelcluster-awsbatch-cli` PyPI-Paket installieren. ## AWS ParallelCluster CLI Die AWS ParallelCluster Befehlszeilenschnittstelle (CLI) wurde geändert. Die neue Syntax wird unter beschrieben[AWS ParallelCluster CLI-Befehle](commands-v3.md). Das Ausgabeformat für die CLI ist eine [JSON-Zeichenfolge](https://json.org/). **Einen neuen Cluster konfigurieren** Der `pcluster configure` Befehl enthält in AWS ParallelCluster 3 andere Parameter als in AWS ParallelCluster 2. Weitere Informationen finden Sie unter [`pcluster configure`](pcluster.configure-v3.md). Beachten Sie auch, dass sich die Syntax der Konfigurationsdatei gegenüber AWS ParallelCluster 2 geändert hat. Eine vollständige Referenz der Cluster-Konfigurationseinstellungen finden Sie unter[Cluster-Konfigurationsdatei](cluster-configuration-file-v3.md). **Einen neuen Cluster erstellen** AWS ParallelCluster Der `pcluster create` Befehl von 2 wurde durch den [`pcluster create-cluster`](pcluster.create-cluster-v3.md)Befehl ersetzt. Beachten Sie, dass das Standardverhalten in AWS ParallelCluster 2.x ohne die `-nw` Option darin besteht, auf Ereignisse zur Clustererstellung zu warten, während der Befehl AWS ParallelCluster 3.x sofort zurückkehrt. Der Fortschritt der Clustererstellung kann mit überwacht werden. [`pcluster describe-cluster`](pcluster.describe-cluster-v3.md) Eine AWS ParallelCluster 3-Konfigurationsdatei enthält eine einzelne Clusterdefinition, sodass der `-t` Parameter nicht mehr benötigt wird. Im Folgenden finden Sie ein Beispiel für eine Konfigurationsdatei. ``` # AWS ParallelCluster v2 $ pcluster create \ -r {{REGION}} \ -c {{V2_CONFIG_FILE}} \ -nw \ -t {{CLUSTER_TEMPLATE}} \ {{CLUSTER_NAME}} # AWS ParallelCluster v3 $ pcluster create-cluster \ --region {{REGION}} \ --cluster-configuration {{V3_CONFIG_FILE}} \ --cluster-name {{CLUSTER_NAME}} ``` **Cluster auflisten** Der `pcluster list` AWS ParallelCluster 2.x-Befehl muss durch einen [`pcluster list-clusters`](pcluster.list-clusters-v3.md)Befehl ersetzt werden. Hinweis: Sie benötigen AWS ParallelCluster v2-CLI, um Cluster aufzulisten, die mit 2.x-Versionen von AWS ParallelCluster erstellt wurden. Informationen [Installieren AWS ParallelCluster in einer virtuellen Umgebung (empfohlen)](install-v3-virtual-environment.md) zur Installation mehrerer Versionen von Using Virtual Environments finden AWS ParallelCluster Sie unter. ``` # AWS ParallelCluster v2 $ pcluster list -r {{REGION}} # AWS ParallelCluster v3 $ pcluster list-clusters --region {{REGION}} ``` **Einen Cluster starten und stoppen** Die Befehle `pcluster start` und `pcluster stop` AWS ParallelCluster 2.x müssen durch [`pcluster update-compute-fleet`](pcluster.update-compute-fleet-v3.md)Befehle ersetzt werden. Eine Rechenflotte starten: ``` # AWS ParallelCluster v2 $ pcluster start \ -r {{REGION}} \ {{CLUSTER_NAME}} # AWS ParallelCluster v3 - Slurm fleets $ pcluster update-compute-fleet \ --region {{REGION}} \ --cluster-name {{CLUSTER_NAME}} \ --status {{START_REQUESTED}} # AWS ParallelCluster v3 - AWS Batch fleets $ pcluster update-compute-fleet \ --region {{REGION}} \ --cluster-name {{CLUSTER_NAME}} \ --status {{ENABLED}} ``` Stoppen einer Rechenflotte: ``` # AWS ParallelCluster v2 $ pcluster stop \ -r {{REGION}} \ {{CLUSTER_NAME}} # AWS ParallelCluster v3 - Slurm fleets $ pcluster update-compute-fleet \ --region {{REGION}} \ --cluster-name {{CLUSTER_NAME}} \ --status {{STOP_REQUESTED}} # AWS ParallelCluster v3 - AWS Batch fleets $ pcluster update-compute-fleet \ --region {{REGION}} \ --cluster-name {{CLUSTER_NAME}} \ --status {{DISABLED}} ``` **Verbindung zu einem Cluster herstellen** Der `pcluster ssh` AWS ParallelCluster 2.x-Befehl hat in AWS ParallelCluster 3.x unterschiedliche Parameternamen. Siehe [`pcluster ssh`](pcluster.ssh-v3.md). Verbindung zu einem Cluster herstellen: ``` # AWS ParallelCluster v2 $ pcluster ssh \ -r {{REGION}} \ {{CLUSTER_NAME}} \ -i {{~/.ssh/id_rsa}} # AWS ParallelCluster v3 $ pcluster ssh \ --region {{REGION}} \ --cluster-name {{CLUSTER_NAME}} \ -i {{~/.ssh/id_rsa}} ``` ## IMDS-Konfigurationsupdate Ab Version 3.0.0 AWS ParallelCluster wurde Unterstützung für die standardmäßige Beschränkung des Zugriffs auf das IMDS des Hauptknotens (und die Anmeldeinformationen für das Instanzprofil) auf eine Untergruppe von Superusern eingeführt. Weitere Informationen finden Sie unter [`Imds`-Eigenschaften](HeadNode-v3.md#HeadNode-v3-Imds.properties).