# Uso de Programador de Amazon EventBridge para programar tareas de Amazon ECS
<a name="tasks-scheduled-eventbridge-scheduler"></a>

El Programador de Amazon EventBridge es un programador sin servidor que le permite crear, ejecutar y administrar tareas desde un servicio administrado y centralizado. Proporciona una funcionalidad de programación única y recurrente, independientemente de las reglas y los buses de eventos. El programador de EventBridge es altamente personalizable y ofrece una escalabilidad mejorada en comparación con las reglas programadas de EventBridge, con un conjunto más amplio de operaciones de API y servicios de AWS de destino. El programador de EventBridge proporciona los siguientes programas que puede configurar para sus tareas en la consola del programador de EventBridge:
+ Basada en frecuencia 
+ Basado en cron

  Puede configurar programas basados en cron en cualquier zona horaria.
+ Programas únicos

  Puede configurar programas únicos en cualquier zona horaria.

Puede programar su Amazon ECS mediante el Programador de Amazon EventBridge.

Aunque puede crear una tarea programada en la consola de Amazon ECS, actualmente la consola del programador de EventBridge proporciona más funcionalidad.

Lleve a cabo los pasos siguientes antes de programar una tarea:

1. Utilice la consola de VPC para obtener los ID de subred en los que se ejecutan las tareas y los ID de los grupos de seguridad de las subredes. Para obtener más información, consulte [Subredes para la VPC](https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html) y [Controlar el tráfico hacia los recursos de AWS mediante grupos de seguridad](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) en la *Guía del usuario de Amazon VPC*.

1. Configure el rol de ejecución del programador de EventBridge. Para obtener más información, consulte [Configurar el rol de ejecución](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html#setting-up-execution-role) en la *Guía del usuario del programador de Amazon EventBridge*. 

1. Para utilizar una estrategia de proveedor de capacidad, el proveedor de capacidad debe estar asociado con el clúster.

**Para crear un programa nuevo con la consola**

1. Abra la consola del Programador de Amazon EventBridge en[https://console.aws.amazon.com/scheduler/home](https://console.aws.amazon.com/scheduler/home/).

1.  En la página **Programaciones**, elija **Crear programación**. 

1.  En la página **Especificar los detalles de la programación**, en la sección **Nombre y descripción de la programación**, proceda del modo siguiente: 

   1. En **Nombre de la programación**, escriba un nombre para la programación. Por ejemplo, **MyTestSchedule**. 

   1. (Opcional) En **Descripción**, escriba una descripción para su programación. Por ejemplo, **TestSchedule**.

   1. En **Grupo de programaciones**, elija un grupo de programaciones. Si no tiene un grupo, elija **predeterminado**. Para crear un grupo de programaciones, elija **crear mi propia programación**. 

      Los grupos de programaciones se utilizan para añadir etiquetas a grupos de programaciones. 

1. Elija sus opciones de programación.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/tasks-scheduled-eventbridge-scheduler.html)

1. (Opcional) Si elige **Programación recurrente** en el paso anterior, en la sección de **Periodo de tiempo**, realice lo siguiente: 

   1. En **Zona horaria**, elija una zona horaria. 

   1. En **Fecha y hora de inicio**, introduzca una fecha válida con el formato `YYYY/MM/DD` y, a continuación, especifique una marca de tiempo con el formato `hh:mm` de 24 horas. 

   1. En **Fecha y hora de finalización**, introduzca una fecha válida con el formato `YYYY/MM/DD` y, a continuación, especifique una marca de tiempo con el formato `hh:mm` de 24 horas. 

1. Elija **Siguiente**. 

1. En la página **Seleccionar destino**, haga lo siguiente: 

   1. Seleccione **Todas las API** y, a continuación, en el cuadro de búsqueda escriba **ECS**. 

   1. Seleccione **Amazon ECS**.

   1. En el cuadro de búsqueda, escriba **Ejecutar tarea** y, a continuación, seleccione **Ejecutar tarea**.

   1. En **Clúster de ECS**, elija el clúster.

   1. Para la **tarea de ECS**, elija la definición de tarea que se utilizará para la tarea.

   1. Elija cómo distribuir las tareas en la infraestructura de clúster. Expanda las **Opciones de computación** y, a continuación, elija una de las siguientes opciones:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/tasks-scheduled-eventbridge-scheduler.html)

   1. En el caso de las **Subredes**, introduzca los ID de subred en los que se ejecutará la tarea.

   1. En el caso los **Grupos de seguridad**, introduzca los ID de los grupos de seguridad de la subred.

   1. (Opcional) Para utilizar una estrategia de ubicación de tareas que no sea la predeterminada, expanda **Restricción de ubicación** y, a continuación, introduzca las restricciones.

       Para obtener más información, consulte [Cómo coloca Amazon ECS las tareas en las instancias de contenedor](task-placement.md).

   1. (Opcional) Para ayudar a identificar las tareas, en **Etiquetas**, configure las etiquetas.

      Para que Amazon ECS etiquete automáticamente todas las tareas recién lanzadas con las etiquetas de definición de tareas, seleccione **Activar las etiquetas administradas de Amazon ECS**.

1. Elija **Siguiente**. 

1. En la página **Configuración**, haga lo siguiente: 

   1. Para activar la programación, en **Estado de la programación**, cambie a **Habilitar programación**. 

   1. Para configurar una política de reintentos para su programación, en **Política de reintento y cola de mensajes fallidos (DLQ)**, realice lo siguiente:
      + Cambie a **Reintentar**.
      + En **Tiempo de retención máxima del evento**, ingrese el máximo de **horas** y **minutos** que el programador de EventBridge debe mantener un evento sin procesar.
      + El tiempo máximo es de 24 horas.
      + En **Cantidad máxima de reintentos**, introduzca el número máximo de veces que el Programador de EventBridge reintenta la programación si el destino devuelve un error. 

         El valor máximo es 185 reintentos. 

      Con las políticas de reintentos, si un programa no puede invocar su destino, el Programador de EventBridge vuelve a ejecutar el programa. Si se encuentra configurado, debe establecer el tiempo máximo de retención y los reintentos máximos para la programación.

   1. Elija dónde almacena los eventos no entregados el Programador de EventBridge.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonECS/latest/developerguide/tasks-scheduled-eventbridge-scheduler.html)

   1. Para utilizar una clave administrada por el cliente a fin de cifrar la entrada de destino, en **Cifrado**, elija **Personalizar la configuración de cifrado (avanzado)**. 

      Si elige esta opción, ingrese un ARN de clave de KMS existente o elija **Crear una AWS KMS key** para navegar hasta la consola de AWS KMS. Para obtener más información sobre cómo el Programador de EventBridge cifra los datos en reposo, consulte [Encryption at rest](https://docs.aws.amazon.com/scheduler/latest/UserGuide/encryption-rest.html) en *Amazon EventBridge Scheduler User Guide*. 

   1. En **Permisos**, seleccione **Usar el rol existente** y, a continuación, seleccione el rol.

      Para que el Programador de EventBridge cree un rol de ejecución nuevo en su nombre, elija **Crear un nuevo rol para esta programación**. A continuación, ingrese un nombre para el **Nombre de rol**. Si elige esta opción, el Programador de EventBridge adjunta al rol los permisos necesarios para el destino creado con la plantilla. 

1. Elija **Siguiente**. 

1.  En la página de **Revisar y crear una programación**, revise los detalles de su programación. En cada sección, elija **Editar** para volver a ese paso y editar sus detalles. 

1. Elija **Crear programación**. 

   Puede ver una lista de sus programaciones nuevas y existentes en la página **Programaciones**. En la columna **Estado**, verifique que su programación nueva se encuentre **Habilitada**. 

## Siguientes pasos
<a name="eventbridge-scheduler-next-steps"></a>

Puede utilizar la consola del programador de EventBridge o la AWS CLI para administrar el programa. Para obtener más información, consulte [Administración de un programa](https://docs.aws.amazon.com/scheduler/latest/UserGuide/managing-schedule.html) en la *Guía del usuario del programador de Amazon EventBridge*.