View a markdown version of this page

Trabajando con datos de usuario de Amazon EC2 para AWS PC - AWS PIEZAS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Trabajando con datos de usuario de Amazon EC2 para AWS PC

nota

Para la mayoría de las tareas de configuración de nodos, recomendamos realizar acciones durante el ciclo de vida de los nodos. Proporcionan una API-native configuración reutilizable con gestión de errores por script y control de reinicio. Utilice los datos de usuario de la plantilla de lanzamiento para las tareas que deben ejecutarse antes de que se inicie el agente AWS PCS. Para obtener más información, consulte Acciones del ciclo de vida del nodo.

Puede proporcionar los datos de usuario de EC2 en la plantilla de lanzamiento que cloud-init se ejecuta cuando se lanzan las instancias. Los bloques de datos de usuario con el tipo de contenido se cloud-config ejecutan antes de que la instancia se registre en la API de AWS PCS, mientras que los bloques de datos de usuario con el tipo de contenido se text/x‑shellscript ejecutan una vez finalizado el registro, pero antes de que se inicie el daemon de Slurm. Para obtener más información sobre los tipos de contenido, consulte la documentación de cloud-init.

Nuestros datos de usuario pueden utilizarse en escenarios de configuración comunes, entre los que se incluyen, entre otros, los siguientes:

Los datos de usuario de las plantillas de inicio deben estar en el formato de archivo https://cloudinit.readthedocs.io/en/latest/topics/format.html#mime-multi-part-archive MIME de varias partes. Esto se debe a que sus datos de usuario se combinan con otros datos de usuario de AWS PCS necesarios para configurar los nodos de su grupo de nodos. Puede combinar varios bloques de datos de usuario en un único archivo multiparte MIME.

Un archivo multiparte MIME consta de los siguientes componentes:

  • El tipo de contenido y declaración de límite de partes: Content-Type: multipart/mixed; boundary="==BOUNDARY=="

  • La declaración de versión de MIME: MIME-Version: 1.0

  • Uno o más bloques de datos de usuario, que contienen los siguientes componentes:

    • El límite de apertura, que señala el inicio de un bloque de datos de usuario: --==BOUNDARY==. Debe dejar en blanco la línea anterior a este límite.

    • La declaración del tipo de contenido del bloque: Content-Type: text/cloud-config; charset="us-ascii" oContent-Type: text/x-shellscript; charset="us-ascii". Debe dejar en blanco la línea que sigue a la declaración de tipo de contenido.

    • El contenido de los datos de usuario, por ejemplo, una lista de shell o políticas de cloud-config.

  • El límite de cierre, que señala el final del archivo multiparte MIME: --==BOUNDARY==--. Debe dejar en blanco la línea anterior al límite de cierre.

nota

Si añade datos de usuario a una plantilla de lanzamiento en la consola de Amazon EC2, puede pegarlos como texto sin formato. O bien, puede cargarlos desde un archivo. Si usa el SDK AWS CLI o un AWS SDK, primero debe codificar en base64 los datos del usuario y enviar esa cadena como el valor del UserData parámetro cuando llame CreateLaunchTemplate, tal y como se muestra en este archivo JSON.

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