Usando o Amazon EventBridge Scheduler para iniciar a execução de uma máquina de estado do Step Functions

O Amazon EventBridge Scheduler é um programador sem servidor que permite criar, executar e gerenciar tarefas a partir de um serviço gerenciado central. Com o EventBridge Scheduler, você pode criar agendas usando expressões cron e rate para padrões recorrentes ou configurar invocações únicas. Você pode configurar janelas de tempo flexíveis para entrega, definir limites de novas tentativas e definir o tempo máximo de retenção para API invocações com falha.

Por exemplo, com o EventBridge Scheduler, você pode iniciar a execução de uma máquina de estado em um cronograma quando ocorrer um evento relacionado à segurança ou automatizar um trabalho de processamento de dados.

Esta página explica como usar o EventBridge Scheduler para iniciar a execução de uma máquina de estado Step Functions em um agendamento.

Configurar o perfil de execução

Quando você cria um novo EventBridge agendamento, o Agendador deve ter permissão para invocar sua API operação de destino em seu nome. Você concede essas permissões ao EventBridge Scheduler usando uma função de execução. A política de permissão que você anexa ao perfil de execução da programação define as permissões necessárias. Essas permissões dependem do alvo que API você deseja que o EventBridge Scheduler invoque.

Quando você usa o console do EventBridge Scheduler para criar um agendamento, como no procedimento a seguir, o EventBridge Scheduler configura automaticamente uma função de execução com base no destino selecionado. Se você quiser criar um EventBridge agendamento usando um dos Agendadores, o, ou SDKs AWS CLI AWS CloudFormation, você deve ter uma função de execução existente que conceda as permissões que o EventBridge Agendador exige para invocar um alvo. Para obter mais informações sobre como configurar manualmente uma função de execução para sua agenda, consulte Configurando uma função de execução no Guia do usuário do EventBridge Scheduler.

Criar uma programação

Para criar uma programação usando o console

1. Abra o console do Amazon EventBridge Scheduler em https://console.aws.amazon.com/scheduler/casa.

2. Na página Programações, clique em Criar programação.

3. Na página Especificar detalhes da programação, na seção Nome e descrição da programação, faça o seguinte:

   1. Em Nome da programação, insira um nome para a programação. Por exemplo, MyTestSchedule.

   2. (Opcional) Em Descrição, insira a descrição da programação. Por exemplo, My first schedule.

   3. Em Grupo de programação, escolha um grupo de programação na lista suspensa. Se você não tiver um grupo, escolha padrão. Para criar um grupo de programação, escolha criar sua própria programação.

      Para adicionar tags a grupos de programação, você usa os grupos de programação.

4. 1. Escolha as opções de programação.

      Ocorrência	Fazer isso...
      Programação única A programação única invoca o destino somente uma vez na data e hora que você especificar.	Em Data e hora, faça o seguinte: Insira uma data válida no formato YYYY/MM/DD. Insira um carimbo de data/hora no formato de 24 horas hh:mm. Em Fuso horário, escolha o fuso horário.
      Programação recorrente A programação recorrente invoca o destino em uma taxa especificada por você usando uma expressão cron ou rate.	Em Tipo de programação, siga um dos procedimentos a seguir. Para usar uma expressão cron para definir a programação, escolha Programação baseada em cron e insira a expressão cron. Para usar uma expressão rate para definir a programação, escolha Programação baseada em rate e insira a expressão rate. Para obter mais informações sobre expressões cron e de taxa, consulte Tipos de programação no EventBridge Scheduler no Guia do usuário do Amazon EventBridge Scheduler. Em Janela de tempo flexível, escolha Desativar para desativar a opção ou escolha uma das janelas de tempo predefinidas. Por exemplo, se você escolher 15 minutos e definir uma programação recorrente para invocar o destino uma vez a cada hora, a programação será executada em até 15 minutos após o início de cada hora.

5. (Opcional) Se você escolher Programação recorrente na etapa anterior, na seção Período, faça o seguinte:

   1. Em Fuso horário, escolha um fuso horário.

   2. Em Data e hora de início, insira uma data válida no formato YYYY/MM/DD e, em seguida, especifique um carimbo de data/hora no formato de 24 horas hh:mm.

   3. Para Data e hora de término, insira uma data válida no formato YYYY/MM/DD e, em seguida, especifique um carimbo de data/hora no formato 24 horas hh:mm.

6. Escolha Próximo.

7. Na página Selecionar destino, escolha a AWS API operação que o EventBridge Agendador invoca:

   1. Escolha AWS Step Functions StartExecution.

   2. Na StartExecutionseção, selecione uma máquina de estado ou escolha Criar nova máquina de estado.

      No momento, não é possível executar fluxos de trabalho expressos síncronos em uma programação.

   3. Insira uma JSON carga útil para a execução. Mesmo que sua máquina de estado não exija nenhuma JSON carga, você ainda deve incluir a entrada no JSON formato, conforme mostrado no exemplo a seguir.

      {
          "Comment": "sampleJSONData"
      }

8. Escolha Próximo.

9. Na página Configurações, faça o seguinte:

   1. Para ativar a programação, em Estado da programação, mude para Ativar programação.

   2. Para configurar uma política de repetição para sua agenda, em Política de repetição e fila de cartas mortas (DLQ), faça o seguinte:

      • Mude para Tentar novamente.

      • Em Idade máxima do evento, insira o (s) máximo (s) de hora (s) e minuto (s) em que o EventBridge Agendador deve manter um evento não processado.

      • O período máximo é de 24 horas.

      • Em Máximo de tentativas, insira o número máximo de vezes que o EventBridge Scheduler repete o agendamento se o alvo retornar um erro.

        O valor máximo é 185 tentativas.

      Com as políticas de repetição, se um agendamento falhar em invocar seu destino, o EventBridge Scheduler executará novamente o agendamento. Se configurado, você deve definir o tempo máximo de retenção e as novas tentativas da programação.

   3. Escolha onde o EventBridge Scheduler armazena os eventos não entregues.

      Opção de fila de cartas mortas () DLQ	Fazer isso...
      Não armazene	Selecione Nenhum.
      Armazene o evento no mesmo Conta da AWS local em que você está criando a programação	Escolha Selecionar uma SQS fila da Amazon em meu Conta da AWS como DLQ. Escolha o nome do recurso da Amazon (ARN) da SQS fila da Amazon.
      Armazene o evento em um local Conta da AWS diferente de onde você está criando a programação	Escolha Especificar uma SQS fila da Amazon em outra Contas da AWS como uma DLQ. Insira o nome do recurso da Amazon (ARN) da SQS fila da Amazon.

   4. Para usar uma chave gerenciada pelo cliente para criptografar a entrada de destino, em Criptografia, escolha Personalizar as configurações de criptografia (avançado).

      Se você escolher essa opção, insira uma KMS chave existente ARN ou escolha Criar uma AWS KMS key para navegar até o AWS KMS console. Para obter mais informações sobre como o EventBridge Scheduler criptografa seus dados em repouso, consulte Criptografia em repouso no Guia do usuário do Amazon EventBridge Scheduler.

   5. Para que o EventBridge Scheduler crie uma nova função de execução para você, escolha Criar nova função para esta agenda. Depois, insira um nome em Nome do perfil. Se você escolher essa opção, o EventBridge Scheduler anexará as permissões necessárias para seu alvo modelado à função.

10. Escolha Próximo.

11. Na página Revisar e criar programação, revise os detalhes da programação. Em cada seção, escolha Editar para voltar a essa etapa e editar seus detalhes.

12. Clique em Criar programação.

    Você pode ver a lista com as programações novas e existentes na página Programações. Na coluna Status, verifique se a nova programação está Ativada.

Para confirmar se o EventBridge Scheduler invocou a máquina de estado, verifique os registros da Amazon CloudWatch da máquina de estado.

Recursos relacionados

Para obter mais informações sobre o EventBridge Scheduler, consulte o seguinte:

• EventBridge Guia do usuário do Scheduler

• EventBridge Referência do agendador API

• EventBridge Preços do Scheduler