View a markdown version of this page

Utilisation des données utilisateur Amazon EC2 pour AWS PIÈCES - AWS PIÈCES

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.

Utilisation des données utilisateur Amazon EC2 pour AWS PIÈCES

Note

Pour la plupart des tâches de configuration des nœuds, nous recommandons des actions relatives au cycle de vie des nœuds. Ils fournissent une API-native configuration réutilisable avec gestion des erreurs par script et contrôle du redémarrage. Utilisez les données utilisateur du modèle de lancement pour les tâches qui doivent être exécutées avant le démarrage de l'agent AWS PCS. Pour de plus amples informations, veuillez consulter Actions du cycle de vie des nœuds.

Vous pouvez fournir des données utilisateur EC2 dans votre modèle de lancement qui cloud-init s'exécute au lancement de vos instances. Les blocs de données utilisateur avec le type de contenu sont cloud-config exécutés avant l'enregistrement de l'instance auprès de l'API AWS PCS, tandis que les blocs de données utilisateur avec le type de contenu sont text/x‑shellscript exécutés une fois l'enregistrement terminé, mais avant le démarrage du démon Slurm. Pour plus d'informations sur les types de contenus, consultez la documentation sur Cloud-Init.

Nos données utilisateur peuvent exécuter des scénarios de configuration courants, y compris, mais sans s'y limiter, les suivants :

Les données utilisateur des modèles de lancement doivent être au format d'archive https://cloudinit.readthedocs.io/en/latest/topics/format.html#mime-multi-part-archive MIME en plusieurs parties. Cela est dû au fait que vos données utilisateur sont fusionnées avec d'autres données utilisateur AWS PCS qui sont nécessaires pour configurer les nœuds de votre groupe de nœuds. Vous pouvez combiner plusieurs blocs de données utilisateur dans un seul fichier MIME multi-part.

Un fichier MIME multi-part est constitué des composants suivants :

  • Le type de contenu et la déclaration de limite : Content-Type: multipart/mixed; boundary="==BOUNDARY=="

  • La déclaration de version MIME : MIME-Version: 1.0

  • Un ou plusieurs blocs de données utilisateur contenant les composants suivants :

    • La limite d'ouverture qui signale le début d'un bloc de données utilisateur :--==BOUNDARY==. Vous devez laisser la ligne avant cette limite vide.

    • Déclaration du type de contenu pour le bloc : Content-Type: text/cloud-config; charset="us-ascii" ouContent-Type: text/x-shellscript; charset="us-ascii". Vous devez laisser la ligne qui suit la déclaration du type de contenu vide.

    • Le contenu des données utilisateur, telles qu'une liste de commandes ou de cloud-config directives shell.

  • La limite de fermeture qui signale la fin du fichier MIME en plusieurs parties :. --==BOUNDARY==-- Vous devez laisser la ligne avant la limite de fermeture vide.

Note

Si vous ajoutez des données utilisateur à un modèle de lancement dans la console Amazon EC2, vous pouvez les coller en texte brut. Vous pouvez également le télécharger à partir d'un fichier. Si vous utilisez le AWS CLI ou un AWS SDK, vous devez d'abord encoder les données utilisateur en base64 et soumettre cette chaîne comme valeur du UserData paramètre lorsque vous appelez CreateLaunchTemplate, comme indiqué dans ce fichier JSON. 

{
    "LaunchTemplateName": "base64-user-data",
    "LaunchTemplateData": {
        "UserData": "ewogICAgIkxhdW5jaFRlbXBsYXRlTmFtZSI6ICJpbmNyZWFzZS1jb250YWluZXItdm9sdW..."
    }
}
Exemples