

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.

# Uso de una actualización de instancias para actualizar instancias en un grupo de escalado automático
<a name="asg-instance-refresh"></a>

Puede utilizar una actualización de instancias para actualizar las instancias del grupo de escalado automático. Esta función puede resultar útil cuando un cambio de configuración requiere que reemplace las instancias o sus volúmenes raíz, especialmente si su grupo de Auto Scaling contiene una gran cantidad de instancias. 

Algunas situaciones en las que una actualización de instancias puede ayudar son las siguientes:
+ Implementación de una nueva imagen de máquina de Amazon (AMI) o script de datos de usuario en todo el grupo de escalado automático. Puede crear una nueva plantilla de lanzamiento con los cambios y, a continuación, utilizar una actualización de instancias para implementar las actualizaciones de forma inmediata.
+ Migración de instancias a nuevos tipos de instancias para aprovechar las últimas mejoras y optimizaciones.
+ Cambio en los grupos de escalado automático para que pasen de utilizar una configuración de lanzamiento a una plantilla de lanzamiento. Puede copiar las configuraciones de lanzamiento en las plantillas de lanzamiento y, a continuación, utilizar una actualización de instancias para actualizar las instancias a las nuevas plantillas. Para obtener más información acerca de la migración a plantillas de lanzamiento, consulte [Migración de sus grupos de escalado automático a plantillas de lanzamiento](migrate-to-launch-templates.md).
+ Aplica parches de seguridad o actualizaciones de software y, al mismo tiempo, preserva el estado de ejecución prolongado de las instancias y evita las restricciones de capacidad con tipos de instancias especializados, como las instancias de GPU o Mac.

**Topics**
+ [Cómo funciona una actualización de instancias](instance-refresh-overview.md)
+ [Comprensión de los valores predeterminados](understand-instance-refresh-default-values.md)
+ [Inicio de una actualización de instancias](start-instance-refresh.md)
+ [Supervise la actualización de una instancia](check-status-instance-refresh.md)
+ [Sustituya los volúmenes raíz](replace-root-volume.md)
+ [Cancelación de una actualización de instancias](cancel-instance-refresh.md)
+ [Inversión de cambios con una reversión](instance-refresh-rollback.md)
+ [Uso de la omisión de coincidencias](asg-instance-refresh-skip-matching.md)
+ [Incorporación de puntos de comprobación](asg-adding-checkpoints-instance-refresh.md)

# Funcionamiento de una actualización de instancias en un grupo de escalado automático
<a name="instance-refresh-overview"></a>

En este tema, se describe cómo funciona una actualización de instancias y se introducen los conceptos clave que necesita conocer para utilizarla de forma eficaz.

**Topics**
+ [Funcionamiento](#instance-refresh-how-it-works)
+ [Conceptos clave](#instance-refresh-core-concepts)
+ [Periodo de gracia de la comprobación de estado](#instance-refresh-health-check-grace-period)
+ [Compatibilidad de los tipos de instancias](#instance-type-compatibility)
+ [Limitaciones](#instance-refresh-limitations)

## Funcionamiento
<a name="instance-refresh-how-it-works"></a>

Para actualizar las instancias de un grupo de escalado automático, puede definir una nueva configuración que contenga la última versión de la aplicación y cualquier otra actualización que desee realizar. 

La actualización de instancias admite dos estrategias para actualizar las instancias:
+ **Estrategia continua (predeterminada)**: finaliza las instancias y lanza otras nuevas en lotes según sus preferencias. Esto garantiza que su grupo de Auto Scaling mantenga la capacidad y disponibilidad deseadas durante todo el proceso de actualización.
+ **Estrategia de reemplazo del volumen raíz**: actualiza las instancias reemplazando solo el volumen raíz sin terminar la instancia. Esto preserva las interfaces de red de las instancias, los volúmenes de EBS que no son raíz y los datos del almacén de instancias.

Requisitos para la estrategia de reemplazo del volumen raíz:
+ Su grupo de Auto Scaling debe usar una política de instancias mixtas
+ Todas las anulaciones de la política de instancias mixtas deben especificar una `ImageId` 
+ AMIs debe contener solo un volumen raíz
+ Todas las instancias deben coincidir con la configuración de la plantilla de lanzamiento del grupo
+ Debe iniciar la actualización de la instancia con la configuración deseada que tenga una política de instancias mixtas que contenga `ImageId` anulaciones.

Cuando la opción Omitir coincidencia está habilitada, Auto Scaling compara la ID de AMI actual de cada instancia con IDs la AMI de la configuración deseada. Solo reemplaza las instancias en las que la AMI IDs no coincide, lo que le permite omitir las instancias que ya están actualizadas.

### Realice una actualización de instancias
<a name="instance-refresh-process"></a>

Inicia una actualización de instancias para reemplazar las instancias existentes por otras nuevas en función de esa configuración.

1. Cree una nueva plantilla de lanzamiento o actualice la existente con los cambios de configuración deseados, como una nueva imagen de máquina de Amazon (AMI). Para obtener más información, consulte [Creación de una plantilla de lanzamiento para un grupo de Auto Scaling](create-launch-template.md).

1. Inicie la actualización de la instancia mediante la consola AWS CLI Amazon EC2 Auto Scaling o el SDK:
   + Especifique la nueva plantilla de lanzamiento o versión de la plantilla de lanzamiento que ha creado. Se utilizará para lanzar nuevas instancias.
   + Establezca los porcentajes de buen estado mínimo y máximo. Esto controla cuántas instancias se reemplazan simultáneamente y si se lanzan nuevas instancias antes de terminar las antiguas. 
   + Configure los ajustes opcionales, como los siguientes:
     + **Puntos de control**: pausa la actualización de la instancia después de un porcentaje determinado de reemplazos para comprobar el progreso.
     + **Tiempo de incorporación**: haga una pausa al final de la actualización de una instancia para validar el estado de la instancia antes de que se dé por finalizada su actualización.
     + **Omitir la coincidencia**: compara las instancias antiguas con la nueva configuración y reemplaza solo las que no coincidan. Al iniciar una actualización de instancias desde la consola, la omisión de coincidencias está activada de forma predeterminada.
     + **Tipos de instancias múltiples**: aplique una [política de instancias mixtas](ec2-auto-scaling-mixed-instances-groups.md) nueva o actualizada como parte de la configuración deseada.

Cuando se haya iniciado la actualización de instancias, Amazon EC2 Auto Scaling hará lo siguiente:
+ Reemplazar las instancias en lotes en función de los porcentajes de buen estado mínimo y máximo. 
+ Lanzar primero las instancias nuevas antes de terminar las antiguas si el porcentaje de buen estado mínimo está establecido en 100 por ciento. Esto garantiza que la capacidad deseada se mantenga en todo momento.
+ Compruebe el estado de las instancias y espere a que se calienten antes de reemplazar más instancias. 
+ Termine y reemplace las instancias que no estén en buen estado.
+ Actualice automáticamente la configuración del grupo de escalado automático con los nuevos cambios de configuración una vez que la actualización de la instancia se haya realizado correctamente.
+ Sustituya las instancias `InService` antes de las que estén en un pool caliente.

El siguiente diagrama de flujo ilustra el comportamiento que ocurre si se lanzan instancias antes de terminarlas cuando se establece el porcentaje de buen estado mínimo en 100 por ciento. 

![\[Un diagrama que muestra cómo funciona la actualización de una instancia cuando el porcentaje de buen estado está establecido en 100 por ciento.\]](http://docs.aws.amazon.com/es_es/autoscaling/ec2/userguide/images/instance-refresh-high-level-flowchart-diagram.png)


**nota**  
Es necesario especificar los porcentajes de estado máximos para una actualización de instancias solo si no ha establecido una política de mantenimiento de instancias o si necesita anular una ya existente. Para obtener más información, consulte [Políticas de mantenimiento de instancias](ec2-auto-scaling-instance-maintenance-policy.md).  
Del mismo modo, solo necesita especificar el período de preparación de instancias para una actualización de instancias solo si no ha habilitado a preparación predeterminada o si necesita anular la configuración predeterminada. Para obtener más información, consulte [Establecimiento de la preparación predeterminada de instancias para un grupo de escalado automático](ec2-auto-scaling-default-instance-warmup.md).

## Conceptos clave
<a name="instance-refresh-core-concepts"></a>

Antes de empezar, familiarícese con los siguientes conceptos principales de actualización de instancias:

**Porcentaje de buen estado mínimo**  
El *porcentaje de buen estado mínimo* es el porcentaje de la capacidad que se desea mantener en servicio, en buen estado y lista para usar durante una actualización de instancias, de modo que esta pueda continuar. Por ejemplo, si el porcentaje de buen estado mínimo es del 90 por ciento y el porcentaje máximo en buen estado‭ es del 100 por ciento, se reemplazará el 10 por ciento de capacidad por vez. Si las nuevas instancias no superan las comprobaciones de estado, Amazon EC2 Auto Scaling las finaliza y reemplaza. Si la actualización de instancias no puede lanzar ninguna instancia en buen estado, la actualización de instancias acabará fallando y el 90 por ciento restante del grupo permanecerá intacto. Si las nuevas instancias se mantienen en buen estado y completan el periodo de preparación, Amazon EC2 Auto Scaling podrá seguir reemplazando otras instancias.  
Una actualización de instancias puede reemplazar las instancias de una en una, varias a la vez o todas a la vez. Para reemplazar una instancia de una en una, establezca el porcentaje mínimo y máximo en buen estado en el 100 por ciento. Esto cambia el comportamiento de la actualización de instancias para lanzarla antes de su finalización, lo que evita que la capacidad del grupo caiga por debajo del 100 por ciento de la capacidad deseada. Para reemplazar todas las instancias a la vez, establezca el porcentaje de buen estado mínimo en el 0 por ciento. 

**Porcentaje máximo en buen estado**  
El *porcentaje máximo en buen estado‭* de estado es el porcentaje de la capacidad deseada al que su grupo de escalado automático puede aumentar al reemplazar instancias. La diferencia entre el mínimo y el máximo no puede ser superior a 100. Un rango mayor aumenta la cantidad de instancias que se pueden reemplazar al mismo tiempo.

**Preparación de las instancias**  
La *preparación de las instancias* es el periodo de tiempo desde que el estado de una nueva instancia cambia a `InService` hasta que se considera que ha finalizado la inicialización. Durante la actualización de instancias, en caso de que estas superen las comprobaciones de estado, Amazon EC2 Auto Scaling no procede inmediatamente a reemplazar la siguiente instancia tras determinar que una instancia recién lanzada está en buen estado. Espera durante el periodo de preparación antes de pasar a reemplazar otras instancias. Esto puede resultar útil cuando la aplicación aún necesita algo de tiempo de inicialización antes de que pueda responder a las solicitudes.  
La preparación de instancias funciona de la misma manera que la preparación de instancias predeterminada. Por lo tanto, se aplican las mismas consideraciones de escalado. Para obtener más información, consulte [Establecimiento de la preparación predeterminada de instancias para un grupo de escalado automático](ec2-auto-scaling-default-instance-warmup.md).

**Configuración deseada**  
La *configuración deseada* es la nueva configuración que quiere que Amazon EC2 Auto Scaling implemente en el grupo de escalado automático. Por ejemplo, puede especificar una nueva plantilla de lanzamiento y nuevos tipos de instancias. Durante una actualización de instancias, Amazon EC2 Auto Scaling actualiza el grupo de Auto Scaling a la configuración deseada. Si se produce un evento de escalado horizontal durante la actualización de instancias, Amazon EC2 Auto Scaling lanza nuevas instancias con la configuración deseada en lugar de la configuración actual del grupo. Una vez que la actualización de instancias se realice correctamente, Amazon EC2 Auto Scaling actualiza la configuración del grupo de escalado automático para reflejar la nueva configuración deseada que ha especificado como parte de la actualización de instancias. 

**Omisión de coincidencias**  
La opción de omisión de coincidencias le dice a Amazon EC2 Auto Scaling que ignore las instancias que ya tienen sus actualizaciones más recientes. De esta forma, no reemplaza más instancias de las necesarias. Esto es útil cuando quiere asegurarse de que su grupo de escalado automático utilice una versión determinada de la plantilla de lanzamiento y solo sustituya las instancias que usan una versión diferente.

**Puntos de control**  
Un *punto de comprobación* es un punto en el tiempo en el que la actualización de instancias se detiene durante un periodo de tiempo especificado. Una actualización de instancias puede contener varios puntos de control. Amazon EC2 Auto Scaling emite eventos para cada punto de control. Por lo tanto, puede añadir una EventBridge regla para enviar los eventos a un destino, como Amazon SNS, para que se le notifique cuando se alcance un punto de control. Una vez llegado a un punto de control, podrá verificar la implementación. Si se identifica algún problema, puede cancelar la actualización de instancias o revertirla. La capacidad de implementar actualizaciones en fases es un beneficio clave de los puntos de control. Si no utiliza puntos de control, los reemplazos sucesivos se realizan ininterrumpidamente.

Para obtener más información sobre todos los ajustes predeterminados que puede configurar al iniciar una actualización de instancias, consulte [Comprensión de los valores predeterminados de una actualización de instancias](understand-instance-refresh-default-values.md).

## Periodo de gracia de la comprobación de estado
<a name="instance-refresh-health-check-grace-period"></a>

Amazon EC2 Auto Scaling determina si una instancia está en buen estado en función de las comprobaciones de estado que utiliza su grupo de escalado automático. Para obtener más información, consulte [Comprobaciones de estado para instancias en un grupo de escalado automático](ec2-auto-scaling-health-checks.md). 

Para asegurarse de que estas comprobaciones de estado comiencen lo antes posible, no establezca demasiado alto el periodo de gracia de las comprobaciones de estado del grupo, sino lo suficientemente alto como para que las comprobaciones de estado de Elastic Load Balancing puedan determinar si hay un objetivo disponible para gestionar las solicitudes. Para obtener más información, consulte [Establezca el periodo de gracia de la comprobación de estado para un grupo de escalado automático](health-check-grace-period.md).

## Compatibilidad de los tipos de instancias
<a name="instance-type-compatibility"></a>

Antes de cambiar el tipo de instancia, es recomendable comprobar que funciona con la plantilla de lanzamiento. Esto confirma la compatibilidad con la AMI que especificó. Por ejemplo, si lanzó las instancias originales desde una AMI paravirtual (PV), pero quiere cambiar a un tipo de instancia de generación actual que solo es compatible con una AMI de máquina virtual de hardware (HVM). En este caso, debe utilizar una AMI de HVM en la plantilla de lanzamiento. 

Para confirmar la compatibilidad del tipo de instancia sin lanzar instancias, utilice el comando [run-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/run-instances.html) con la opción `--dry-run`, como se muestra en el siguiente ejemplo.

```
aws ec2 run-instances --launch-template LaunchTemplateName=my-template,Version='1' --dry-run
```

Para obtener más información sobre cómo se determina la compatibilidad, consulte [Compatibilidad para cambiar el tipo de instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/resize-limitations.html) en la *Guía del usuario de Amazon EC2*.

## Limitaciones
<a name="instance-refresh-limitations"></a>
+ **Duración total**: el periodo de tiempo máximo durante el cual una actualización de una instancia puede seguir reemplazando activamente instancias es de 14 días. 
+ **Diferencia en el comportamiento específico de los grupos ponderados**: si se configura un grupo de instancias mixtas con una ponderación de instancia mayor o igual a la capacidad deseada del grupo, Amazon EC2 Auto Scaling puede reemplazar todas las instancias con el estado `InService` a la vez. Para evitar esta situación, siga las recomendaciones del tema [Configuración de un grupo de escalado automático para utilizar ponderación de instancias](ec2-auto-scaling-mixed-instances-groups-instance-weighting.md). Especifique una capacidad deseada que sea mayor que su ponderación máxima cuando utilice ponderaciones con su grupo de escalado automático.
+ **Tiempo de espera de una hora**: cuando una actualización de instancias no puede continuar haciendo reemplazos porque está esperando reemplazar instancias en espera o protegidas contra la reducción horizontal, o las nuevas instancias no superan las comprobaciones de estado, Amazon EC2 Auto Scaling seguirá intentándolo durante una hora. También proporciona un mensaje de estado para ayudarlo a resolver el problema. Si el problema persiste después de una hora, la operación produce un error. La intención es darle tiempo para recuperarse si se trata de un problema temporal. 
+ **Implementación del código a través de los datos del usuario**: la opción Omitir coincidencia no comprueba los cambios de código que se implementan desde un script de datos de usuario. Si utiliza datos de usuario para extraer código nuevo e instalar estas actualizaciones en instancias nuevas, le recomendamos que desactive la opción de omisión de coincidencias para asegurarse de que todas las instancias reciban el código más reciente, incluso sin haber realizado una actualización de la versión de la plantilla de lanzamiento.
+ **Restricción de actualización**: si intenta actualizar la plantilla de lanzamiento, la configuración de lanzamiento o la política de instancias mixtas de un grupo de escalado automático mientras está activa una actualización de instancias con la configuración deseada, la solicitud fallará y mostrará el siguiente error de validación: `An active instance refresh with a desired configuration exists. All configuration options derived from the desired configuration are not available for update while the instance refresh is active.` 
+ **Selección de instancias basada en atributos**: si su grupo de escalado automático utiliza la selección de instancias basada en atributos (al especificar `InstanceRequirements` en una política de instancias mixtas), no se admitirán los siguientes parámetros de actualización de instancias:
  + **SkipMatching**- La actualización de una instancia fallará si la inicia con el `SkipMatching` parámetro en un grupo de Auto Scaling que se haya `InstanceRequirements` configurado.
  + **DesiredConfiguration**- La actualización de una instancia fallará si la inicia con el `DesiredConfiguration` parámetro en un grupo de Auto Scaling que se haya `InstanceRequirements` configurado.

  Si necesita realizar una actualización de instancias en un grupo de escalado automático con una selección de instancias basada en atributos, debe iniciar la actualización de instancias sin estos parámetros.
+ La sustitución del volumen raíz no es compatible con Elastic Load Balancing.

# Comprensión de los valores predeterminados de una actualización de instancias
<a name="understand-instance-refresh-default-values"></a>

Antes de iniciar una actualización de instancias, puede personalizar las diversas preferencias que afectan a la actualización de instancias. Algunos valores predeterminados de las preferencias varían en función de si utiliza la consola o la línea de comandos (AWS CLI o el AWS SDK).

En esta tabla se muestran los valores predeterminados de la configuración de actualización de instancias.


| Opción | AWS CLI o SDK AWS  | Consola de Amazon EC2 Auto Scaling | 
| --- | --- | --- | 
| CloudWatch alarma | Deshabilitado (nulo) | Deshabilitado | 
| Reversión automática | Deshabilitado (false) | Deshabilitado | 
| Hora de hornear | Cero | Cero | 
| Puntos de control | Deshabilitado (false) | Deshabilitado | 
| Retraso de punto de comprobación | 1 hora (3600 segundos) | 1 hora | 
| Preparación de las instancias | La [preparación de la instancia predeterminada](ec2-auto-scaling-default-instance-warmup.md), si está definida, o el [periodo de gracia de la comprobación de estado](health-check-grace-period.md), en caso contrario. | La [preparación de la instancia predeterminada](ec2-auto-scaling-default-instance-warmup.md), si está definida, o el [periodo de gracia de la comprobación de estado](health-check-grace-period.md), en caso contrario. | 
| Porcentaje máximo en buen estado | Varía en función de la política de mantenimiento de instancias. Si no hay una política de mantenimiento de instancias, el valor predeterminado es del 100 por ciento (nula). | Varía en función de la política de mantenimiento de instancias. Si no hay una política de mantenimiento de instancias, el valor predeterminado es del 100 por ciento (nula). | 
| Porcentaje de buen estado mínimo | Varía en función de la política de mantenimiento de instancias. Si no hay una política de mantenimiento de instancias, el valor predeterminado es del 90 por ciento. | Varía en función de la política de mantenimiento de instancias. Si no hay una política de mantenimiento de instancias, el valor predeterminado es del 90 por ciento. | 
| Instancias con protección de reducción horizontal | Wait | Ignore | 
| Omisión de coincidencias | Deshabilitado (false) | Habilitado | 
| Instancias en espera | Wait | Ignore | 

A continuación, se muestra una descripción de cada configuración:

**CloudWatch alarma (`AlarmSpecification`)**  
La especificación CloudWatch de la alarma. CloudWatch las alarmas se pueden utilizar para identificar cualquier problema y hacer que la operación falle si se activa una `ALARM` alarma. Para obtener más información, consulte [Inicio de una actualización de instancias con reversión automática](instance-refresh-rollback.md#instance-refresh-using-auto-rollback). 

**Reversión automática (`AutoRollback`)**  
Controla si Amazon EC2 Auto Scaling revierte el grupo de escalado automático a su configuración anterior si se produce un error en la actualización de instancias. Para obtener más información, consulte [Inversión de cambios con una reversión manual o automática](instance-refresh-rollback.md). 

**Tiempo de incorporación (`BakeTime`)**  
Tiempo que se debe esperar al final de una actualización de instancias antes de que la actualización se considere completa.

**Puntos de comprobación (`CheckpointPercentages`)**  
Controla si Amazon EC2 Auto Scaling reemplaza las instancias en fases. Esto resulta útil si necesita realizar verificaciones en las instancias antes de reemplazar todas las instancias. Para obtener más información, consulte [Agregar puntos de control a una actualización de instancias](asg-adding-checkpoints-instance-refresh.md). 

**Retraso de punto de comprobación (`CheckpointDelay`)**  
La cantidad de tiempo, en segundos, que debe esperar después de alcanzar un punto de comprobación antes de continuar. Para obtener más información, consulte [Agregar puntos de control a una actualización de instancias](asg-adding-checkpoints-instance-refresh.md). 

**Preparación de la instancia (`InstanceWarmup`)**  
Periodo de tiempo, en segundos, durante el cual Amazon EC2 Auto Scaling espera hasta que una instancia nueva se considere que una instancia nueva ha terminado de inicializarse antes de reemplazar la siguiente instancia. Si ya ha definido correctamente la preparación predeterminada de instancias del grupo de escalado automático, no necesita cambiarla (a menos que quiera anular la configuración predeterminada). Para obtener más información, consulte [Establecimiento de la preparación predeterminada de instancias para un grupo de escalado automático](ec2-auto-scaling-default-instance-warmup.md).

**Porcentaje máximo en buen estado‭ (`MaxHealthyPercentage`)**  
El porcentaje de la capacidad deseada del grupo de escalado automático al cual el grupo puede aumentar al reemplazar instancias.

**Porcentaje mínimo en buen estado (`MinHealthyPercentage`)**  
El porcentaje de la capacidad deseada del grupo de escalado automático que debe estar en servicio, en buen estado y listo para usarse antes de que la operación pueda continuar.

**Instancias con protección de reducción horizontal (`ScaleInProtectedInstances`)**  
Controla que Amazon EC2 Auto Scaling encuentre instancias que estén protegidas contra la reducción horizontal. Para obtener más información sobre estas instancias, consulte [Uso de la protección frente a la reducción horizontal de instancias para controlar la terminación de instancias](ec2-auto-scaling-instance-protection.md).  
Amazon EC2 Auto Scaling ofrece las siguientes opciones:  
+ **Reemplazar** (`Refresh`): reemplaza las instancias que están protegidas contra la reducción horizontal.
+ **Ignorar** (`Ignore`): ignora las instancias que están protegidas contra la reducción horizontal y continúa reemplazando las instancias que no están protegidas.
+ **Esperar** (`Wait`): espera una hora para que elimine la protección contra la reducción horizontal. Si no lo hace, se producirá un error en la actualización de instancias.

**Omitir coincidencia (`SkipMatching`)**  
Controla si Amazon EC2 Auto Scaling omite el reemplazo de las instancias que coinciden con la configuración deseada. Si no se especifica ninguna configuración deseada, se omite el reemplazo de las instancias que tienen la misma plantilla de lanzamiento y los mismos tipos de instancias que el grupo de escalado automático utilizaba antes de que se iniciara la actualización de instancias. Para obtener más información, consulte [Uso de una actualización de instancias con la omisión de coincidencias](asg-instance-refresh-skip-matching.md). 

**Instancias en espera (`StandbyInstances`)**  
Controla qué hace Amazon EC2 Auto Scaling si encuentra instancias en estado `Standby`. Para obtener más información sobre estas instancias, consulte [Eliminación temporal de las instancias de un grupo de escalado automático](as-enter-exit-standby.md).  
Amazon EC2 Auto Scaling ofrece las siguientes opciones:  
+ **Finalizar** (`Terminate`): finaliza las instancias que se encuentran en estado `Standby`.
+ **Ignorar** (`Ignore`): ignora las instancias que se encuentran en estado `Standby` y continúa reemplazando las instancias que están en estado `InService`.
+ **Esperar** (`Wait`): espera una hora para que devuelva las instancias al servicio. Si no lo hace, se producirá un error en la actualización de instancias.

# Inicie la actualización de una instancia con Consola de administración de AWS o AWS CLI
<a name="start-instance-refresh"></a>

**importante**  
Puede revertir una actualización de instancias que está en curso para anular los cambios. Para que esto funcione, el grupo de escalado automático tiene que cumplir los requisitos previos para utilizar las reversiones antes de iniciar la actualización de instancias. Para obtener más información, consulte [Inversión de cambios con una reversión manual o automática](instance-refresh-rollback.md).

Los siguientes procedimientos te ayudan a iniciar una actualización de instancias con la tecla Consola de administración de AWS o AWS CLI.

## Inicio de una actualización de instancias (consola)
<a name="start-instance-refresh-console"></a>

Si es la primera vez que inicia una actualización de instancias, el uso de la consola lo ayudará a comprender las características y las opciones disponibles.

### Inicio de una actualización de instancias en la consola (procedimiento básico)
<a name="starting-an-instance-refresh-in-the-console"></a>

Utilice el siguiente procedimiento si no definió previamente una [política de instancias mixtas](ec2-auto-scaling-mixed-instances-groups.md) para el grupo de Auto Scaling. Si definió previamente una política de instancias mixtas, consulte [Inicio de una actualización de instancias en la consola (grupo de instancias mixtas)](#starting-an-instance-refresh-in-the-console-mig) para iniciar una actualización de instancias.

**Para comenzar una actualización de instancias**

1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.

1. Seleccione la casilla situada junto al grupo de escalado automático.

   Se abre un panel dividido en la parte inferior de la página **Auto Scaling groups** (Grupos de Auto Scaling). 

1. En la pestaña **Instance refresh** (Actualización de instancias) en **Active Instance refresh** (Actualización de instancias activas), elija **Start instance refresh** (Iniciar actualización de instancias).

1. En **Configuración de disponibilidad**, haga lo siguiente:

   1. Para el **Método de reemplazo de instancias**:
      + Si *no* ha establecido una política de mantenimiento de instancias en el grupo de escalado automático, la configuración predeterminada para el **método de reemplazo de instancias** es **Finalice y lance**. Este es el comportamiento predeterminado anterior de una actualización de instancias.
      + Si establece una política de mantenimiento de instancias en el grupo de escalado automático, proporciona valores predeterminados para el **método de reemplazo de instancias**. Para anular la política de mantenimiento de instancias, seleccione **Anular**. La anulación solo se aplica a la actualización de instancias actual. La próxima vez que inicie una actualización de instancias, estos valores se restablecerán a los valores predeterminados de la política de mantenimiento de instancias. 

      En el siguiente procedimiento, se explica cómo actualizar el método de reemplazo de instancias.

      1. Elija uno de los siguientes métodos de reemplazo de instancias:
         + **Lance antes de terminar**: primero se debe aprovisionar una nueva instancia antes de poder cancelar una instancia existente. Esta es una buena opción para las aplicaciones que prefieren la disponibilidad en lugar del ahorro de costos.
         + **Finalice y lance**: las instancias nuevas se aprovisionan al mismo tiempo que se terminan las instancias existentes. Esta es una buena opción para las aplicaciones que favorecen el ahorro de costos por encima de la disponibilidad. También es una buena opción para las aplicaciones que no deberían lanzar una capacidad superior a la disponible actualmente.
         + **Comportamiento personalizado**: esta opción permite configurar un rango mínimo y máximo personalizado para la cantidad de capacidad que quiere que esté disponible al reemplazar las instancias. Esto puede ayudarlo a lograr el equilibrio adecuado entre costo y disponibilidad.

      1. En **Defina un porcentaje de buen estado**, introduzca valores para uno o ambos de los siguientes campos. Los campos de activación varían según la opción que elija para el **método de reemplazo de instancias**. 
         + **Mínimo**: establece el porcentaje de buen estado mínimo necesario para continuar con la actualización de instancias.
         + **Máximo**: establece el porcentaje máximo en buen estado‭ posible durante la actualización de instancias. 

      1. Amplíe la sección **Ver la capacidad temporal estimada durante las sustituciones en función del tamaño del grupo actual** para confirmar cómo se aplican los valores **mínimo** y **máximo** a su grupo. Los valores exactos utilizados dependen del valor de la capacidad deseada, que cambiará si el grupo escala.

      1. Amplíe la sección **Definir un comportamiento alternativo para tamaños de reemplazo no válidos** y, a continuación, elija si desea **Infrinja el porcentaje máximo de buen estado** para priorizar la disponibilidad o **Infrinja el porcentaje mínimo de buen estado**. 

         No se recomienda mantener la opción predeterminada de **Infrinja el porcentaje mínimo de buen estado** para grupos muy pequeños. Si solo hay una instancia en el grupo de escalado automático, iniciar una actualización de instancias puede provocar una interrupción.

         Este paso configura el comportamiento alternativo si está utilizando un grupo de escalado automático que aún no tiene una política de mantenimiento de instancias. Esta opción no está disponible y no aparece cuando el grupo tiene una política de mantenimiento de instancias. Esta opción también solo está disponible para el método **Finalice y lance**. Otros métodos de reemplazo infringirán el porcentaje máximo en buen estado‭ para priorizar la disponibilidad.

   1. En **Preparación de la instancia**, ingrese el número de segundos desde que el estado de una nueva instancia cambia a `InService` hasta que finaliza su inicialización. Amazon EC2 Auto Scaling espera este tiempo antes de proceder a reemplazar la siguiente instancia. 

      Durante la preparación, una instancia recién lanzada tampoco se cuenta en las métricas de instancia agregadas del grupo de escalado automático (como `CPUUtilization`, `NetworkIn` y `NetworkOut`). Si ha agregado políticas de escalado al grupo de Auto Scaling, las actividades de escalado se ejecutan en paralelo. Si establece un intervalo largo para el periodo de preparación de la actualización de instancias, las instancias recién iniciadas tardan más tiempo en mostrarse en las métricas. Por lo tanto, un periodo de preparación adecuado evita que Amazon EC2 Auto Scaling realice el escalado sobre los datos de métricas obsoletos.

      Si ya ha definido correctamente la preparación predeterminada de instancias del grupo de escalado automático, no necesita cambiarla. Sin embargo, si quiere anular el valor predeterminado, puede establecer un valor para esta opción. Para obtener más información sobre la preparación de las instancias predeterminada, consulte [Establecimiento de la preparación predeterminada de instancias para un grupo de escalado automático](ec2-auto-scaling-default-instance-warmup.md).

1. En **Configuración de actualización**, haga lo siguiente:

   1. (Opcional) En **Checkpoints** (Puntos de control), elija **Enable checkpoints** (Habilitar puntos de control) para reemplazar instancias mediante un enfoque progresivo o gradual de una actualización de instancias. Esto le ofrece tiempo adicional para la verificación entre conjuntos de reemplazos. Si elige no habilitar los puntos de control, las instancias se reemplazan en una operación casi continua.

      Si habilita los puntos de control, consulte [Habilitar puntos de control (consola)](enable-checkpoints-console-cli.md#enable-checkpoints-console) para obtener pasos adicionales.

   1. (Opcional) En **Tiempo de incorporación**, se especifica el tiempo que se debe esperar al final de la actualización de la instancia antes de que la actualización se considere completa.

   1. Cómo habilitar o desactivar **Skip matching** (Omisión de coincidencias):
      + Para omitir el reemplazo de las instancias que ya coinciden con la plantilla de lanzamiento, mantenga seleccionada la casilla de verificación **Habilitar Omitir coincidencia**.
      + Si desactiva la casilla de verificación de omisión de coincidencias, se pueden reemplazar todas las instancias.

      Cuando se habilita la omisión de coincidencias, puede configurar una nueva plantilla de lanzamiento o una nueva plantilla de lanzamiento, en lugar de utilizar la que ya existe. Hágalo en la sección **Configuración deseada** de la página **Iniciar actualización de instancias**. 
**nota**  
Para utilizar la característica de omisión de coincidencias y actualizar un grupo de Auto Scaling que actualmente utiliza una configuración de lanzamiento, debe seleccionar una plantilla de lanzamiento en **Desired configuration** (Configuración deseada). No se admite la omisión de coincidencias con una configuración de lanzamiento.

   1. En **Instancias en espera**, seleccione **Ignorar**, **Finalizar** o **Esperar**. Esto determina lo que ocurre si se encuentran instancias en estado `Standby`. Para obtener más información, consulte [Eliminación temporal de las instancias de un grupo de escalado automático](as-enter-exit-standby.md).

      Si elige **Esperar**, debe tomar medidas adicionales para devolver estas instancias al servicio. Si no lo hace, la actualización de instancias reemplazará a todas las instancias en estado `InService` y esperará una hora. A continuación, si queda alguna instancia en estado `Standby`, se producirá un error en la actualización de instancias. Para evitar esta situación, elija **Ignorar** o **Finalizar** estas instancias en su lugar. 

   1. En **Instancias con protección de reducción horizontal**, elija **Ignorar**, **Reemplazar** o **Esperar**. Esto determina lo que ocurre si se encuentran instancias protegidas contra la reducción horizontal. Para obtener más información, consulte [Uso de la protección frente a la reducción horizontal de instancias para controlar la terminación de instancias](ec2-auto-scaling-instance-protection.md).

      Si elige **Esperar**, debe tomar medidas adicionales para eliminar la protección contra la reducción horizontal de estas instancias. Si no lo hace, la actualización de instancias reemplazará a todas las instancias no protegidas y esperará una hora. A continuación, si queda alguna instancia protegida contra la reducción horizontal, se producirá un error en la actualización de instancias. Para evitar esta situación, elija **Ignorar** o **Reemplazar** estas instancias en su lugar. 

1. (Opcional) Para la **CloudWatch alarma**, seleccione **Activar CloudWatch alarmas** y, a continuación, elija una o más alarmas. CloudWatch las alarmas se pueden utilizar para identificar cualquier problema y anular la operación si se activa una `ALARM` alarma. Para obtener más información, consulte [Inicio de una actualización de instancias con reversión automática](instance-refresh-rollback.md#instance-refresh-using-auto-rollback). 

1. (Opcional) Amplíe la sección **Configuración deseada** para especificar las actualizaciones que desee realizar en el grupo de escalado automático.

   En este paso, puede elegir utilizar la sintaxis JSON o YAML para editar los valores de parámetros en lugar de realizar selecciones en la interfaz de la consola. Para ello, elija **Use code editor** (Usar editor de código) en lugar de **Use console interface** (Usar interfaz de consola). En el siguiente procedimiento, se explica cómo realizar selecciones con la interfaz de la consola.

   1. En **Update launch template** (Actualización de la plantilla de lanzamiento): 
      + Si *no* creó una nueva plantilla de lanzamiento o una nueva versión de la plantilla de lanzamiento para su grupo de escalado automático, no seleccione esta casilla de verificación.
      + Si creó una nueva plantilla de lanzamiento o una nueva versión de la plantilla de lanzamiento, seleccione esta casilla de verificación. Al seleccionar esta opción, Amazon EC2 Auto Scaling le muestra la plantilla de lanzamiento actual y la versión actual de la plantilla de lanzamiento. También indica cualquier otra versión disponible. Elija la plantilla de lanzamiento y, a continuación, elija la versión. 

        Después de elegir una versión, podrá ver la información de la versión. Esta es la versión de la plantilla de lanzamiento que se utilizará cuando se reemplacen instancias como parte de una actualización de instancias. Si la actualización de la instancia se realiza correctamente, esta versión de la plantilla de lanzamiento también se utilizará cada vez que se lancen nuevas instancias, como en el escalado del grupo.

   1. En **Choose a set of instance types and purchase options to override the instance type in the launch template** (Elegir un conjunto de instancias y opciones de compra para anular el tipo de instancia en la plantilla de lanzamiento):
      + No seleccione esta casilla de verificación sin quiere utilizar el tipo de instancia y la opción de compra que especificó en la plantilla de lanzamiento.
      + Active esta casilla de verificación si desea anular el tipo de instancia en la plantilla de lanzamiento o ejecutar instancias de spot. Puede agregar manualmente cada tipo de instancia o elegir un tipo de instancia principal y una opción de recomendación que recupere cualquier tipo de instancia coincidente adicional por usted. Si tiene previsto lanzar instancias de spot, le recomendamos que agregue algunos tipos de instancias diferentes. De esta forma, Amazon EC2 Auto Scaling puede lanzar otro tipo de instancia si no hay suficiente capacidad en las zonas de disponibilidad elegidas. Para obtener más información, consulte [Grupos de Auto Scaling con varios tipos de instancia y opciones de compra](ec2-auto-scaling-mixed-instances-groups.md).
**aviso**  
No utilice instancias de spot con aplicaciones que no puedan gestionar una interrupción de las mismas. Se pueden producir interrupciones si el servicio de spot de Amazon EC2 necesita recuperar la capacidad.

      Si activa esta casilla de verificación, asegúrese de que la plantilla de lanzamiento no solicite ya instancias de spot. No se puede utilizar una plantilla de lanzamiento que solicite instancias de spot para crear un grupo de escalado automático que utilice varios tipos de instancias e inicie instancias de spot y bajo demanda.
**nota**  
Para configurar estas opciones en un grupo de Auto Scaling que actualmente utiliza una configuración de lanzamiento, debe seleccionar una plantilla de lanzamiento en **Update launch template** (Actualización de la plantilla de lanzamiento). No se admite la anulación del tipo de instancia en la configuración de lanzamiento.

1. (Opcional) En **Configuración de la reversión**, seleccione **Habilitar la reversión automática** para revertir automáticamente la actualización de instancias en caso de que se produzca un error.

   Esta configuración solo se puede habilitar cuando el grupo de escalado automático cumple con los requisitos previos para utilizar las reversiones. 

   Para obtener más información, consulte [Inversión de cambios con una reversión manual o automática](instance-refresh-rollback.md).

1. Revise todas las selecciones para confirmar que todo está configurado correctamente.

   Una buena idea en este punto es verificar que las diferencias entre los cambios actuales y los propuestos no afecten a la aplicación de formas inesperadas o no deseadas. Para confirmar que el tipo de instancia es compatible con la plantilla de lanzamiento, consulte [Compatibilidad de los tipos de instancias](instance-refresh-overview.md#instance-type-compatibility).

1. Cuando esté satisfecho con las selecciones de actualización de instancias, elija **Iniciar actualización de instancias**. 

### Inicio de una actualización de instancias en la consola (grupo de instancias mixtas)
<a name="starting-an-instance-refresh-in-the-console-mig"></a>

Utilice el siguiente procedimiento si creó un grupo de Auto Scaling con una [política de instancias mixtas](ec2-auto-scaling-mixed-instances-groups.md). Si aún no definió una política de instancias mixtas para el grupo, consulte [Inicio de una actualización de instancias en la consola (procedimiento básico)](#starting-an-instance-refresh-in-the-console) para iniciar una actualización de instancias.

**Para comenzar una actualización de instancias**

1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.

1. Seleccione la casilla situada junto al grupo de escalado automático.

   Se abre un panel dividido en la parte inferior de la página **Auto Scaling groups** (Grupos de Auto Scaling). 

1. En la pestaña **Instance refresh** (Actualización de instancias) en **Active Instance refresh** (Actualización de instancias activas), elija **Start instance refresh** (Iniciar actualización de instancias).

1. En **Configuración de disponibilidad**, haga lo siguiente:

   1. Para el **Método de reemplazo de instancias**:
      + Si *no* ha establecido una política de mantenimiento de instancias en el grupo de escalado automático, la configuración predeterminada para el **método de reemplazo de instancias** es **Finalice y lance**. Este es el comportamiento predeterminado anterior de una actualización de instancias.
      + Si establece una política de mantenimiento de instancias en el grupo de escalado automático, proporciona valores predeterminados para el **método de reemplazo de instancias**. Para anular la política de mantenimiento de instancias, seleccione **Anular**. La anulación solo se aplica a la actualización de instancias actual. La próxima vez que inicie una actualización de instancias, estos valores se restablecerán a los valores predeterminados de la política de mantenimiento de instancias. 

      En el siguiente procedimiento, se explica cómo actualizar el método de reemplazo de instancias.

      1. Elija uno de los siguientes métodos de reemplazo de instancias:
         + **Lance antes de terminar**: primero se debe aprovisionar una nueva instancia antes de poder cancelar una instancia existente. Esta es una buena opción para las aplicaciones que prefieren la disponibilidad en lugar del ahorro de costos.
         + **Finalice y lance**: las instancias nuevas se aprovisionan al mismo tiempo que se terminan las instancias existentes. Esta es una buena opción para las aplicaciones que favorecen el ahorro de costos por encima de la disponibilidad. También es una buena opción para las aplicaciones que no deberían lanzar una capacidad superior a la disponible actualmente.
         + **Comportamiento personalizado**: esta opción permite configurar un rango mínimo y máximo personalizado para la cantidad de capacidad que quiere que esté disponible al reemplazar las instancias. Esto puede ayudarlo a lograr el equilibrio adecuado entre costo y disponibilidad.

      1. En **Defina un porcentaje de buen estado**, introduzca valores para uno o ambos de los siguientes campos. Los campos de activación varían según la opción que elija para el **método de reemplazo de instancias**. 
         + **Mínimo**: establece el porcentaje de buen estado mínimo necesario para continuar con la actualización de instancias.
         + **Máximo**: establece el porcentaje máximo en buen estado‭ posible durante la actualización de instancias.

      1. Amplíe la sección **Ver la capacidad temporal estimada durante las sustituciones en función del tamaño del grupo actual** para confirmar cómo se aplican los valores **mínimo** y **máximo** a su grupo. Los valores exactos utilizados dependen del valor de la capacidad deseada, que cambiará si el grupo escala.

      1. Amplíe la sección **Definir un comportamiento alternativo para tamaños de reemplazo no válidos** y, a continuación, elija si desea **Infrinja el porcentaje máximo de buen estado** para priorizar la disponibilidad o **Infrinja el porcentaje mínimo de buen estado**. 

         No se recomienda mantener la opción predeterminada de **Infrinja el porcentaje mínimo de buen estado** para grupos muy pequeños. Si solo hay una instancia en el grupo de escalado automático, iniciar una actualización de instancias puede provocar una interrupción.

         Este paso configura el comportamiento alternativo si está utilizando un grupo de escalado automático que aún no tiene una política de mantenimiento de instancias. Esta opción no está disponible y no aparece cuando el grupo tiene una política de mantenimiento de instancias. Esta opción también solo está disponible para el método **Finalice y lance**. Otros métodos de reemplazo infringirán el porcentaje máximo en buen estado‭ para priorizar la disponibilidad.

   1. En **Preparación de la instancia**, ingrese el número de segundos desde que el estado de una nueva instancia cambia a `InService` hasta que finaliza su inicialización. Amazon EC2 Auto Scaling espera este tiempo antes de proceder a reemplazar la siguiente instancia. 

      Durante la preparación, una instancia recién lanzada tampoco se cuenta en las métricas de instancia agregadas del grupo de escalado automático (como `CPUUtilization`, `NetworkIn` y `NetworkOut`). Si ha agregado políticas de escalado al grupo de Auto Scaling, las actividades de escalado se ejecutan en paralelo. Si establece un intervalo largo para el periodo de preparación de la actualización de instancias, las instancias recién iniciadas tardan más tiempo en mostrarse en las métricas. Por lo tanto, un periodo de preparación adecuado evita que Amazon EC2 Auto Scaling realice el escalado sobre los datos de métricas obsoletos.

      Si ya ha definido correctamente la preparación predeterminada de instancias del grupo de escalado automático, no necesita cambiarla. Sin embargo, si quiere anular el valor predeterminado, puede establecer un valor para esta opción. Para obtener más información sobre la preparación de las instancias predeterminada, consulte [Establecimiento de la preparación predeterminada de instancias para un grupo de escalado automático](ec2-auto-scaling-default-instance-warmup.md).

1. En **Configuración de actualización**, haga lo siguiente:

   1. (Opcional) En **Checkpoints** (Puntos de control), elija **Enable checkpoints** (Habilitar puntos de control) para reemplazar instancias mediante un enfoque progresivo o gradual de una actualización de instancias. Esto le ofrece tiempo adicional para la verificación entre conjuntos de reemplazos. Si elige no habilitar los puntos de control, las instancias se reemplazan en una operación casi continua.

      Si habilita los puntos de control, consulte [Habilitar puntos de control (consola)](enable-checkpoints-console-cli.md#enable-checkpoints-console) para obtener pasos adicionales.

   1. Cómo habilitar o desactivar **Skip matching** (Omisión de coincidencias):
      + Para omitir el reemplazo de instancias que ya coinciden con la plantilla de lanzamiento y cualquier anulación de tipo de instancia, mantenga seleccionada la casilla de verificación **Habilitar Omitir coincidencia**.
      + Si elige desactivar la casilla de verificación de omisión de coincidencias, se pueden reemplazar todas las instancias.

      Cuando se habilita la omisión de coincidencias, puede configurar una nueva plantilla de lanzamiento o una nueva plantilla de lanzamiento, en lugar de utilizar la que ya existe. Hágalo en la sección **Configuración deseada** de la página **Iniciar actualización de instancias**. También puede actualizar las anulaciones de tipo de instancia en **Desired configuration** (Configuración deseada). 

   1. En **Instancias en espera**, seleccione **Ignorar**, **Finalizar** o **Esperar**. Esto determina lo que ocurre si se encuentran instancias en estado `Standby`. Para obtener más información, consulte [Eliminación temporal de las instancias de un grupo de escalado automático](as-enter-exit-standby.md).

      Si elige **Esperar**, debe tomar medidas adicionales para devolver estas instancias al servicio. Si no lo hace, la actualización de instancias reemplazará a todas las instancias en estado `InService` y esperará una hora. A continuación, si queda alguna instancia en estado `Standby`, se producirá un error en la actualización de instancias. Para evitar esta situación, elija **Ignorar** o **Finalizar** estas instancias en su lugar. 

   1. En **Instancias con protección de reducción horizontal**, elija **Ignorar**, **Reemplazar** o **Esperar**. Esto determina lo que ocurre si se encuentran instancias protegidas contra la reducción horizontal. Para obtener más información, consulte [Uso de la protección frente a la reducción horizontal de instancias para controlar la terminación de instancias](ec2-auto-scaling-instance-protection.md).

      Si elige **Esperar**, debe tomar medidas adicionales para eliminar la protección contra la reducción horizontal de estas instancias. Si no lo hace, la actualización de instancias reemplazará a todas las instancias no protegidas y esperará una hora. A continuación, si queda alguna instancia protegida contra la reducción horizontal, se producirá un error en la actualización de instancias. Para evitar esta situación, elija **Ignorar** o **Reemplazar** estas instancias en su lugar.

1. (Opcional) Para la **CloudWatch alarma**, seleccione **Activar CloudWatch alarmas** y, a continuación, elija una o más alarmas. CloudWatch las alarmas se pueden utilizar para identificar cualquier problema y anular la operación si se activa una `ALARM` alarma. Para obtener más información, consulte [Inicio de una actualización de instancias con reversión automática](instance-refresh-rollback.md#instance-refresh-using-auto-rollback). 

1. En la sección **Desired configuration** (Configuración deseada), haga lo siguiente: 

   En este paso, puede elegir utilizar la sintaxis JSON o YAML para editar los valores de parámetros en lugar de realizar selecciones en la interfaz de la consola. Para ello, elija **Use code editor** (Usar editor de código) en lugar de **Use console interface** (Usar interfaz de consola). En el siguiente procedimiento, se explica cómo realizar selecciones con la interfaz de la consola.

   1. En **Update launch template** (Actualización de la plantilla de lanzamiento): 
      + Si *no* creó una nueva plantilla de lanzamiento o una nueva versión de la plantilla de lanzamiento para su grupo de escalado automático, no seleccione esta casilla de verificación.
      + Si creó una nueva plantilla de lanzamiento o una nueva versión de la plantilla de lanzamiento, seleccione esta casilla de verificación. Al seleccionar esta opción, Amazon EC2 Auto Scaling le muestra la plantilla de lanzamiento actual y la versión actual de la plantilla de lanzamiento. También indica cualquier otra versión disponible. Elija la plantilla de lanzamiento y, a continuación, elija la versión. 

        Después de elegir una versión, podrá ver la información de la versión. Esta es la versión de la plantilla de lanzamiento que se utilizará cuando se reemplacen instancias como parte de una actualización de instancias. Si la actualización de la instancia se realiza correctamente, esta versión de la plantilla de lanzamiento también se utilizará cada vez que se lancen nuevas instancias, como en el escalado del grupo.

   1. En **Use these settings to override the instance type and purchase option defined in the launch template** (Utilizar esta configuración para anular el tipo de instancia y la opción de compra definidas en la plantilla de lanzamiento): 

      Esta casilla de verificación está activada de forma predeterminada. Amazon EC2 Auto Scaling rellena cada parámetro con el valor que actualmente está configurado en la *política de instancias mixtas* para el grupo de Auto Scaling. Actualice solo los valores de los parámetros que desea cambiar. Para obtener orientación sobre esta configuración, consulte [Grupos de Auto Scaling con varios tipos de instancia y opciones de compra](ec2-auto-scaling-mixed-instances-groups.md).
**aviso**  
Le recomendamos que no desactive esta casilla de verificación. Desactívela solo si desea dejar de utilizar una política de instancias mixtas. Después de que la actualización de instancias se realiza correctamente, Amazon EC2 Auto Scaling actualiza el grupo para que coincida con la **Desired configuration** (Configuración deseada). Si ya no incluye una política de instancias mixtas, Amazon EC2 Auto Scaling termina gradualmente cualquier instancia de spot que se esté ejecutando actualmente y la reemplaza por instancias bajo demanda. O bien, si la plantilla de lanzamiento solicita instancias de spot, Amazon EC2 Auto Scaling termina gradualmente cualquier instancia bajo demanda que se esté ejecutando actualmente y la reemplaza por instancias de spot. 

1. (Opcional) En **Configuración de la reversión**, seleccione **Habilitar la reversión automática** para revertir automáticamente la actualización de instancias en caso de que se produzca un error, independientemente del motivo.

   Esta configuración solo se puede habilitar cuando el grupo de escalado automático cumple con los requisitos previos para utilizar las reversiones. 

   Para obtener más información, consulte [Inversión de cambios con una reversión manual o automática](instance-refresh-rollback.md).

1. Revise todas las selecciones para confirmar que todo está configurado correctamente.

   Una buena idea en este punto es verificar que las diferencias entre los cambios actuales y los propuestos no afecten a la aplicación de formas inesperadas o no deseadas. Para confirmar que el tipo de instancia es compatible con la plantilla de lanzamiento, consulte [Compatibilidad de los tipos de instancias](instance-refresh-overview.md#instance-type-compatibility).

   Cuando esté satisfecho con las selecciones de actualización de instancias, elija **Iniciar actualización de instancias**. 

## Inicio de una actualización de instancias (AWS CLI)
<a name="start-instance-refresh-cli"></a>

**Para comenzar una actualización de instancias**  
Usa el siguiente [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando para iniciar una actualización de instancias desde AWS CLI. Puede especificar las preferencias que desee cambiar en un archivo de configuración JSON. Cuando haga referencia al archivo de configuración, proporcione la ruta y el nombre del archivo como se muestra en el ejemplo siguiente.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenido de `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 50,
      "AutoRollback": true,
      "ScaleInProtectedInstances": Ignore,
      "StandbyInstances": Terminate
    }
}
```

Si no se proporcionan preferencias, se usan los valores predeterminados. Para obtener más información, consulte [Comprensión de los valores predeterminados de una actualización de instancias](understand-instance-refresh-default-values.md).

Ejemplo de código de salida:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

# Supervise la actualización de una instancia mediante Consola de administración de AWS o AWS CLI
<a name="check-status-instance-refresh"></a>

Puedes supervisar una actualización de instancia en curso o consultar el estado de las actualizaciones de instancias anteriores de las últimas seis semanas con la tecla Consola de administración de AWS o AWS CLI. 

## Supervisión y comprobación del estado de una actualización de instancias
<a name="monitor-and-check-status"></a>

Para supervisar y comprobar el estado de la actualización de una instancia, use uno de los siguientes métodos:

------
#### [ Console ]

**sugerencia**  
En este procedimiento, ya deberían aparecer las columnas con nombre. Para mostrar las columnas ocultas o cambiar el número de filas que aparecen, elija el ícono de engranaje en la esquina superior derecha de la sección para abrir el modal de preferencias. Actualice la configuración según sea necesario y seleccione **Confirmar**.

**Para supervisar y comprobar el estado de una actualización de instancias (consola)**

1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.

1. Seleccione la casilla situada junto al grupo de escalado automático. 

   Se abre un panel dividido en la parte inferior de la página.

1. En la pestaña **Instance refresh** (Actualización de instancias), en **Instance refresh history** (Historial de actualizaciones de instancias), puede determinar el estado de su solicitud en la columna **Status** (Estado). La operación entra en estado `Pending` mientras se está inicializando. A continuación, el estado debería cambiar rápidamente a `InProgress`. Cuando se actualizan todas las instancias, el estado cambia a `Successful`.

1. Para seguir supervisando el éxito o el fracaso de las actividades en curso, consulte las actividades de escalado del grupo. En la pestaña **Activity (Actividad)** en **Activity history (Historial de actividades)**, cuando se lanza la actualización de instancias, verá entradas cuando se terminan las instancias y otro conjunto de entradas cuando se lanzan las instancias. Si tiene numerosas actividades de escalado, puede ver más si elige el ícono **>** en la parte superior del historial de actividades. Para obtener información sobre la solución de problemas que podrían provocar el error de las actividades, consulte [Solución de problemas de Amazon EC2 Auto Scaling](CHAP_Troubleshooting.md).

1. (Opcional) En la pestaña **Administración de instancias**, en **Instancias**, puede revisar el progreso de instancias específicas según sea necesario.

------
#### [ AWS CLI ]

**Cómo supervisar y comprobar el estado de una actualización de instancias (AWS CLI)**  
Use el siguiente comando [describe-instance-refreshes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-instance-refreshes.html).

```
aws autoscaling describe-instance-refreshes --auto-scaling-group-name my-asg
```

A continuación, se muestra un ejemplo del resultado.

Las actualizaciones de las instancias se ordenan por hora de inicio. En primer lugar, se describen las actualizaciones de instancias que aún están en curso. 

```
{
  "InstanceRefreshes":[
    {
      "InstanceRefreshId":"08b91cf7-8fa6-48af-b6a6-d227f40f1b9b",
      "AutoScalingGroupName":"my-asg",
      "Status":"InProgress",
      "StatusReason":"Waiting for instances to warm up before continuing. For example: i-0645704820a8e83ff is warming up.",
      "StartTime":"2023-11-24T16:46:52+00:00",
      "PercentageComplete":50,
      "InstancesToUpdate":0,
      "Preferences":{
        "MaxHealthyPercentage":120,
        "MinHealthyPercentage":90,
        "InstanceWarmup":60,
        "SkipMatching":false,
        "AutoRollback":true,
        "ScaleInProtectedInstances":"Ignore",
        "StandbyInstances":"Ignore"
      }
    },
    {
      "InstanceRefreshId":"0e151305-1e57-4a32-a256-1fd14157c5ec",
      "AutoScalingGroupName":"my-asg",
      "Status":"Successful",
      "StartTime":"2023-11-22T13:53:37+00:00",
      "EndTime":"2023-11-22T13:59:45+00:00",
      "PercentageComplete":100,
      "InstancesToUpdate":0,
      "Preferences":{
        "MaxHealthyPercentage":120,
        "MinHealthyPercentage":90,
        "InstanceWarmup":60,
        "SkipMatching":false,
        "AutoRollback":true,
        "ScaleInProtectedInstances":"Ignore",
        "StandbyInstances":"Ignore"
      }
    }
  ]
}
```

Para seguir supervisando el éxito o el fracaso de las actividades en curso, consulte las actividades de escalado del grupo. Las actividades de escalado también le permiten obtener más detalles que le ayuden a solucionar problemas relacionados con la actualización de una instancia. Para obtener más información, consulte [Solución de problemas de Amazon EC2 Auto Scaling](CHAP_Troubleshooting.md).

------

## Estados de actualización de instancias
<a name="instance-refresh-statuses"></a>

Al iniciar una actualización de instancias, esta pasa al estado **Pending**. Pasa de **Pendiente** a **InProgress**hasta que llega a **Exitoso**, **Fallado RollbackSuccessful********, Cancelado** o **RollbackFailed**.

Una actualización de instancias puede tener los siguientes estados:


| Status | Description (Descripción) | 
| --- | --- | 
| Pendiente | Se creó la solicitud, pero la actualización de instancias no se ha iniciado. | 
| InProgress | Hay una actualización de instancias en curso. | 
| Successful | Se ha completado correctamente una actualización de instancias. | 
| Con error | No se ha podido completar la actualización de instancias. Puede solucionar problemas utilizando el motivo del estado y las actividades de escalado. | 
| Cancelling | Se está cancelando una actualización de instancias en curso. | 
| Cancelled | Se ha cancelado la actualización de instancias. | 
| RollbackInProgress | La actualización de instancias tiene un proceso de reversión en curso. | 
| RollbackFailed | No se ha podido completar la reversión. Puede solucionar problemas utilizando el motivo del estado y las actividades de escalado. | 
| RollbackSuccessful | Le reversión se ha completado correctamente. | 
| Incorporación | Tiempo de incorporación de espera especificado después de que la actualización de una instancia haya terminado de actualizar las instancias. | 

# Reemplace los volúmenes raíz durante la actualización de la instancia
<a name="replace-root-volume"></a>

**Topics**
+ [Funcionamiento](#start-instance-refresh-replace-root-volume-how-it-works)
+ [Requisitos](#start-instance-refresh-replace-root-volume-requirements)
+ [Inicia una actualización de instancias con Replace Root Volume](#start-instance-refresh-replace-root-volume-cli)
+ [Limitaciones](#start-instance-refresh-replace-root-volume-limitations)
+ [Utilice enlaces de ciclo de vida para reemplazar el volumen raíz](#replace-root-volume-lifecycle-hooks)

## Funcionamiento
<a name="start-instance-refresh-replace-root-volume-how-it-works"></a>

La sustitución del volumen raíz actualiza las instancias sustituyendo únicamente el volumen raíz de EBS y, al mismo tiempo, mantiene la instancia en ejecución. Esto elimina la necesidad de lanzar nuevas instancias y evita posibles restricciones de capacidad. Este proceso preserva todos los demás recursos de la instancia, incluidos:
+ Interfaces de red y direcciones IP 
+ Volúmenes de EBS que no son raíz 
+ Volúmenes y datos del almacén de instancias 
+ Grupos de seguridad y funciones de IAM 

Durante la sustitución del volumen raíz, la aplicación sigue ejecutándose en la instancia existente. El volumen raíz original se separa, se crea un nuevo volumen raíz a partir de la AMI especificada y, a continuación, se adjunta a la misma instancia. Los volúmenes raíz originales se eliminan automáticamente después de reemplazarlos correctamente.

Cuando utilizas la estrategia de reemplazar el volumen raíz, las instancias pasan por los siguientes estados del ciclo de vida:

1. `ReplacingRootVolume`- Comienza el reemplazo del volumen raíz

1. `ReplacingRootVolume:Wait`- Espera a que finalice el ciclo de vida del enlace (si está configurado)

1. `ReplacingRootVolume:Proceed`- Procede con el reemplazo

1. `RootVolumeReplaced`- El reemplazo se completó correctamente

Una vez completada la sustitución del volumen raíz, Auto Scaling realiza comprobaciones de estado en las instancias actualizadas. Si se produce un error al reemplazar el volumen raíz de una instancia, Auto Scaling marca esa instancia para su finalización y la reemplaza por una nueva instancia.

## Requisitos
<a name="start-instance-refresh-replace-root-volume-requirements"></a>
+ Su grupo de Auto Scaling debe usar una política de instancias mixtas
+ Todas las anulaciones de la política de instancias mixtas deben especificar una `ImageId` 
+ AMIs debe contener solo un volumen raíz
+ Todas las instancias deben coincidir con la configuración de la plantilla de lanzamiento del grupo
+ Debe iniciar la actualización de la instancia con la configuración deseada que tenga una política de instancias mixtas que contenga `ImageId` anulaciones. 

## Inicia una actualización de instancias con Replace Root Volume
<a name="start-instance-refresh-replace-root-volume-cli"></a>

**Para iniciar una actualización de instancias con Replace Root Volume (AWS CLI)**  
Usa el siguiente [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando para iniciar una actualización de instancias desde AWS CLI. Puede especificar las preferencias que desee cambiar en un archivo de configuración JSON. Cuando haga referencia al archivo de configuración, proporcione la ruta y el nombre del archivo como se muestra en el ejemplo siguiente. 

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenido de `config.json`: 

**Example**  

```
{
  "AutoScalingGroupName": "my-asg",
  "Strategy" : "ReplaceRootVolume",
  "DesiredConfiguration":{
    "MixedInstancesPolicy":{
      "LaunchTemplate": {
        "LaunchTemplateSpecification": {
          "LaunchTemplateId":"my-launch-template",
          "Version": "1"
        },
        "Overrides": [
          {
            "InstanceType":"c5.large",
            "ImageId":"ami-1234example"
          },
          {
            "InstanceType":"m5.large",
            "ImageId":"ami-2345example"
          }
        ]
      }
    }
  },
  "Preferences": {
    "InstanceWarmup": 60,
    "MinHealthyPercentage": 90,
    "AutoRollback": true,
    "ScaleInProtectedInstances": Ignore,
    "StandbyInstances": Ignore
  }
}
```

Si no se proporcionan preferencias, se usan los valores predeterminados. Para obtener más información, consulte [Comprensión de los valores predeterminados de una actualización de instancias](understand-instance-refresh-default-values.md). 

Ejemplo de código de salida:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

## Limitaciones
<a name="start-instance-refresh-replace-root-volume-limitations"></a>
+ No puede iniciar una actualización de instancias con Replace Root Volume si el grupo Auto Scaling de EC2 o la configuración de actualización de instancias deseada utilizan la versión de plantilla de lanzamiento `$Default` o `$Latest` la versión de actualización de instancias.
+ No puede iniciar una actualización de instancias con Replace Root Volume en un grupo Amazon EC2 Auto Scaling si contiene instancias cuyo tipo de instancia no esté presente en la política de instancias mixtas.
+ Durante una actualización de instancias con Replace Root Volume, solo puede adjuntar instancias con los tipos que estén presentes en la política de instancias mixtas de la configuración deseada.
+ No puede iniciar una actualización de instancias con Replace Root Volume en un grupo de Auto Scaling Group de EC2 que tenga una piscina caliente.
+ No puede añadir un pool caliente a un grupo de Amazon EC2 Auto Scaling que tenga una actualización de instancias activa con Replace Root Volume.

## Utilice enlaces de ciclo de vida para reemplazar el volumen raíz
<a name="replace-root-volume-lifecycle-hooks"></a>

Las instancias que se someten a un reemplazo de volumen raíz siguen sus propias transiciones de ciclo de vida, lo que le permite invocar acciones (por ejemplo, una función Lambda) and/or antes y después del reemplazo. Para obtener más información sobre los estados del ciclo de vida durante el reemplazo del volumen raíz, consulte. [Transiciones de estado del ciclo de vida de las instancias que se están reemplazando por volúmenes](lifecycle-hooks-overview.md#rvr-lifecycle-state-transitions)

Para obtener más información acerca de cómo agregar un enlace de ciclo de vida, consulte [Incorporación de los enlaces de ciclo de vida en su grupo de escalado automático](adding-lifecycle-hooks.md). Para obtener más información sobre cómo completar una acción de ciclo de vida, consulte [Cómo completar una acción del ciclo de vida en un grupo de escalado automático](completing-lifecycle-hooks.md).

Antes de reemplazar el volumen raíz, un enlace durante el ciclo de vida puede resultar útil en los siguientes escenarios:
+ Debes cerrar la aplicación correctamente antes de reemplazar el volumen raíz y reiniciar la instancia.
+ Desea mover los datos del volumen raíz a otra ubicación antes de reemplazar el volumen.

Tras reemplazar el volumen raíz, un enlace durante el ciclo de vida puede resultar útil en los siguientes escenarios:
+ Desea comprobar que la instancia está totalmente lista con la nueva AMI antes de que comience a recibir tráfico.
+ Desea iniciar los datos de la aplicación que existían anteriormente en el volumen raíz.

Cuando agregue enlaces de ciclo de vida, tenga en cuenta lo siguiente:
+ Cuando se configura un enlace de ciclo de vida para la acción `autoscaling:EC2_INSTANCE_TERMINATING` del ciclo de vida, una instancia a punto de ser sustituida por un volumen raíz se detiene para realizar una acción personalizada cuando alcanza el `ReplacingRootVolume:Wait` estado.
+ Cuando se configura un enlace de ciclo de vida para la acción `autoscaling:EC2_INSTANCE_LAUNCHING` del ciclo de vida, una instancia a la que se le acaba de reemplazar su volumen raíz se detiene para realizar una acción personalizada cuando alcanza el `Pending:Wait` estado.

Cuando las instancias alcanzan un estado de espera, Amazon EC2 Auto Scaling envía una notificación. Las notificaciones de enlace del ciclo de vida de Auto Scaling contienen un `Action` campo con un valor `ReplaceRootVolume` que indica que la instancia se está sustituyendo por el volumen raíz.

En la EventBridge sección de esta guía encontrará ejemplos de estas notificaciones. Para obtener más información, consulte [La actualización de instancias reemplaza los eventos del ciclo de vida del volumen raíz](instance-refresh-eventbridge-events.md#instance-refresh-rvr-lifecycle-events).

# Cancela la actualización de una instancia mediante Consola de administración de AWS o AWS CLI
<a name="cancel-instance-refresh"></a>

Puede cancelar una actualización de instancias que todavía está en curso. No puede cancelarla después de que haya terminado.

La cancelación de una actualización de instancias no revierte ninguna instancia que ya se haya reemplazado. Para revertir los cambios en las instancias, haga una reversión en su lugar. Para obtener más información, consulte [Inversión de cambios con una reversión manual o automática](instance-refresh-rollback.md).

**Topics**
+ [Cancelación de una actualización de instancias (consola)](#cancel-instance-refresh-console)
+ [Cancelación de una actualización de instancias (AWS CLI)](#cancel-instance-refresh-cli)

## Cancelación de una actualización de instancias (consola)
<a name="cancel-instance-refresh-console"></a>

**Cómo cancelar una actualización de instancias**

1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.

1. Seleccione la casilla situada junto al grupo de escalado automático.

1. En la pestaña **Actualización de instancias** en **Actualización de instancias activa**, elija **Acciones**, **Cancelar**.

1. Cuando deba confirmar la selección, haga clic en **Confirm (Confirmar)**.

El estado de la actualización de instancias se establece en **Cancelling‭**. Una vez finalizada la cancelación, el estado de la actualización de instancias se establece en **Cancelled**.

## Cancelación de una actualización de instancias (AWS CLI)
<a name="cancel-instance-refresh-cli"></a>

**Cómo cancelar una actualización de instancias**  
Utilice el [cancel-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/cancel-instance-refresh.html)comando de AWS CLI y proporcione el nombre del grupo de Auto Scaling. 

```
aws autoscaling cancel-instance-refresh --auto-scaling-group-name my-asg
```

Ejemplo de código de salida:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

**Cómo cancelar una actualización de instancias sin esperar a que se produzca la transición de instancias**  
Utilice la `--no-wait-for-transitioning-instances` opción con el [cancel-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/cancel-instance-refresh.html)comando de AWS CLI para cancelar la actualización de una instancia sin tener que esperar a que las instancias estén en transición.

```
aws autoscaling cancel-instance-refresh —auto-scaling-group-name my-asg --no-wait-for-transitioning-instances
```

Por defecto, cuando cancela una actualización de instancias, Amazon EC2 Auto Scaling espera a que se completen todos los lanzamientos y terminaciones en curso antes de establecer el estado en **Cancelado**. Si tiene instancias con periodos de inactividad prolongados o necesita iniciar una nueva actualización de instancias inmediatamente, puede usar el comando para no tener que esperar a que se produzcan estas operaciones de transición.

Con esta opción, el estado de actualización de la instancia cambia a **Cancelado**, lo que permite iniciar una nueva actualización de la instancia. Todos los lanzamientos y terminaciones en curso continúan funcionando en segundo plano.

# Inversión de cambios con una reversión manual o automática
<a name="instance-refresh-rollback"></a>

Puede revertir una actualización de instancias que todavía está en curso. No puede revertirla después de que haya terminado. Sin embargo, puede volver a actualizar el grupo de escalado automático si inicia una nueva actualización de instancias.

Al hacer la reversión, Amazon EC2 Auto Scaling reemplaza las instancias que se han implementado hasta ahora. Las nuevas instancias coinciden con la configuración que guardó por última vez en el grupo de escalado automático antes de iniciar la actualización de instancias.

Amazon EC2 Auto Scaling ofrece las siguientes formas de revertir cambios:
+ Reversión manual: se inicia una reversión manualmente para invertir lo que se implementó hasta el punto de reversión.
+ Reversión automática: Amazon EC2 Auto Scaling revierte automáticamente lo que se implementó si la actualización de la instancia falla por algún motivo o si CloudWatch alguna de las alarmas que especifique entra en ese estado. `ALARM`

**Topics**
+ [Consideraciones](#instance-refresh-rollback-considerations)
+ [Inicio manual de una reversión](#instance-refresh-manual-rollback)
+ [Inicio de una actualización de instancias con reversión automática](#instance-refresh-using-auto-rollback)

## Consideraciones
<a name="instance-refresh-rollback-considerations"></a>

Las siguientes consideraciones se aplican cuando se utiliza una reversión:
+ La opción de reversión solo está disponible si especifica la configuración deseada como parte del inicio de una actualización de instancias.
+ Solo puede revertir a una versión anterior de una plantilla de lanzamiento si la versión es una versión numerada específica. La opción de reversión no está disponible si el grupo de escalado automático está configurado para usar la versión de plantilla `$Latest` o `$Default`. 
+ Tampoco puede volver a una plantilla de lanzamiento que esté configurada para usar un alias de AMI del almacén de AWS Systems Manager parámetros.
+ La configuración que guardó por última vez en el grupo de escalado automático debe encontrarse en un estado estable. Si no está en un estado estable, el flujo de trabajo de reversión seguirá ejecutándose, pero al final se producirá un error. Hasta que no se resuelva el problema, es posible que el grupo de escalado automático se encuentre en un estado de error y ya no pueda lanzar instancias correctamente. Esto podría afectar a la disponibilidad del servicio o la aplicación.

## Inicio manual de una reversión
<a name="instance-refresh-manual-rollback"></a>

------
#### [ Console ]

**Inicio manual de una reversión de una actualización de instancias (consola)**

1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.

1. Seleccione la casilla situada junto al grupo de escalado automático.

1. En la pestaña **Actualización de instancias** en **Actualización de instancias activa**, elija **Acciones**, **Iniciar reversión**.

1. Cuando deba confirmar la selección, haga clic en **Confirm (Confirmar)**.

------
#### [ AWS CLI ]

**Inicio manual de una reversión de una actualización de instancias (AWS CLI)**  
Utilice el [rollback-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/rollback-instance-refresh.html)comando de AWS CLI y proporcione el nombre del grupo de Auto Scaling. 

```
aws autoscaling rollback-instance-refresh --auto-scaling-group-name my-asg
```

Ejemplo de código de salida:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

**sugerencia**  
Si este comando arroja un error, asegúrese de haber actualizado la versión AWS CLI local a la última versión.

------

## Inicio de una actualización de instancias con reversión automática
<a name="instance-refresh-using-auto-rollback"></a>

Con la función de reversión automática, puedes revertir automáticamente la actualización de la instancia cuando se produce un error, por ejemplo, cuando hay errores o cuando se activa una CloudWatch alarma de Amazon específica`ALARM`.

Si habilita la reversión automática y se producen errores al reemplazar las instancias, la actualización de instancias intentará completar todas las sustituciones durante una hora antes de que se produzca un error y se revierta. Por lo general, estos errores se deben a errores en el lanzamiento de EC2, a una mala configuración de las comprobaciones de estado o a que no se ignoran ni permiten la finalización de las instancias que están en el estado `Standby` o protegidas contra la reducción horizontal.

La especificación de CloudWatch las alarmas es opcional. Para especificar una alarma, primero tiene que crearla. Puede especificar alarmas de métricas y alarmas compuestas. Para obtener información sobre cómo crear la alarma, consulta la [Guía del CloudWatch usuario de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). Si utiliza las métricas de Elastic Load Balancing como ejemplo, si utiliza un equilibrador de carga de aplicación, puede utilizar las métricas `HTTPCode_ELB_5XX_Count` y `HTTPCode_ELB_4XX_Count`.

**Consideraciones**
+ Si especificas una CloudWatch alarma pero no habilitas la reversión automática y el estado de alarma pasa a`ALARM`, la actualización de la instancia fallará sin revertirla.
+ Puede elegir un máximo de 10 alarmas al iniciar una actualización de instancias.
+ Al elegir una CloudWatch alarma, la alarma debe estar en un estado compatible. Si el estado de la alarma es `INSUFFICIENT_DATA` o `ALARM`, recibirá un error al intentar iniciar la actualización de instancias. 
+ Al crear una alarma para que la utilice Amazon EC2 Auto Scaling, la alarma debe incluir cómo gestionar los puntos de datos faltantes. Si a una métrica le faltan puntos de datos por diseño, el estado de la alarma es `INSUFFICIENT_DATA` durante esos períodos. Cuando esto ocurre, Amazon EC2 Auto Scaling no puede instancias hasta que se encuentren nuevos puntos de datos. Para forzar la alarma a fin de mantener el estado anterior `ALARM` o `OK`, puede optar por ignorar los datos que faltan en su lugar. Para obtener más información, consulta [Cómo configurar el modo en que las alarmas tratan los datos faltantes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data) en la *Guía del CloudWatch usuario de Amazon*.

------
#### [ Console ]

**Inicio de una actualización de instancias con reversión automática (consola)**

1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.

1. Seleccione la casilla situada junto al grupo de escalado automático.

1. En la pestaña **Instance refresh** (Actualización de instancias) en **Active Instance refresh** (Actualización de instancias activas), elija **Start instance refresh** (Iniciar actualización de instancias).

1. Siga el procedimiento [Inicio de una actualización de instancias (consola)](start-instance-refresh.md#start-instance-refresh-console) y configure su actualización de instancia según sea necesario.

1. (Opcional) En **Actualizar la configuración**, para la **CloudWatch alarma**, seleccione **Activar CloudWatch alarmas** y, a continuación, elija una o más alarmas para identificar cualquier problema y hacer que no funcione si se activa una alarma`ALARM`.

1. En **Configuración de reversión**, seleccione **Habilitar la reversión automática** para revertir automáticamente una actualización de instancias fallida a la configuración que guardó por última vez en el grupo de escalado automático antes de iniciar la actualización de instancias.

1. Revise sus selecciones y, a continuación, elija **Iniciar la actualización de instancias**. 

------
#### [ AWS CLI ]

**Inicio de una actualización de instancias con reversión automática (AWS CLI)**  
Utilice el [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando y especifique `true` la `AutoRollback` opción en`Preferences`. 

En el siguiente ejemplo, se muestra cómo iniciar una actualización de instancias que se revertirá automáticamente si se produce algún error. Sustituya los valores del parámetro *`italicized`* por sus propios valores.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenido de `config.json`.

```
{
    "AutoScalingGroupName": "my-asg",
    "DesiredConfiguration": {
      "LaunchTemplate": {
          "LaunchTemplateName": "my-launch-template",
          "Version": "1"
       }
    },
    "Preferences": {
      "AutoRollback": true
    }
}
```

Como alternativa, para revertir automáticamente la actualización de la instancia cuando se produce un error en la actualización de la instancia o cuando una CloudWatch alarma específica está en ese `ALARM` estado, especifique la `AlarmSpecification` opción `Preferences` y proporcione el nombre de la alarma, como en el siguiente ejemplo. Sustituya los valores del parámetro *`italicized`* por sus propios valores.

```
{
    "AutoScalingGroupName": "my-asg",
    "DesiredConfiguration": {
      "LaunchTemplate": {
          "LaunchTemplateName": "my-launch-template",
          "Version": "1"
       }
    },
    "Preferences": {
      "AutoRollback": true,
      "AlarmSpecification": { "Alarms": [ "my-alarm" ] }
    }
}
```

Si se ejecuta correctamente, el comando devolverá información similar a la siguiente.

```
{
  "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

**sugerencia**  
Si este comando arroja un error, asegúrate de haber actualizado la versión AWS CLI local a la última versión.

------

# Uso de una actualización de instancias con la omisión de coincidencias
<a name="asg-instance-refresh-skip-matching"></a>

La opción de omisión de coincidencias le dice a Amazon EC2 Auto Scaling que ignore las instancias que ya tienen sus actualizaciones más recientes. De esta forma, no reemplaza más instancias de las necesarias. Esto es útil cuando quiere asegurarse de que su grupo de escalado automático utilice una versión determinada de la plantilla de lanzamiento y solo sustituya las instancias que usan una versión diferente.

Tenga en cuenta las siguientes consideraciones para omitir coincidencias:
+ Si comienza una actualización de instancias con la omisión de coincidencias y una *configuración deseada*, Amazon EC2 Auto Scaling comprueba si hay instancias que coincidan con su configuración deseada. A continuación, solo reemplaza las instancias que no coincidan con la configuración deseada. Cuando la actualización de instancias se lleva a cabo correctamente, Amazon EC2 Auto Scaling actualiza el grupo para que coincida con la configuración deseada. 
+ Si omite las coincidencias al iniciar una actualización de instancias, pero no especifica la configuración deseada, Amazon EC2 Auto Scaling comprobará si alguna instancia coincide con la configuración que guardó por última vez en el grupo de escalado automático. A continuación, solo reemplaza las instancias que no coincidan con la última configuración guardada.
+ Puede utilizar la omisión de coincidencias con una nueva plantilla de lanzamiento, una nueva versión de la plantilla de lanzamiento actual o un conjunto de tipos de instancia. Si habilita la omisión de coincidencias, pero ninguna de estas opciones cambia, la actualización de instancias se ejecutará inmediatamente sin reemplazar ninguna instancia. Si ha efectuado otros cambios en la configuración deseada (como cambiar la estrategia de asignación de spot), Amazon EC2 Auto Scaling espera a que se realice correctamente la actualización de instancias. A continuación, actualiza la configuración del grupo de escalado automático para reflejar la nueva configuración deseada. 
+ No puede utilizar la omisión de coincidencias con una configuración de lanzamiento nueva.
+ Al iniciar una actualización de instancias y proporcionar una configuración deseada, Amazon EC2 Auto Scaling se asegura de que todas las instancias utilicen la configuración deseada. Por lo tanto, si especifica `$Default` o `$Latest` como la versión deseada para su plantilla de lanzamiento y, a continuación, crea una nueva versión de la plantilla de lanzamiento mientras se está actualizando la instancia, todas las instancias que ya se hayan reemplazado volverán a sustituirse.
+ La omisión de coincidencias no sabe si un script de datos de usuario de la plantilla de lanzamiento extraerá el código actualizado y lo instalará en nuevas instancias. Como resultado, es posible que, al omitir las coincidencias, no se reemplacen las instancias que tengan instalado un código desactualizado. En este caso, debe desactivar la omisión de coincidencias para asegurarse de que todas las instancias reciban el código más reciente, incluso sin actualizar la versión de la plantilla de inicialziación.

En esta sección se incluyen AWS CLI instrucciones para iniciar una actualización de instancias con la opción de omisión de coincidencias habilitada. Para obtener instrucciones sobre cómo utilizar la consola, consulte [Inicio de una actualización de instancias (consola)](start-instance-refresh.md#start-instance-refresh-console).

## Omisión de coincidencias (procedimiento básico)
<a name="skip-matching"></a>

Siga los pasos de esta sección para utilizar el y AWS CLI hacer lo siguiente:
+ Cree la plantilla de lanzamiento que quiera aplicar a las instancias.
+ Comience una actualización de instancias para aplicar la plantilla de lanzamiento a un grupo de escalado automático. Si no habilita la omisión de coincidencias, se reemplazarán todas las instancias. Esto se aplica incluso si la plantilla de lanzamiento utilizada para aprovisionar la instancia es la misma que se especificó para la configuración deseada.

**Uso de la omisión de coincidencias con una nueva plantilla de lanzamiento**

1. Use el [create-launch-template](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-launch-template.html)comando para crear una nueva plantilla de lanzamiento para su grupo de Auto Scaling. Incluya la opción `--launch-template-data` y la entrada JSON que define los detalles de las instancias que se crean para el grupo de escalado automático.

   Por ejemplo, utilice el siguiente comando para crear una plantilla de lanzamiento básica con el ID de AMI *`ami-0123456789abcdef0`* y el tipo de instancia `t2.micro`.

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

   Si se ejecuta correctamente, el comando devolverá información similar a la siguiente.

   ```
   {
      "LaunchTemplate": {
        "LaunchTemplateId": "lt-068f72b729example",
        "LaunchTemplateName": "my-template-for-auto-scaling",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "CreateTime": "2023-01-30T18:16:06.000Z",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
     }
   }
   ```

   Para obtener más información, consulte [Ejemplos de creación y administración de plantillas de lanzamiento con AWS CLI](examples-launch-templates-aws-cli.md).

1. Usa el [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando para iniciar el flujo de trabajo de reemplazo de instancias y aplica tu nueva plantilla de lanzamiento con el ID*`lt-068f72b729example`*. Como la plantilla de lanzamiento es nueva, solo tiene una versión. Esto significa que la versión `1` de la plantilla de lanzamiento es el objetivo de esta actualización de instancias. Si se produce un evento de escalado horizontal durante la actualización de instancias y Amazon EC2 Auto Scaling aprovisiona nuevas instancias con la versión `1` de esta plantilla de lanzamiento, no se reemplazarán. Cuando se finaliza adecuadamente la operación, la nueva plantilla de lanzamiento se aplica de manera correcta en un grupo de escalado automático. 

   ```
   aws autoscaling start-instance-refresh --cli-input-json file://config.json
   ```

   Contenido de `config.json`.

   ```
   {
       "AutoScalingGroupName": "my-asg",
       "DesiredConfiguration": {
         "LaunchTemplate": {
             "LaunchTemplateId": "lt-068f72b729example",
             "Version": "$Default"
          }
       },
       "Preferences": {
         "SkipMatching": true
       }
   }
   ```

   Si se ejecuta correctamente, el comando devolverá información similar a la siguiente.

   ```
   {
     "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
   }
   ```

## Omisión de coincidencias (grupos de instancias mixtas)
<a name="skip-matching-mixed-instances-group"></a>

Si tiene un grupo de Auto Scaling con una [política de instancias mixtas](ec2-auto-scaling-mixed-instances-groups.md), siga los pasos de esta sección AWS CLI para iniciar una actualización de instancias con la opción de omitir la coincidencia. Dispone de las opciones siguientes:
+ Proporcione una nueva plantilla de lanzamiento para aplicarla a todos los tipos de instancias especificados en la política.
+ Proporcione un conjunto actualizado de tipos de instancias cambiando o sin cambiar la plantilla de lanzamiento de la política. Por ejemplo, es posible que quiera alejarse de los tipos de instancias no deseados. Usaría la plantilla de lanzamiento tal como está, sin cambiar la AMI, los grupos de seguridad ni otros detalles de las instancias que se van a reemplazar.

Siga los pasos de una de las siguientes secciones, en función de la opción que se adapte a sus necesidades.

**Uso de la omisión de coincidencias con una nueva plantilla de lanzamiento**

1. Use el [create-launch-template](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-launch-template.html)comando para crear una nueva plantilla de lanzamiento para su grupo de Auto Scaling. Incluya la opción `--launch-template-data` y la entrada JSON que define los detalles de las instancias que se crean para el grupo de escalado automático.

   Por ejemplo, utilice el siguiente comando para crear una plantilla de lanzamiento con el ID de AMI *`ami-0123456789abcdef0`*.

   ```
   aws ec2 create-launch-template --launch-template-name my-new-template --version-description version1 \
     --launch-template-data '{"ImageId":"ami-0123456789abcdef0"}'
   ```

   Si se ejecuta correctamente, el comando devolverá información similar a la siguiente.

   ```
   {
      "LaunchTemplate": {
        "LaunchTemplateId": "lt-04d5cc9b88example",
        "LaunchTemplateName": "my-new-template",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "CreateTime": "2023-01-31T15:56:02.000Z",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
     }
   }
   ```

   Para obtener más información, consulte [Ejemplos de creación y administración de plantillas de lanzamiento con AWS CLI](examples-launch-templates-aws-cli.md).

1. Para ver la política de instancias mixtas existente para su grupo de Auto Scaling, ejecute el [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)comando. Necesitará esta información en el siguiente paso, cuando inicie la actualización de instancias.

   El siguiente comando de ejemplo devuelve la política de instancias mixtas configurada para el grupo de escalado automático denominado *`my-asg`*.

   ```
   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name my-asg
   ```

   Si se ejecuta correctamente, el comando devolverá información similar a la siguiente.

   ```
   {
     "AutoScalingGroups":[
       {
         "AutoScalingGroupName":"my-asg",
         "AutoScalingGroupARN":"arn",
         "MixedInstancesPolicy":{
           "LaunchTemplate":{
             "LaunchTemplateSpecification":{
               "LaunchTemplateId":"lt-073693ed27example",
               "LaunchTemplateName":"my-old-template",
               "Version":"$Default"
             },
             "Overrides":[
               {
                 "InstanceType":"c5.large"
               },
               {
                 "InstanceType":"c5a.large"
               },
               {
                 "InstanceType":"m5.large"
               },
               {
                 "InstanceType":"m5a.large"
               }
             ]
           },
           "InstancesDistribution":{
             "OnDemandAllocationStrategy":"prioritized",
             "OnDemandBaseCapacity":1,
             "OnDemandPercentageAboveBaseCapacity":50,
             "SpotAllocationStrategy":"price-capacity-optimized"
           }
         },
         "MinSize":1,
         "MaxSize":5,
         "DesiredCapacity":4,
         ...
       }
     ]
   }
   ```

1. Usa el [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando para iniciar el flujo de trabajo de reemplazo de instancias y aplica tu nueva plantilla de lanzamiento con el ID*`lt-04d5cc9b88example`*. Como la plantilla de lanzamiento es nueva, solo tiene una versión. Esto significa que la versión `1` de la plantilla de lanzamiento es el objetivo de esta actualización de instancias. Si se produce un evento de escalado horizontal durante la actualización de instancias y Amazon EC2 Auto Scaling aprovisiona nuevas instancias con la versión `1` de esta plantilla de lanzamiento, no se reemplazarán. Cuando se finaliza adecuadamente la operación, la política de instancias mixtas se aplica de manera correcta en un grupo de escalado automático.

   ```
   aws autoscaling start-instance-refresh --cli-input-json file://config.json
   ```

   Contenido de `config.json`.

   ```
   {
     "AutoScalingGroupName":"my-asg",
     "DesiredConfiguration":{
       "MixedInstancesPolicy":{
         "LaunchTemplate":{
           "LaunchTemplateSpecification":{
             "LaunchTemplateId":"lt-04d5cc9b88example",
             "Version":"$Default"
           },
           "Overrides":[
             {
               "InstanceType":"c5.large"
             },
             {
               "InstanceType":"c5a.large"
             },
             {
               "InstanceType":"m5.large"
             },
             {
               "InstanceType":"m5a.large"
             }
           ]
         },
         "InstancesDistribution":{
           "OnDemandAllocationStrategy":"prioritized",
           "OnDemandBaseCapacity":1,
           "OnDemandPercentageAboveBaseCapacity":50,
           "SpotAllocationStrategy":"price-capacity-optimized"
           }
         }
       }
     },
     "Preferences":{
       "SkipMatching":true
     }
   }
   ```

   Si se ejecuta correctamente, el comando devolverá información similar a la siguiente.

   ```
   {
     "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
   }
   ```

En el siguiente procedimiento, proporcionará un conjunto actualizado de tipos de instancias sin cambiar la plantilla de lanzamiento. 

**Para utilizar la omisión de coincidencias con un conjunto actualizado de tipos de instancias**

1. Para ver la política de instancias mixtas existente para su grupo de Auto Scaling, ejecute el [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)comando. Necesitará esta información en el siguiente paso, cuando inicie la actualización de instancias.

   El siguiente comando de ejemplo devuelve la política de instancias mixtas configurada para el grupo de escalado automático denominado *`my-asg`*.

   ```
   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name my-asg
   ```

   Si se ejecuta correctamente, el comando devolverá información similar a la siguiente.

   ```
   {
     "AutoScalingGroups":[
       {
         "AutoScalingGroupName":"my-asg",
         "AutoScalingGroupARN":"arn",
         "MixedInstancesPolicy":{
           "LaunchTemplate":{
             "LaunchTemplateSpecification":{
               "LaunchTemplateId":"lt-073693ed27example",
               "LaunchTemplateName":"my-template-for-auto-scaling",
               "Version":"$Default"
             },
             "Overrides":[
               {
                 "InstanceType":"c5.large"
               },
               {
                 "InstanceType":"c5a.large"
               },
               {
                 "InstanceType":"m5.large"
               },
               {
                 "InstanceType":"m5a.large"
               }
             ]
           },
           "InstancesDistribution":{
             "OnDemandAllocationStrategy":"prioritized",
             "OnDemandBaseCapacity":1,
             "OnDemandPercentageAboveBaseCapacity":50,
             "SpotAllocationStrategy":"price-capacity-optimized"
           }
         },
         "MinSize":1,
         "MaxSize":5,
         "DesiredCapacity":4,
         ...
       }
     ]
   }
   ```

1. Utilice el [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando para iniciar el flujo de trabajo de reemplazo de instancias y aplicar las actualizaciones. Si quiere reemplazar las instancias que utilizan tipos de instancia específicos, la configuración deseada debe especificar la política de instancias mixtas solo con los tipos de instancia deseados. Puede elegir si quiere agregar nuevos tipos de instancias en su lugar.

   El siguiente comando de ejemplo inicia una actualización de instancias sin el tipo de instancia no deseado *`m5a.large`*. Cuando un tipo de instancia del grupo no coincide con ninguno de los tres tipos de instancias, las instancias se reemplazan. (Tenga en cuenta que una actualización de instancias no elige los tipos de instancia desde los que aprovisionar las nuevas instancias; en su lugar, lo hacen las [estrategias de asignación](allocation-strategies.md)). Cuando se finaliza adecuadamente la operación, la política de instancias mixtas se aplica de manera correcta en un grupo de escalado automático.

   ```
   aws autoscaling start-instance-refresh --cli-input-json file://config.json
   ```

   Contenido de `config.json` 

   ```
   {
     "AutoScalingGroupName":"my-asg",
     "DesiredConfiguration":{
       "MixedInstancesPolicy":{
         "LaunchTemplate":{
           "LaunchTemplateSpecification":{
             "LaunchTemplateId":"lt-073693ed27example",
             "Version":"$Default"
           },
           "Overrides":[
             {
               "InstanceType":"c5.large"
             },
             {
               "InstanceType":"c5a.large"
             },
             {
               "InstanceType":"m5.large"
             }
           ]
         },
         "InstancesDistribution":{
           "OnDemandAllocationStrategy":"prioritized",
           "OnDemandBaseCapacity":1,
           "OnDemandPercentageAboveBaseCapacity":50,
           "SpotAllocationStrategy":"price-capacity-optimized"
           }
         }
       }
     },
     "Preferences":{
       "SkipMatching":true
     }
   }
   ```

# Agregar puntos de control a una actualización de instancias
<a name="asg-adding-checkpoints-instance-refresh"></a>

Al utilizar una actualización de instancias, puede elegir reemplazar instancias por fases, de modo que pueda hacer verificaciones en las instancias a medida que avanza. Para realizar un reemplazo por fases, agregue puntos de control, que son puntos en el tiempo en los que se detiene la actualización de instancias. El uso de puntos de control le ofrece un mayor control sobre cómo elige actualizar el grupo de Auto Scaling. Lo ayuda a confirmar que la aplicación va a funcionar de manera fiable y predecible.

**Topics**
+ [Funcionamiento](#instance-refresh-checkpoints-how-it-works)
+ [Consideraciones](#instance-refresh-checkpoints-considerations)
+ [Habilitación de los puntos de control](enable-checkpoints-console-cli.md)

## Funcionamiento
<a name="instance-refresh-checkpoints-how-it-works"></a>

Al comenzar una actualización de instancias, debe especificar los puntos de control como porcentajes del número total de instancias del grupo de escalado automático. Estos puntos de control indican el porcentaje mínimo de instancias del grupo de escalado automático que deben ser instancias nuevas antes de que se considere que se ha alcanzado el punto de control. Por ejemplo, si sus puntos de control son `[20, 50, 100]`, el primer punto de control se alcanza cuando el 20 por ciento de las instancias son nuevas; el segundo, cuando el 50 por ciento son nuevas; y el punto de control final, cuando todas las instancias son nuevas. 

Amazon EC2 Auto Scaling ajusta el ritmo de los reemplazos de instancias para cumplir con los porcentajes de puntos de control especificados y, al mismo tiempo, mantiene el porcentaje de buen estado mínimo del grupo. Para alcanzar un porcentaje de puntos de control, Amazon EC2 Auto Scaling a veces reemplaza menos, pero nunca más, de lo que permite el porcentaje de buen estado mínimo.

Considere el siguiente grupo de escalado automático que tiene 10 instancias. Los porcentajes de punto de control son `[20,50,100]`; el porcentaje de buen estado mínimo es del 80 por ciento y el porcentaje máximo en buen estado‭ es del 100 por ciento. Para mantener el porcentaje de buen estado mínimo, solo pueden reemplazarse dos instancias por vez. En el siguiente diagrama se resume el proceso de reemplazo de instancias antes de que se alcance un punto de control.

![\[En este diagrama se muestra cómo los puntos de control afectan al flujo de una actualización de instancias.\]](http://docs.aws.amazon.com/es_es/autoscaling/ec2/userguide/images/checkpoints-instance-refresh.png)


En el ejemplo anterior, hay un período de preparación de instancias para cada nueva instancia que se inicie. También puede que tenga un enlace de ciclo de vida que ponga una instancia en estado de espera y luego realice una acción personalizada durante el proceso de lanzamiento o terminación. 

Amazon EC2 Auto Scaling emite eventos para cada punto de control, excepto para el 100 por ciento. Puede añadir una EventBridge regla para enviar los eventos a un destino como Amazon SNS. De esta forma, recibirá una notificación cuando pueda ejecutar las verificaciones necesarias. Para obtener más información, consulte [Cree EventBridge reglas (por ejemplo, actualice los eventos)](monitor-events-eventbridge-sns.md).

## Consideraciones
<a name="instance-refresh-checkpoints-considerations"></a>

Tenga en cuenta las siguientes consideraciones al utilizar puntos de control:
+ Dado que los puntos de control se basan en porcentajes, el número de instancias que se reemplazan cambia con el tamaño del grupo. Cuando se produce una actividad de escalado horizontal y aumenta el tamaño del grupo, una operación en curso podría volver a alcanzar un punto de control. Si sucede esto, Amazon EC2 Auto Scaling envía otra notificación y repite el tiempo de espera entre los puntos de control antes de continuar.
+ Es posible omitir un punto de control bajo ciertas circunstancias. Por ejemplo, supongamos que el grupo de Auto Scaling tiene dos instancias y los porcentajes de puntos de control son `[10,40,100]`. Una vez reemplazada la primera instancia, Amazon EC2 Auto Scaling calcula que se reemplazó el 50 por ciento del grupo. Debido a que el 50 por ciento es mayor que los dos primeros puntos de control, omite el primer punto de control (`10`) y envía una notificación para el segundo punto de control (`40`).
+ La cancelación de la operación impide que se realicen nuevos reemplazos. Si cancela la operación o esta genera un error antes de llegar al último punto de control, las instancias que ya se hayan reemplazado no revierten a su configuración anterior.
+ En el caso de una actualización parcial, al volver a ejecutar la operación, Amazon EC2 Auto Scaling no se reinicia desde el último punto de comprobación ni se detiene cuando solo se reemplazan las instancias anteriores. Sin embargo, reemplaza primero las instancias anteriores antes de las nuevas instancias. 
+ El porcentaje real completado puede ser superior al porcentaje de ese punto de control cuando el porcentaje del punto de control es demasiado bajo en relación con la cantidad de instancias del grupo. Por ejemplo, supongamos que el porcentaje del punto de control es del 20 por ciento y que el grupo tiene cuatro instancias. Si Amazon EC2 Auto Scaling reemplaza una de las cuatro instancias, el porcentaje real reemplazado (25 por ciento) será superior al porcentaje del punto de control (20 por ciento).
+ Una vez alcanzado un punto de control, el porcentaje total completado que se muestra no se actualiza hasta que las instancias terminan la preparación. Por ejemplo, los porcentajes de punto de control son `[20,50]` con un retraso de punto de control de 15 minutos y un porcentaje de buen estado mínimo del 80 por ciento. El grupo de escalado automático tiene 10 instancias y realiza los siguientes reemplazos:
  + 0:00: dos instancias anteriores se reemplazan por otras nuevas. 
  + 0:10: dos instancias nuevas terminan la preparación. 
  + 0:25: dos instancias anteriores se reemplazan por otras nuevas. (Solo se reemplazan dos instancias para mantener el porcentaje mínimo en buen estado).
  + 0:35: dos instancias nuevas terminan la preparación. 
  + 0:35: una instancia anterior se reemplaza por una nueva.
  + 0:45: una instancia nueva termina la preparación.

  A las 0:35, la operación deja de lanzar instancias nuevas. El porcentaje completado aún no refleja con precisión el número de reemplazos completados (50 por ciento), porque la nueva instancia no ha terminado la preparación. Una vez que la nueva instancia completa su período de preparación a las 0:45, el porcentaje completado muestra el 50 por ciento.
+ Si hay varios puntos de control habilitados, el punto de control de actualización de la instancia debe estar configurado al 100 % para garantizar la sustitución completa de todas las instancias. Si establece el punto de control final en un porcentaje inferior al 100 % (por ejemplo, el 50 %), la actualización de la instancia dejará de reemplazar las instancias una vez alcanzado el porcentaje de ese punto de control y no continuará automáticamente hasta completar el 100 %.

# Habilite los puntos de control mediante el uso de o Consola de administración de AWS AWS CLI
<a name="enable-checkpoints-console-cli"></a>

Puede utilizar la Consola de administración de AWS o AWS CLI para activar los puntos de control.

## Habilitar puntos de control (consola)
<a name="enable-checkpoints-console"></a>

Es posible habilitar los puntos de control antes de iniciar una actualización de instancias para reemplazar instancias mediante un enfoque progresivo o gradual. Esto proporciona tiempo adicional para la verificación.

**Para comenzar una actualización de instancias que utiliza puntos de control**

1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.

1. Seleccione la casilla situada junto al grupo de escalado automático.

   Se abre un panel dividido en la parte inferior de la página **Auto Scaling groups** (Grupos de Auto Scaling). 

1. En la pestaña **Instance refresh** (Actualización de instancias) en **Active Instance refresh** (Actualización de instancias activas), elija **Start instance refresh** (Iniciar actualización de instancias).

1. En la página **Start instance refresh** (Iniciar actualización de instancias), ingrese los valores **Minimum healthy percentage** (Porcentaje mínimo en buen estado) e **Instance warmup** (Preparación de la instancia). 

1. Seleccione la casilla de verificación **Enable checkpoints** (Habilitar puntos de control).

   Esto muestra un cuadro donde puede definir el porcentaje de umbral para el primer punto de control. 

1. En **Proceed until \$1\$1\$1\$1 % of the group is refreshed** (Continuar hasta que se actualice el \$1\$1\$1\$1 % del grupo), ingrese un número (1-100). Esto configura el porcentaje del primer punto de control. 

1. Para agregar otro punto de control, elija **Add checkpoint (Agregar punto de control)** y, a continuación, defina el porcentaje para el siguiente punto de control.

1. Para especificar cuánto tiempo espera Amazon EC2 Auto Scaling una vez alcanzado un punto de control, actualice los campos de **Wait for `1` `hour` between checkpoints (Esperar 1 hora entre puntos de control)**. La unidad de tiempo puede ser horas, minutos o segundos.

1. Si terminó con las selecciones de actualización de instancias, elija **Iniciar actualización de instancias**. 

## Habilitar puntos de control (AWS CLI)
<a name="enable-checkpoints-cli"></a>

Para iniciar una actualización de instancias con los puntos de control habilitados mediante el AWS CLI, necesita un archivo de configuración que defina los siguientes parámetros:
+ `CheckpointPercentages`: especifica los valores de umbral para el porcentaje de instancias que se van a reemplazar. Estos valores de umbral proporcionan los puntos de control. Cuando el porcentaje de instancias que se han reemplazado y preparado alcanza uno de los umbrales especificados, la operación espera un período de tiempo especificado. Para especificar el número de segundos que se debe esperar en `CheckpointDelay`. Una vez transcurrido el período de tiempo especificado, la actualización de instancias continúa hasta que llega al siguiente punto de control (si corresponde).
+ `CheckpointDelay`: especifica la cantidad de tiempo, en segundos, que debe esperar después de alcanzar un punto de control antes de continuar. Elija un período de tiempo que proporcione tiempo suficiente para realizar las verificaciones.

El último valor que se muestra en la matriz `CheckpointPercentages` describe el porcentaje del grupo de Auto Scaling que debe reemplazarse correctamente. La operación pasa a `Successful` después de que este porcentaje se reemplaza correctamente y se considera que todas las instancias han terminado de inicializarse. 

**Para crear varios puntos de control**  
Para crear varios puntos de control, usa el siguiente comando de ejemplo [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html). En este ejemplo se configura una actualización de instancias que actualiza inicialmente el uno por ciento del grupo de Auto Scaling. Después de esperar 10 minutos, se actualiza el 19 por ciento siguiente y espera otros 10 minutos. Por último, actualiza el resto del grupo antes de concluir la operación.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenido de `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [1,20,100],
      "CheckpointDelay": 600
    }
}
```

**Para crear un único punto de control**  
Para crear un único punto de control, utilice el siguiente comando de ejemplo [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html). En este ejemplo se configura una actualización de instancias que actualiza inicialmente el 20 por ciento del grupo de Auto Scaling. Después de esperar 10 minutos, actualiza el resto del grupo antes de concluir la operación.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenido de `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [20,100],
      "CheckpointDelay": 600
    }
}
```

**Para actualizar parcialmente el grupo de Auto Scaling**  
Para reemplazar solo una parte del grupo de Auto Scaling y luego detenerlo por completo, utilice el siguiente [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando de ejemplo. En este ejemplo se configura una actualización de instancias que actualiza inicialmente el uno por ciento del grupo de Auto Scaling. Después de esperar 10 minutos, actualiza el siguiente 19 por ciento antes de concluir la operación.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenido de `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [1,20],
      "CheckpointDelay": 600
    }
}
```