As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Trabalhos AWS Batch como destinos do EventBridge O Amazon EventBridge oferece um fluxo quase em tempo quase real dos eventos do sistema que descrevem as alterações nos recursos da Amazon Web Services. Em geral, AWS Batch no Amazon Elastic Container Service, no Amazon Elastic Kubernetes Service e no AWS Fargate, os trabalhos estão disponíveis como destinos do EventBridge. Usando regras simples você pode corresponder a eventos e enviar trabalhos do AWS Batch em resposta a esses eventos. Para obter mais informações, consulte [What is EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) no *Guia do usuário do Amazon EventBridge*. Também é possível usar o EventBridge para programar ações automatizadas que são acionadas automaticamente em determinados momentos usando expressões **cron** ou rate. Para obter mais informações, consulte [Creating an Amazon EventBridge rule that runs on a schedule](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) no *Amazon EventBridge User Guide*. Para obter informações sobre como criar uma regra quando um evento corresponder com um padrão de evento, consulte [Creating Amazon EventBridge rules that react to events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) no *Guia do usuário do Amazon EventBridge*. Os casos de uso comuns para trabalhos AWS Batch como alvo do EventBridge incluem os seguintes casos de uso: + Um trabalho agendado ocorre em intervalos de tempo regulares. Por exemplo, um trabalho **cron** ocorre somente em horários de baixa utilização, quando as Instâncias Spot do Amazon EC2 são mais baratas. + Um trabalho AWS Batch é executado em resposta a uma operação de API registrada no CloudTrail. Por exemplo, um trabalho é enviado sempre que um objeto é carregado em um bucket específico do Amazon S3. Sempre que isso acontece, o transformador de entrada EventBridge passa o bucket e o nome da chave do objeto para os parâmetros AWS Batch. **nota** Nesse cenário, todos os recursos AWS relacionados devem estar na mesma região. Isso inclui recursos como o bucket do Amazon S3, a regra do EventBridge e os registros do CloudTrail. Antes que você possa enviar trabalhos AWS Batch com regras e destinos do EventBridge, o serviço do CloudWay Events exige várias permissões para executar trabalhos. AWS Batch Ao criar uma regra no console do EventBridge que especifica um trabalho do AWS Batch como destino, você tem a oportunidade de criar esse perfil. Para obter mais informações sobre a entidade principal do serviço e as permissões do IAM necessárias para esse perfil, consulte [EventBridge IAM role (Função do IAM)](CWE_IAM_role.md). **Topics** + [Tutorial: criar um trabalho programado do AWS Batch](scheduled-batch-job.md) + [Tutorial: criar uma regra com um padrão de evento](event-pattern-batch-job.md) + [Tutorial: Passe informações do evento para um AWS Batch alvo em um cronograma usando o transformador EventBridge de entrada](cwe-input-transformer.md) # Tutorial: criar um trabalho programado do AWS Batch O procedimento a seguir aborda como criar um trabalho AWS Batch programado e o perfil necessário do IAM do EventBridge. **Para criar um trabalho programado do AWS Batch com o EventBridge** **nota** Esse procedimento funciona para todos os trabalhos AWS Batch do Amazon ECS, Amazon EKS e AWS Fargate. 1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Na barra de navegação, selecione Região da AWS a ser usada. 1. No painel de navegação, escolha **Regras**. 1. Escolha **Criar Regra**. 1. 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 (\$1). **nota** Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos. 1. (Opcional) Em **Description**, insira uma descrição para a regra. 1. 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 **default**. Quando um AWS service (Serviço da AWS) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta. 1. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente. 1. Em **Rule type**, escolha **Schedule**. 1. Escolha **Continuar para criar a regra** ou **Avançar**. 1. 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) no *Guia do usuário do Amazon EventBridge*. + Escolha **uma programação que seja executada em uma taxa regular, como a cada 10 minutos.** e, em seguida, insira uma expressão rate. 1. Escolha **Next** (Próximo). 1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**. 1. 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](array_jobs.md). + **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](job_retries.md). 1. Para os tipos de destino **Batch job queue** (Fila de trabalhos em lote), o Eventbridge precisa de permissão para enviar eventos ao destino. Nesses casos, o Eventbridge pode criar o perfil do IAM necessário para a função ser 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**. 1. (Opcional) Expanda **Additional settings**. 1. Em **Configurar entrada de destino**, escolha como o texto de um evento é processado antes de ser passado para o destino. 1. Em **Idade máxima do evento**, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos. 1. Em **Tentativas de repetição**, insira o número de vezes que um evento é repetido. 1. 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. 1. (Opcional) Selecione **Add another target** para adicionar outro destino a essa regra. 1. Escolha **Next** (Próximo). 1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** para adicionar um rótulo de recurso à regra. Para obter mais informações, consulte [tags do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html). 1. Escolha **Next** (Próximo). 1. Para **Revisar e criar**, revise as etapas de configuração. Se precisar fazer alterações, escolha **Edit** (Editar). Quando terminar, escolha **Create rule**. Para obter mais informações sobre como criar regras de eventos, consulte [Creating an Amazon EventBridge rule that runs on a schedule](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) no *Guia do usuário do Amazon EventBridge*. # Tutorial: criar uma regra com um padrão de evento O procedimento a seguir aborda como criar uma regra com um padrão de evento. **Para criar uma regra que envie o evento para um destino quando o evento corresponder a um padrão definido** **nota** Esse procedimento funciona para todos os trabalhos AWS Batch do Amazon ECS, Amazon EKS e AWS Fargate. 1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Na barra de navegação, selecione Região da AWS a ser usada. 1. No painel de navegação, escolha **Regras**. 1. Escolha **Criar Regra**. 1. 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 (\$1). **nota** Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos. 1. (Opcional) Em **Description**, insira uma descrição para a regra. 1. 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 **default**. Quando um AWS service (Serviço da AWS) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta. 1. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente. 1. Em **Rule type**, escolha **Rule with an event pattern**. 1. Escolha **Próximo**. 1. Em **Event source**, escolha **Eventos da AWS ou eventos de parceiro do EventBridge**. 1. (Opcional) Para **evento de amostra**: 1. Em **Tipo de evento de amostra**, escolha **AWSeventos**. 1. Em **Eventos de amostra**, escolha **Batch Job State Change**. 1. Em **Creation method**, escolha **Use pattern form**. 1. Para **padrão de eventos**: 1. Em **Event source**, escolha **Serviços da AWS**. 1. Em **AWS service (Serviço da AWS)**, escolha **Batch**. 1. Em **Event type**, escolha **Batch Job State Change**. 1. Escolha **Next** (Próximo). 1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**. 1. Em **Choose a target type**, selecione o tipo de destino. Por exemplo, escolha **Batch job queue**. Em seguida, especifique 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](array_jobs.md). + **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](job_retries.md). 1. Para os tipos de destino **Batch job queue** (Fila de trabalhos em lote), o Eventbridge precisa de permissão para enviar eventos ao destino. Nesses casos, o Eventbridge pode criar o perfil do IAM necessário para a função ser executada. Execute um destes procedimentos: + Para criar um perfil do IAM automaticamente, escolha **Create a new role for this specific resource**. + Para usar um perfil do IAM que você criou antes, escolha **Use existing role**. 1. (Opcional) Expanda **Additional settings**. 1. Em **Configure target input**, escolha como o texto de um evento é processado. 1. Em **Idade máxima do evento**, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos. 1. Em **Tentativas de repetição**, insira o número de vezes que um evento é repetido. 1. 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. 1. (Opcional) Selecione **Add another target** (Adicionar outro destino) para adicionar outro destino a essa regra. 1. Escolha **Next** (Próximo). 1. (Opcional) Em **Tags**, escolha **Adicionar nova tag** para adicionar um rótulo de recurso. Para mais informações, consulte [Tags Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) em *Guia de Usuário Amazon EventBridge*. 1. Escolha **Next** (Próximo). 1. Para **Revisar e criar**, revise as etapas de configuração. Se precisar fazer alterações, escolha **Edit** (Editar). Quando terminar, escolha **Create rule**. Para obter informações sobre como criar regras, consulte [Criar regras do Amazon EventBridge que reagem a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) no *Guia do usuário do Amazon EventBridge*. # 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/](https://console.aws.amazon.com/events/). 1. Na barra de navegação, selecione o Região da AWS a ser usado. 1. No painel de navegação, escolha **Regras**. 1. Escolha **Criar Regra**. 1. 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 (\$1). **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. 1. (Opcional) Em **Description**, insira uma descrição para a regra. 1. 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. 1. (Opcional) Desative a regra no barramento selecionado se não quiser executá-la imediatamente. 1. Em **Rule type**, escolha **Schedule**. 1. Escolha **Continuar para criar a regra** ou **Avançar**. 1. 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions) 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. 1. Escolha **Next** (Próximo). 1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**. 1. Em **Selecionar um destino**, escolha **Fila de trabalhos em lote**. Em seguida, configure o seguinte: + **Fila de trabalhos:** insira nome do recurso da Amazon (ARN) da fila de trabalhos na qual o trabalho será programado. + **Definição do trabalho:** insira o nome e a revisão ou ARN completo da definição do trabalho a ser usado. + **Nome do trabalho:** insira um nome para o trabalho. + **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](array_jobs.md). + **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](job_retries.md). 1. 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**. 1. (Opcional) Expanda **Additional settings**. 1. Na seção **Additional settings**, para **Configure target input**, escolha **Input Transformer**. 1. Escolha **Configure input transformer**. 1. (Opcional) Para **evento de amostra**: 1. Em **Tipo de evento de amostra**, escolha **AWS eventos**. 1. Em **Eventos de amostra**, escolha **Batch Job State Change**. 1. 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" } ``` 1. Em **Template**, insira o seguinte: ``` { "instance": , "status": } ``` 1. Escolha **Confirmar**. 1. Em **Idade máxima do evento**, especifique o intervalo de tempo por quanto tempo os eventos não processados são mantidos. 1. Em **Tentativas de repetição**, insira o número de vezes que um evento é repetido. 1. 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. 1. (Opcional) Selecione **Add another target** (Adicionar outro destino) para adicionar outro destino a essa regra. 1. Escolha **Next** (Próximo). 1. (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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tagging.html) no *Guia EventBridge do usuário da Amazon*. 1. Escolha **Próximo**. 1. Para **Revisar e criar**, revise as etapas de configuração. Se precisar fazer alterações, escolha **Edit** (Editar). Quando terminar, escolha **Create rule**.