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.

# Configurar la distribución de AMI con una plantilla de lanzamiento de EC2
<a name="dist-using-launch-template"></a>

Para garantizar una experiencia de lanzamiento uniforme para su AMI de Generador de Imágenes en las cuentas y regiones de destino, puede especificar una plantilla de lanzamiento de Amazon EC2 en sus ajustes de distribución mediante `launchTemplateConfigurations`. Cuando las `launchTemplateConfigurations` están presentes durante el proceso de distribución, Generador de Imágenes crea una nueva versión de la plantilla de lanzamiento que incluye todos los ajustes originales de la plantilla y el nuevo ID de AMI de la compilación. Para obtener más información sobre el lanzamiento de una instancia de EC2 con una plantilla de lanzamiento, consulte uno de los siguientes enlaces, en función del sistema operativo de destino.
+ [Lanzamiento de una instancia de Linux desde una plantilla de lanzamiento](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
+ [Lanzamiento de una instancia de Windows desde una plantilla de lanzamiento](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)

**nota**  
Si incluye una plantilla de lanzamiento para habilitar el lanzamiento rápido de Windows en la imagen, la plantilla de lanzamiento debe incluir la siguiente etiqueta para que Generador de imágenes pueda habilitar el lanzamiento rápido de Windows en su nombre.  
`CreatedBy: EC2 Image Builder`

## Añadir una plantilla de lanzamiento de EC2 a los ajustes de distribución de AMI de la consola
<a name="dist-using-launch-template-console"></a>

Para proporcionar una plantilla de lanzamiento con la AMI de salida, siga estos pasos en la consola:

1. Abra la consola [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)EC2 Image Builder en.

1. En el panel de navegación, seleccione **Ajustes de distribución**. Aquí se muestra una lista de los ajustes de distribución que se crean en su cuenta.

1. En la parte superior de la página **Ajustes de distribución**, seleccione **Crear ajustes de distribución**. Esto abre la página **Crear ajustes de distribución**.

1. En la sección **Tipo de imagen**, elija **Imagen de máquina de Amazon (AMI)** como **tipo de salida**. Esta es la configuración predeterminada.

1. En la sección **General**, ingrese el **nombre** del recurso de ajustes de distribución que desea crear (*obligatorio*).

1. En la sección **Ajustes de región**, seleccione el nombre de una plantilla de lanzamiento de EC2 de la lista. Si no hay plantillas de lanzamiento en su cuenta, seleccione **Crear nueva plantilla de lanzamiento**, lo que abrirá las **plantillas de lanzamiento** en el **Panel de control de EC2**.

   Seleccione la casilla de verificación **Establecer la versión predeterminada** para actualizar la versión predeterminada de la plantilla de lanzamiento a la nueva versión que Generador de Imágenes crea con la AMI de salida.

   Para añadir otra plantilla de lanzamiento a la región seleccionada, seleccione **Añadir configuración de plantilla de lanzamiento**.

   Para eliminar una plantilla de lanzamiento, seleccione **Eliminar**.

1. Continúe especificando cualquier configuración adicional que necesite y seleccione **Crear configuración** para crear su nuevo recurso de ajustes de distribución.

## Agregue una plantilla de lanzamiento de EC2 a la configuración de distribución de AMI desde el AWS CLI
<a name="dist-using-launch-template-cli"></a>

En esta sección se describe cómo configurar un archivo de ajustes de distribución con una plantilla de lanzamiento y cómo utilizar el comando **create-image** en la AWS CLI para crear y distribuir una AMI de Generador de Imágenes y una nueva versión de la plantilla de lanzamiento que la utilice.

1. 

**Configuración de un archivo de ajustes de distribución**

   Antes de poder crear una AMI de Image Builder con una plantilla de lanzamiento AWS CLI, debe crear una estructura JSON de configuración de distribución que especifique los `launchTemplateConfigurations` ajustes. Tiene que especificar al menos una entrada `launchTemplateConfigurations` en la región de origen.

   El siguiente archivo de ejemplo, denominado `create-distribution-config-launch-template.json`, muestra algunos escenarios posibles para la configuración de la plantilla de lanzamiento en la región de origen.

   ```
   {
       "name": "NewDistributionConfiguration",
       "description": "This is just a test",
       "distributions": [
           {
               "region": "us-west-2",
               "amiDistributionConfiguration": {
                   "name": "test-{{imagebuilder:buildDate}}-{{imagebuilder:buildVersion}}",
                   "description": "description"
               },
               "launchTemplateConfigurations": [
                   {
                       "launchTemplateId": "lt-0a1bcde2fgh34567",
                       "accountId": "935302948087",
                       "setDefaultVersion": true
                   },
                   {
                       "launchTemplateId": "lt-0aaa1bcde2ff3456"
                   },
                   {
                       "launchTemplateId": "lt-12345678901234567",
                       "accountId": "123456789012"
                   }
               ]
           }
       ],
       "clientToken": "clientToken1"
   }
   ```

1. 

**Creación de los ajustes de distribución**

   Para crear un recurso de configuración de distribución de Image Builder mediante el [create-distribution-configuration](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-distribution-configuration.html)comando del AWS CLI, proporcione los siguientes parámetros en el comando:
   + Ingrese el nombre de la distribución en el parámetro `--name`.
   + Adjunte el archivo JSON de configuración de distribución que creó en el parámetro `--cli-input-json`.

   ```
   aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.json
   ```
**nota**  
Debe incluir la notación `file://` al principio de la ruta del archivo JSON.
La ruta del archivo JSON debe seguir la convención apropiada para el sistema operativo base donde se está ejecutando el comando. Por ejemplo, Windows utiliza la barra diagonal inversa (\$1) para referirse a la ruta de directorios, mientras que Linux y macOS usan la barra diagonal (/).

*También puede proporcionar JSON directamente en el comando, mediante el parámetro `--distributions`.*