Uso de Amazon EventBridge Scheduler para iniciar la ejecución de una máquina de estados de Step Functions - AWS Step Functions

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 Amazon EventBridge Scheduler para iniciar la ejecución de una máquina de estados de Step Functions

Amazon EventBridge Scheduler es un programador sin servidor que le permite crear, ejecutar y gestionar tareas desde un servicio gestionado central. Con EventBridge Scheduler, puede crear planificaciones mediante expresiones cron y rate para patrones recurrentes, o configurar invocaciones únicas. Puede configurar intervalos de tiempo flexibles para la entrega, definir los límites de reintentos y establecer el tiempo máximo de retención para las invocaciones fallidas. API

Por ejemplo, con EventBridge Scheduler, puede iniciar la ejecución de una máquina de estados según una programación cuando se produzca un evento relacionado con la seguridad o para automatizar un trabajo de procesamiento de datos.

Esta página explica cómo usar EventBridge Scheduler para iniciar la ejecución de una máquina de estados Step Functions según una programación.

Configurar el rol de ejecución

Al crear una nueva programación, EventBridge Scheduler debe tener permiso para invocar la API operación de destino en su nombre. Estos permisos se otorgan a EventBridge Scheduler mediante una función de ejecución. La política de permisos que adjunta a la función de ejecución de su programación define los permisos necesarios. Estos permisos dependen del destino API que desee que invoque EventBridge Scheduler.

Al utilizar la consola del EventBridge Programador para crear un cronograma, como en el siguiente procedimiento, el EventBridge Programador configura automáticamente un rol de ejecución en función del objetivo seleccionado. Si desea crear un cronograma utilizando uno de los EventBridge planificadoresSDKs, debe tener un rol de ejecución existente que otorgue los permisos que el EventBridge programador requiere para invocar un destino. AWS CLI AWS CloudFormation Para obtener más información sobre la configuración manual de una función de ejecución para su programación, consulte Configuración de una función de ejecución en la Guía del usuario del EventBridge Scheduler.

Crear una programación

Para crear una programación con la consola, realice lo siguiente:
  1. Abre la consola de Amazon EventBridge Scheduler en https://console.aws.amazon.com/scheduler/casa.

  2. En la página de Programaciones, elija Crear programación.

  3. En la página de Especificar los detalles de la programación, en la sección de Nombre y descripción de la programación, realice lo siguiente:

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

    2. (Opcional) En Descripción, escriba una descripción para su programación. Por ejemplo, My first schedule.

    3. En Grupo de programaciones, elija un grupo de programaciones de la lista desplegable. 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 agregar etiquetas a grupos de programaciones.

    1. Elija sus opciones de programación.

      Ocurrencia Haga lo siguiente...

      Programación única

      Una programación única invoca solo una vez un objetivo en la fecha y hora que especifique.

      En Fecha y hora, realice lo siguiente:

      • Ingrese una fecha válida en el formato YYYY/MM/DD.

      • Ingrese una marca de tiempo en el formato hh:mm de 24 horas.

      • En Zona horaria, elija la zona horaria.

      Programación recurrente

      Una programación recurrente invoca un objetivo a una velocidad que especifique mediante una expresión cron o rate.

      1. En Tipo de programación, realice una de las siguientes acciones:

        • Para utilizar una expresión Cron para definir la programación, elija Programación basada en Cron e ingrese la expresión Cron.

        • Para utilizar una expresión de frecuencia para definir la programación, elija Programación basada en la frecuencia e ingrese la expresión de frecuencia.

          Para obtener más información sobre las expresiones cron y rate, consulte Tipos de programación en EventBridge Scheduler en la Guía del usuario de Amazon EventBridge Scheduler.

      2. En Intervalo de tiempo flexible, elija Apagado para desactivar la opción o elegir uno de los periodos de tiempo predefinidos. Por ejemplo, si elige 15 minutos y establece una programación recurrente para invocar su objetivo una vez cada hora, el horario se ejecuta 15 minutos después del inicio de cada hora.

  4. (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.

    2. En Fecha y hora de inicio, ingrese una fecha válida en el formato YYYY/MM/DD y, a continuación, especifique una marca de tiempo en el formato hh:mm de 24 horas.

    3. En Fecha y hora de finalización, ingrese una fecha válida en el formato YYYY/MM/DD y, a continuación, especifique una marca de tiempo en el formato hh:mm de 24 horas.

  5. Elija Next (Siguiente).

  6. En la página Seleccione el destino, elija la AWS API operación que EventBridge invoca Scheduler:

    1. Elija. AWS Step Functions StartExecution

    2. En la StartExecutionsección, seleccione una máquina de estados o elija Crear nueva máquina de estados.

      En la actualidad, no se pueden ejecutar los flujos de trabajo rápidos sincrónicos según una programación.

    3. Introduzca una JSON carga útil para la ejecución. Incluso si su máquina de estados no requiere ninguna JSON carga útil, debe incluir la entrada en el JSON formato que se muestra en el siguiente ejemplo.

      { "Comment": "sampleJSONData" }
  7. Elija Next (Siguiente).

  8. 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.

    2. Para configurar una política de reintentos para su programación, en Política de reintentos y cola de mensajes sin salida ()DLQ, haga lo siguiente:

      • Cambie a Reintentar.

      • En Antigüedad máxima del evento, introduce el número máximo de horas y minutos que el EventBridge programador debe mantener sin procesar un evento.

      • El tiempo máximo es de 24 horas.

      • En Máximo número de reintentos, introduce el número máximo de veces que EventBridge Scheduler reintenta la programación si el objetivo devuelve un error.

        El valor máximo es 185 reintentos.

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

    3. Elija dónde guarda el EventBridge Scheduler los eventos no entregados.

      Opción de cola de cartas muertas () DLQ Haga lo siguiente...
      No almacenar Seleccione Ninguno.
      Guarda el evento en el mismo Cuenta de AWS lugar donde estás creando la programación
      1. Selecciona Selecciona una SQS cola de Amazon en mi Cuenta de AWS como DLQ.

      2. Elija el nombre del recurso de Amazon (ARN) de la SQS cola de Amazon.

      Guarda el evento en un lugar Cuenta de AWS diferente al lugar en el que estás creando la programación
      1. Elige Especificar una SQS cola de Amazon en otra Cuentas de AWS como DLQ.

      2. Introduzca el nombre del recurso de Amazon (ARN) de la SQS cola de Amazon.

    4. 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 eliges esta opción, introduce una KMS clave existente ARN o selecciona Crear una AWS KMS key para ir a la AWS KMS consola. Para obtener más información sobre cómo EventBridge Scheduler cifra los datos en reposo, consulte Cifrado en reposo en la Guía del usuario de Amazon EventBridge Scheduler.

    5. Para que EventBridge Scheduler cree un nuevo rol de ejecución para usted, elija Crear un nuevo rol para este programa. A continuación, ingrese un nombre para el Nombre de rol. Si eliges esta opción, EventBridge Scheduler adjunta al rol los permisos necesarios para el objetivo creado con la plantilla.

  9. Elija Next (Siguiente).

  10. 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.

  11. Elija Crear programación.

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

Para confirmar que EventBridge Scheduler ha invocado la máquina de estados, comprueba los CloudWatch registros de Amazon de la máquina de estados.

Para obtener más información sobre EventBridge Scheduler, consulte lo siguiente: