Ejemplos para crear y administrar plantillas de lanzamiento con la AWS CLI

Puede crear y administrar plantillas de lanzamiento a través de Consola de administración de AWS, la AWS Command Line Interface (AWS CLI) o los SDK. En esta sección se muestran ejemplos de creación y administración de plantillas de lanzamiento para Amazon EC2 Auto Scaling desde AWS CLI.

Ejemplo de uso

{
    "LaunchTemplateName": "my-template-for-auto-scaling",
    "VersionDescription": "test description",
    "LaunchTemplateData": {
        "ImageId": "ami-04d5cc9b88example",
        "InstanceType": "t2.micro",
        "SecurityGroupIds": [
            "sg-903004f88example"
        ], 
        "KeyName": "MyKeyPair",
        "Monitoring": {
            "Enabled": true
        },
        "Placement": {
            "Tenancy": "dedicated"
        },
        "CreditSpecification": {
            "CpuCredits": "unlimited"
        },
        "MetadataOptions": {
            "HttpTokens": "required",
            "HttpPutResponseHopLimit": 1,
            "HttpEndpoint": "enabled"
        }
    }
}

Creación de una plantilla de lanzamiento básica

Para crear una plantilla de lanzamiento básica, utilice el comando create-launch-template de la siguiente manera, con estas modificaciones:

En este ejemplo se crea una plantilla de lanzamiento con el nombre my-template for-auto-scaling. Si las instancias creadas por esta plantilla de inicio se inician en una VPC predeterminada, recibirán una dirección IP pública de forma predeterminada. Si las instancias se lanzan en una VPC no predeterminada, no reciben una dirección IP pública de forma predeterminada.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Para obtener más información acerca de cómo citar parámetros con formato JSON, consulte Uso de comillas con cadenas en AWS CLI en la Guía del usuario de AWS Command Line Interface.

Si lo desea, también puede especificar los parámetros con formato JSON en un archivo de configuración.

En el ejemplo siguiente se crea una plantilla de lanzamiento básica, que hace referencia a un archivo de configuración para los valores de parámetro de plantilla de lanzamiento.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data file://config.json

Contenido de config.json:

{ 
    "ImageId":"ami-04d5cc9b88example",
    "InstanceType":"t2.micro"
}

Especificar etiquetas que etiquetan instancias en el lanzamiento

En el siguiente ejemplo se agrega una etiqueta (por ejemplo, purpose=webserver) a instancias en el lanzamiento.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"purpose","Value":"webserver"}]}],"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Especificar un rol de IAM para transferir a instancias

En el ejemplo siguiente se especifica el nombre del perfil de instancia asociado con el rol de IAM que se va a transferir a las instancias en el lanzamiento. Para obtener más información, consulte Rol de IAM para aplicaciones que se ejecuten en instancias de Amazon EC2.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
--launch-template-data '{"IamInstanceProfile":{"Name":"my-instance-profile"},"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Asignación de direcciones IP públicas

El ejemplo siguiente create-launch-template configura una plantilla de lanzamiento para asignar direcciones públicas a instancias lanzadas en una VPC no predeterminada.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"NetworkInterfaces":[{"DeviceIndex":0,"AssociatePublicIpAddress":true,"Groups":["sg-903004f88example"],"DeleteOnTermination":true}],"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Especificar un script de datos de usuario que configura instancias en el lanzamiento

En el ejemplo siguiente se especifica una secuencia de comandos de datos de usuario como una cadena codificada en base64 que configura instancias en el momento del lanzamiento. El comando create-launch-template requiere datos de usuario codificados en base64.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
--launch-template-data '{"UserData":"IyEvYmluL2Jhc...","ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Especificar una asignación de dispositivos de bloques

El ejemplo siguiente create-launch-template crea una plantilla de lanzamiento con una asignación de dispositivos de bloques: un volumen EBS cifrado de 22 gigabytes asignado a /dev/xvdcz. El volumen /dev/xvdcz utiliza el tipo de volumen SSD de uso general (gp2) y se elimina al finalizar la instancia a la que está adjunta.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"BlockDeviceMappings":[{"DeviceName":"/dev/xvdcz","Ebs":{"VolumeSize":22,"VolumeType":"gp2","DeleteOnTermination":true}}],"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Especificar hosts dedicados para traer licencias de software de proveedores externos

Si especifica la tenencia de host, puede especificar un grupo de recursos de host y una configuración de licencias de License Manager para traer licencias de software elegibles de proveedores externos. A continuación, puede utilizar las licencias en instancias EC2 mediante el siguiente comando create-launch-template.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"Placement":{"Tenancy":"host","HostResourceGroupArn":"arn"},"LicenseSpecifications":[{"LicenseConfigurationArn":"arn"}],"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Especificar una interfaz de red existente

El siguiente ejemplo create-launch-template configura la interfaz de red principal para que utilice una interfaz de red existente.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"NetworkInterfaces":[{"DeviceIndex":0,"NetworkInterfaceId":"eni-b9a5ac93","DeleteOnTermination":false}],"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Creación de múltiples interfaces de red

El siguiente ejemplo create-launch-template agrega una interfaz de red secundaria. La interfaz de red principal tiene un índice de dispositivo de 0 y la interfaz de red secundaria tiene un índice de dispositivo de 1.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"NetworkInterfaces":[{"DeviceIndex":0,"Groups":["sg-903004f88example"],"DeleteOnTermination":true},{"DeviceIndex":1,"Groups":["sg-903004f88example"],"DeleteOnTermination":true}],"ImageId":"ami-04d5cc9b88example","InstanceType":"t2.micro"}'

Si utiliza un tipo de instancia que admita varias tarjetas de red y Elastic Fabric Adapters (EFA), puede agregar una interfaz secundaria a una tarjeta de red secundaria y habilitar EFA mediante el siguiente comando create-launch-template. Para obtener más información, consulte Agregar un EFA a una plantilla de lanzamiento en la Guía del usuario de Amazon EC2.

aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
  --launch-template-data '{"NetworkInterfaces":[{"NetworkCardIndex":0,"DeviceIndex":0,"Groups":["sg-7c2270198example"],"InterfaceType":"efa","DeleteOnTermination":true},{"NetworkCardIndex":1,"DeviceIndex":1,"Groups":["sg-7c2270198example"],"InterfaceType":"efa","DeleteOnTermination":true}],"ImageId":"ami-09d95fab7fexample","InstanceType":"p4d.24xlarge"}'

Administración de las plantillas de lanzamiento

La AWS CLI incluye otros comandos que le ayudan a administrar sus plantillas de lanzamiento.

Enumeración y descripción de las plantillas de lanzamiento

Puede utilizar dos comandos de AWS CLI para obtener información sobre las plantillas de lanzamiento: describe-launch-templates y describe-launch-template-versions.

El comando describe-launch-templates le permite obtener una lista de cualquiera de las plantillas de lanzamiento que ha creado. Puede utilizar una opción para filtrar los resultados en un nombre de plantilla de lanzamiento, crear tiempo, clave de etiqueta o combinación clave-valor de etiqueta. Este comando devuelve información resumida sobre cualquiera de sus plantillas de lanzamiento, incluido el identificador de plantilla de lanzamiento, la versión más reciente y la versión predeterminada.

En el ejemplo siguiente se proporciona un resumen de la plantilla de lanzamiento especificada.

aws ec2 describe-launch-templates --launch-template-names my-template-for-auto-scaling

A continuación, se muestra un ejemplo de respuesta.

{
    "LaunchTemplates": [
        {
            "LaunchTemplateId": "lt-068f72b729example",
            "LaunchTemplateName": "my-template-for-auto-scaling",
            "CreateTime": "2020-02-28T19:52:27.000Z",
            "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
            "DefaultVersionNumber": 1,
            "LatestVersionNumber": 1
        }
    ]
}

Si no utiliza --launch-template-names para limitar la salida a una plantilla de lanzamiento, se devuelve información sobre todas las plantillas de lanzamiento.

El siguiente comando describe-launch-template-versions proporciona información que describe las versiones de la plantilla de lanzamiento especificada.

aws ec2 describe-launch-template-versions --launch-template-id lt-068f72b729example

A continuación, se muestra un ejemplo de respuesta.

{
    "LaunchTemplateVersions": [
        {
            "VersionDescription": "version1",
            "LaunchTemplateId": "lt-068f72b729example",
            "LaunchTemplateName": "my-template-for-auto-scaling",
            "VersionNumber": 1,
            "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
            "LaunchTemplateData": {
                "TagSpecifications": [
                    {
                        "ResourceType": "instance",
                        "Tags": [
                            {
                                "Key": "purpose",
                                "Value": "webserver"
                            }
                        ]
                    }
                ],
                "ImageId": "ami-04d5cc9b88example",
                "InstanceType": "t2.micro",
                "NetworkInterfaces": [
                    {
                        "DeviceIndex": 0,
                        "DeleteOnTermination": true,
                        "Groups": [
                            "sg-903004f88example"
                        ],
                        "AssociatePublicIpAddress": true
                    }
                ]
            },
            "DefaultVersion": true,
            "CreateTime": "2020-02-28T19:52:27.000Z"
        }
    ]
}

Crear una versión de plantilla de inicialización

El siguiente comando create-launch-template crea una nueva versión de plantilla de lanzamiento basada en la versión 1 de la plantilla de lanzamiento y especifica otro ID de AMI.

aws ec2 create-launch-template-version --launch-template-id lt-068f72b729example --version-description version2 \
  --source-version 1 --launch-template-data "ImageId=ami-c998b6b2example"

Para establecer la versión predeterminada de la plantilla de lanzamiento, utilice el comando modificy-launch-template.

Eliminar una versión de plantilla de inicialización

El siguiente comando delete-launch-template-versions elimina la versión especificada de una plantilla de lanzamiento.

aws ec2 delete-launch-template-versions --launch-template-id lt-068f72b729example --versions 1

Eliminación de una plantilla de inicialización

Si ya no necesita una plantilla de lanzamiento, puede eliminarla mediante el siguiente comando delete launch-template. Al eliminar una plantilla de inicialización, también se eliminan todas sus versiones.

aws ec2 delete-launch-template --launch-template-id lt-068f72b729example

Actualización de un grupo de Auto Scaling para utilizar una plantilla de lanzamiento

Puede utilizar el coamdo update-auto-scaling-group para agregar una plantilla de lanzamiento a un grupo de Auto Scaling existente.

Actualización de un grupo de Auto Scaling para utilizar la versión más reciente de una plantilla de lanzamiento

El siguiente comando update-auto-scaling-group actualiza el grupo de Auto Scaling especificado para utilizar la última versión de la plantilla de lanzamiento especificada.

aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-asg \
  --launch-template LaunchTemplateId=lt-068f72b729example,Version='$Latest'

Actualización de un grupo de Auto Scaling para utilizar una versión específica de una plantilla de lanzamiento

El siguiente comando update-auto-scaling-group actualiza el grupo de Auto Scaling especificado para utilizar una versión específica de la plantilla de lanzamiento especificada.

aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-asg \
  --launch-template LaunchTemplateName=my-template-for-auto-scaling,Version='2'