Utilisation des données EC2 utilisateur d'Amazon - AWS PC

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 EC2 utilisateur d'Amazon

Vous pouvez fournir des données EC2 utilisateur dans votre modèle de lancement qui cloud-init s'exécute lors du lancement de vos instances. Les blocs de données utilisateur avec le type de contenu cloud-config s'exécutent avant que l'instance ne s'enregistre auprès de l'API AWS PCS, tandis que les blocs de données utilisateur avec le type de contenu text/x‑shellscript s'exécutent 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 figurant dans les modèles de lancement doivent être au format d'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 requises 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 indique le début d'un bloc de données utilisateur :--==BOUNDARY==. Vous devez laisser la ligne avant cette limite vide.

    • La 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 après la déclaration de type de contenu vide.

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

  • La limite de fermeture qui indique 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 EC2 console Amazon, vous pouvez les coller sous forme de 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 envoyer 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