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

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 du AWS PCSAPI, 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 en MIME plusieurs parties. Cela est dû au fait que vos données utilisateur sont fusionnées avec d'autres données AWS PCS utilisateur 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 en MIME plusieurs parties.

Un fichier en MIME plusieurs parties comprend les éléments suivants :

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

  • La déclaration de MIME version : 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 en MIME 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 an 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 JSON fichier. 

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