Referencia de programación - Programador de instancias de AWS

Referencia de programación

Las programaciones especifican cuándo deben ejecutarse las instancias etiquetadas con esa programación. Cada programación debe tener un nombre único, que se usa como el valor de etiqueta que identifica la programación que desea aplicar al recurso etiquetado.

Periodos

Cada programación debe contener al menos un período que defina las horas a las que debe ejecutarse la instancia. Una programación puede contener más de un período. Cuando se utilice más de un período en una programación, el programador de instancias de AWS aplicará la acción de inicio adecuada cuando al menos uno de los períodos esté establecido en true. Para obtener más información, consulte Referencia de período.

Zona horaria

También puede especificar una zona horaria para la programación. Si no especifica una zona horaria, la programación utilizará la predeterminada que especifique al lanzar la solución. Para obtener una lista de valores de zona horaria aceptables, consulte la columna TZ de List of TZ database time zones.

Campo de hibernación

El campo hibernate permite utilizar la hibernación para las instancias de Amazon EC2 detenidas. Si este campo se establece en true, las instancias de EC2 deben usar una imagen de máquina de Amazon (AMI) que admita la hibernación. Para obtener más información, consulte las AMI de Linux compatibles en la Guía del usuario de Amazon EC2. La hibernación guarda el contenido de la memoria de la instancia (RAM) en su volumen raíz de Amazon Elastic Block Store (Amazon EBS). Si este campo se establece en true, las instancias se pondrán en hibernación en lugar de detenerse cuando la solución las detenga.

Si establece la solución para usar esta característica, pero las instancias no están configuradas para la hibernación o no cumplen los requisitos previos para la hibernación, la solución registra una advertencia y las instancias se detienen sin hibernación. Para obtener más información, consulte Hibernación de una instancia bajo demanda o instancia de spot de la Guía del usuario de Amazon EC2.

Campo de aplicación

Las programaciones contienen un campo enforced que permite impedir que una instancia se inicie de forma manual fuera de un período de ejecución o que se detenga manualmente durante dicho período. Si este campo se establece en true y un usuario inicia de forma manual una instancia fuera de un período de ejecución, la solución detendrá la instancia. Si este campo se establece en true, también reinicia una instancia si se detiene manualmente durante un período de ejecución.

Campo de retención de la ejecución

El campo retain_running impide que la solución detenga una instancia al final de un período de ejecución si la instancia se inició de forma manual antes de comenzar el período. Por ejemplo, si una instancia con un período de ejecución de 9:00 a 17:00 h se inicia manualmente antes de las 9.00 h, la solución no detendrá la instancia a las 17:00 h.

Campo de ventanas de mantenimiento de Systems Manager (aplicable solo a las instancias de EC2)

El campo ssm-maintenance-window permite agregar de forma automática ventanas de mantenimiento de AWS Systems Manager como períodos de ejecución a una programación. Al especificar el nombre de un período de mantenimiento que existe en la misma cuenta y región de AWS que sus instancias de Amazon EC2, la solución iniciará la instancia al menos diez minutos antes del inicio de la ventana de mantenimiento y la detendrá al final de dicha ventana si ningún otro período de ejecución especifica que la instancia debe ejecutarse.

Una vez que se haya creado la ventana de mantenimiento de SSM y se haya configurado la programación con el nombre de la ventana de mantenimiento de SSM, los cambios se recogerán en la siguiente ejecución programada de la instancia de Lambda. Por ejemplo, si ha seleccionado una frecuencia de cinco minutos para la ejecución de la función de Lambda del programador, esta detectará los cambios en la ventana de mantenimiento en el siguiente intervalo de cinco minutos.

El programador de instancias de AWS se asegurará de que sus instancias se inicien al menos diez minutos antes de comenzar la ventana de mantenimiento. Según el valor que establezca para el parámetro Intervalo de programación de AWS CloudFormation, puede que la instancia se inicie en un intervalo de diez minutos o más antes del comienzo de la ventana de mantenimiento con el fin de garantizar que la instancia se inicie al menos diez minutos antes. Por ejemplo, si establece el intervalo de programación en treinta minutos, el programador iniciará la instancia entre diez y cuarenta minutos antes de comenzar la ventana de mantenimiento.

nota

Para utilizar esta característica, el parámetro de CloudFormation Habilitar ventanas de mantenimiento de SSM de EC2 de la pila central de la solución debe establecerse en yes.

Para obtener más información, consulte Ventanas de mantenimiento de AWS Systems Manager de la Guía del usuario de AWS Systems Manager.

Tipo de instancia

Solo en el caso de las instancias de Amazon EC2, una programación permite especificar un tipo de instancia deseado opcional para cada uno de los períodos de una programación. Al especificar un tipo de instancia en el período, la solución cambiará de forma automática el tamaño de las instancias de EC2 para que coincidan con el tipo de instancia solicitado.

Para especificar un tipo de instancia, utilice la sintaxis.<nombre-de-período>@<tipo-de-instancia>. Por ejemplo, weekends@t2.nano. Tenga en cuenta que si especifica un tipo de instancia para un período que programa instancias de Amazon EC2 e instancias de Amazon RDS, el tipo de instancia se ignorará para las instancias de Amazon RDS.

Si el tipo de una instancia en ejecución es distinto al tipo de instancia especificado para el período, la solución detendrá la instancia en ejecución y la reiniciará con el tipo de instancia especificado. Para obtener más información, consulte Cambios de tipos de instancias de la Guía del usuario de Amazon EC2 para instancias de Linux.

Definiciones de programación

La tabla de configuración del programador de instancias de AWS en Amazon DynamoDB contiene definiciones de programación. Una definición de programación puede incluir los siguientes campos:

Campo Descripción

description

Descripción opcional de la programación.

hibernate

Elija si desea hibernar aquellas instancias de Amazon EC2 que ejecutan Amazon Linux. Cuando este campo se establezca en true, el programador hibernará las instancias al detenerlas. Tenga en cuenta que sus instancias deben activar la hibernación y cumplir los requisitos previos para la hibernación.

enforced

Elija si desea aplicar la programación. Cuando este campo se establezca en true, el programador detendrá una instancia en ejecución si se inicia de forma manual fuera del período de ejecución, o bien iniciará una instancia si se detiene manualmente durante dicho período.

name

Nombre que se utiliza para identificar la programación. Este nombre debe ser único y contener únicamente caracteres alfanuméricos, guiones (-) y guiones bajos (_).

periods

Nombre de los períodos que se utilizan en esta programación. Introduzca los nombres exactamente como aparecen en el campo de nombre de período.

También puede especificar un tipo de instancia para el período mediante la sintaxis <nombre-de-período>@<tipo-de-instancia>. Por ejemplo, weekdays@t2.large.

retain_running

Elija si desea impedir que la solución detenga una instancia al final de un período de ejecución si la instancia se inició manualmente antes de comenzar el período.

use_maintenance_window

Elija si desea incluir la ventana de mantenimiento de Amazon RDS como período de ejecución en una programación de instancias de Amazon RDS, o bien una ventana de mantenimiento de AWS Systems Manager como período de ejecución en una programación de instancias de Amazon EC2. Este campo está habilitado de forma predeterminada y, para deshabilitarlo, establezca su valor en “false”.

ssm_maintenance_window

Elija si desea agregar ventanas de mantenimiento de AWS Systems Manager como período de ejecución adicional para esta programación. Acepta un valor StringSet de nombres de las ventanas de mantenimiento que se compararán con los nombres de ventanas en la misma cuenta o región que las instancias de EC2 programadas.

Nota: Esta característica solo se aplica a las instancias de EC2.

stop_new_instances

Elija si desea detener una instancia la primera vez que se etiquete si se ejecuta fuera del período de ejecución. De forma predeterminada, este campo se establece en true.

timezone

Zona horaria que la programación utilizará. Si no se especifica ninguna zona horaria, se utiliza la zona horaria predeterminada (UTC). Para obtener una lista de valores de zona horaria aceptables, consulte la columna TZ de List of TZ database time zones.

use_metrics

Elija si desea activar métricas de CloudWatch a nivel de programación. Este campo sobrescribe la configuración de las métricas de CloudWatch que especificó en la implementación.

Nota: Al habilitar esta característica se generan cargos de 0,90 USD al mes por programación o servicio programado.