Tutorial: Passe informações do evento para um AWS Batch alvo em um cronograma usando o transformador EventBridge de entrada

Você pode usar o transformador EventBridge de entrada para transmitir informações do evento AWS Batch em um envio de trabalho. Isso pode ser especialmente valioso se você invocar trabalhos como resultado de outras informações do evento AWS . Um exemplo é upload de objeto para um bucket do Amazon S3. Você também pode usar uma definição de tarefa com valores de substituição de parâmetros no comando do contêiner. O transformador EventBridge de entrada pode fornecer os valores dos parâmetros com base nos dados do evento.

Depois, você cria um destino de AWS Batch evento que analisa as informações do evento que o inicia e as transforma em um parameters objeto. Quando o trabalho é executado, os parâmetros do evento do acionador são repassados para o comando do contêiner do trabalho.

nota

Nesse cenário, todos os AWS recursos (como buckets, EventBridge regras e CloudTrail registros do Amazon S3) devem estar na mesma região.

Para criar um AWS Batch alvo que usa o transformador de entrada

1. Abra o EventBridge console da Amazon em https://console.aws.amazon.com/events/.

2. Na barra de navegação, selecione o Região da AWS a ser usado.

3. No painel de navegação, escolha Regras.

4. Escolha Criar Regra.

5. Para Nome, especifique um nome exclusivo para seu ambiente de computação. O nome pode conter até 64 caracteres. Pode conter letras minúsculas, maiúsculas, números, hifens e (-) e sublinhados (_).

   nota

   Uma regra não pode ter o mesmo nome de outra regra no mesmo barramento de eventos Região da AWS e no mesmo.

6. (Opcional) Em Description, insira uma descrição para a regra.

7. Em Barramento de Eventos, escolha o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, selecione padrão. Quando um AWS service (Serviço da AWS) em sua conta emite um evento, ele sempre vai para o ônibus de eventos padrão da sua conta.

8. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente.

9. Em Rule type, escolha Schedule.

10. Escolha Continuar para criar a regra ou Avançar.

11. Em Schedule pattern, siga um destes procedimentos:

    • Escolha um cronograma refinado que seja executado em um horário específico, tal como 8:00 a.m. PST na primeira segunda-feira de cada mês e insira a expressão cron. Para obter mais informações, consulte Expressões Cron no Guia do EventBridge usuário da Amazon.

    • Escolha uma programação que seja executada em uma taxa regular, como a cada 10 minutos. e, em seguida, insira uma expressão rate.

12. Escolha Next (Próximo).

13. Em Target types (Tipos de destino), escolha AWS service (Serviço da AWS).

14. Em Selecionar um destino, escolha Fila de trabalhos em lote. Em seguida, configure o seguinte:

    • Job queue: (Fila de trabalhos:), insira nome do recurso da Amazon (ARN) da fila de trabalhos na qual o trabalho será programado.

    • Job definition: (Definição do trabalho:) insira o nome e a revisão ou ARN completo da definição do trabalho a ser usado.

    • Job name: (Nome do trabalho:) insira um nome para o trabalho.

    • Array size: (Tamanho da matriz:) (opcional) insira um tamanho de matriz para que o trabalho execute mais de uma cópia. Para obter mais informações, consulte Trabalhos de matriz.

    • Job attempts: (opcional) insira o número de vezes para tentar novamente caso ocorra uma falha no trabalho. Para obter mais informações, consulte Repetições de trabalho automatizadas.

15. Para tipos de destino de fila de trabalhos em Batch, EventBridge precisa de permissão para enviar eventos para o destino. EventBridge pode criar a função do IAM necessária para que sua regra seja executada. Execute um destes procedimentos:

    • Para criar um perfil do IAM automaticamente, escolha Create a new role for this specific resource.

    • Para usar uma função do IAM que você criou anteriormente, escolha Usar função existente.

16. (Opcional) Expanda Additional settings.

17. Na seção Additional settings, para Configure target input, escolha Input Transformer.

18. Escolha Configure input transformer.

19. (Opcional) Para evento de amostra:

    1. Em Tipo de evento de amostra, escolha AWS eventos.

    2. Em Eventos de amostra, escolha Batch Job State Change.

20. Na seção Target input transformer, para Input path, especifique os valores a serem analisados no evento de acionamento. Por exemplo, para analisar o evento Batch Job State Change, use o seguinte formato JSON.

    {
        "instance": "$.detail.jobId",
        "state": "$.detail.status"
    }

21. Em Template, insira o seguinte:

    {
        "instance": <jobId> ,
        "status": <status>
    }

22. Escolha Confirmar.

23. Em Idade máxima do evento, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos.

24. Em Tentativas de repetição, insira o número de vezes que um evento é repetido.

25. Em Dead-letter queue, escolha uma opção de como os eventos não processados são tratados. Se necessário, especifique a fila do Amazon SQS para usar como fila de mensagens mortas.

26. (Opcional) Selecione Add another target (Adicionar outro destino) para adicionar outro destino a essa regra.

27. Escolha Next (Próximo).

28. (Opcional) Em Tags, escolha Adicionar nova tag para adicionar um rótulo de recurso. Para obter mais informações, consulte as EventBridge tags da Amazon no Guia EventBridge do usuário da Amazon.

29. Escolha Next (Próximo).

30. Para Revisar e criar, revise as etapas de configuração. Se precisar fazer alterações, escolha Edit (Editar). Quando terminar, escolha Create rule.