View a markdown version of this page

AWS ParallelCluster Personnalisation de l'AMI - AWS ParallelCluster

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS ParallelCluster Personnalisation de l'AMI

Dans certains scénarios, il AWS ParallelCluster est nécessaire de créer une AMI personnalisée pour. Cette section décrit les éléments à prendre en compte lors de la création d'une AWS ParallelCluster AMI personnalisée.

Vous pouvez créer une AWS ParallelCluster AMI personnalisée à l'aide de l'une des méthodes suivantes :

  1. Créez un fichier de configuration d'image de génération, puis utilisez l'pclusterinterface de ligne de commande pour créer l'image avec EC2 Image Builder. Ce processus est automatisé, reproductible et prend en charge la surveillance. Pour plus d'informations, consultez les commandes relatives à pcluster l'image.

  2. Créez une instance à partir d'une AWS ParallelCluster AMI, puis connectez-vous à celle-ci et apportez des modifications manuelles. Enfin, utilisez Amazon EC2 pour créer une nouvelle AMI à partir de l'instance modifiée. Ce processus prend moins de temps. Cependant, il n'est ni automatisé ni reproductible, et il ne prend pas en charge l'utilisation des commandes de surveillance des images de la pcluster CLI.

Pour plus d'informations sur ces méthodes, consultezCréation d'une version personnalisée AWS ParallelCluster AMI.

AWS ParallelCluster Considérations relatives à la personnalisation de

Quelle que soit la manière dont vous créez votre image personnalisée, nous vous recommandons d'effectuer des tests de validation préliminaires et d'inclure des dispositions pour surveiller l'état de l'image en cours de création.

Pour créer une AMI personnalisée à l'aide depcluster, vous créez un fichier de configuration d'image de génération avec une Image section Build et qu'EC2 Image Builder utilise pour créer votre image personnalisée. La Build section indique ce dont Image Builder a besoin pour créer l'image. Cela inclut ParentImage (image de base) et Components. Un composant Image Builder définit une séquence d'étapes nécessaires pour personnaliser une instance avant la création d'une image ou pour tester une instance lancée par l'image créée. Pour plus d'informations, voir Création d'un composant personnalisé avec Image Builder dans le guide de l'utilisateur d'EC2 Image Builder.

Lorsqu'il est appelé depuis pcluster build-image pour créer une image personnalisée, Image Builder utilise la configuration de l'image de génération avec le AWS ParallelCluster livre de recettes pour démarrer sur votre. AWS ParallelCluster ParentImage Image Builder télécharge les composants, exécute les phases de génération et de validation, crée l'AMI, lance une instance à partir de l'AMI et exécute des tests. Une fois le processus terminé, Image Builder produit une nouvelle image ou un message d'arrêt.

Réaliser des tests de validation de composants personnalisés

Avant d'inclure un composant Image Builder dans une configuration, testez-le et validez-le à l'aide de l'une des méthodes suivantes. Le processus Image Builder pouvant prendre jusqu'à 1 heure, nous vous recommandons de tester les composants au préalable. Cela peut vous faire gagner un temps considérable.

Étui à script

Testez le script dans une instance en cours d'exécution, en dehors du processus de création de l'image, et vérifiez que le script se termine avec le code de sortie 0.

Étui Amazon Resource Name (ARN)

Testez le document du composant dans une instance en cours d'exécution, en dehors du processus de création de l'image. Pour obtenir la liste des exigences, consultez la section Gestionnaire de composants dans le guide de l'utilisateur d'Image Builder.

Une fois la validation réussie, ajoutez le composant à la configuration de votre image de construction

Après avoir vérifié que le composant personnalisé fonctionne, ajoutez-le au fichier de configuration de Build image.

Surveillez le processus Image Builder à l'aide des commandes pcluster pour faciliter le débogage

describe-image

Utilisez cette commande pour surveiller l'état de l'image de génération.

list-image-log-streams

Utilisez cette commande pour obtenir les ID des flux de journaux que vous pouvez utiliser pour récupérer les événements de journal get-image-log-events.

get-image-log-events

Utilisez cette commande pour obtenir le flux de journalisation des événements du processus de génération d'images.

Par exemple, vous pouvez exécuter la commande suivante pour générer des événements d'image.

$ watch -n 1 'pcluster get-image-log-events -i <image-id> \ --log-stream-name/1 <pcluster-version> \ --query "events[*].message" | tail -n 50'

get-image-stack-events

Utilisez cette commande pour récupérer les événements de pile d'images pour la pile créée par Image Builder.

export-image-logs

Utilisez cette commande pour enregistrer les journaux d'images.

Pour plus d'informations sur AWS ParallelCluster les journaux et Amazon CloudWatch, consultez Amazon CloudWatch Logs crée des journaux d'images etTableau de CloudWatch bord Amazon.

Autres considérations

Nouvelles AWS ParallelCluster versions et AMI personnalisées

Si vous créez et utilisez une AMI personnalisée, vous devez répéter les étapes que vous avez utilisées pour créer votre AMI personnalisée à chaque nouvelle AWS ParallelCluster version.

Actions de bootstrap personnalisées

Consultez Actions de bootstrap personnalisées cette section pour déterminer si les modifications que vous souhaitez apporter peuvent être scriptées et prises en charge dans les prochaines AWS ParallelCluster versions.

Utilisation d'AMI personnalisées

Vous pouvez spécifier des AMI personnalisées dans la configuration du cluster dans les CustomAmi sections Image Scheduling SlurmQueues/CustomAmiet Name/Image/-/.

Pour résoudre les problèmes liés aux avertissements de validation d'AMI personnalisés, consultezRésolution des problèmes liés à l'AMI personnalisée.