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

Tutorial: criar uma aplicação de exemplo do Amazon EventBridge

É possível usar o EventBridge para rotear eventos para funções específicas do Lambda usando regras.

Neste tutorial, serão usados a AWS CLI, o Node.js e o código no repositório do GitHub para criar o seguinte:

Este exemplo usa modelos do AWS SAM para definir as regras do EventBridge. Para saber mais sobre o uso de modelos do AWS SAM com o EventBridge, consulte Usando AWS Serverless Application Model modelos para implantar EventBridge recursos da Amazon.

No repositório, o subdiretório atmProducer contém handler.js, que representa o serviço ATM que produz eventos. Este código é um manipulador do Lambda escrito em Node.js e publica eventos no EventBridge por meio do AWS SDK usando esta linha de código em JavaScript.

const result = await eventbridge.putEvents(params).promise()

Esse diretório também contém events.js, listando várias transações de teste em uma matriz de entradas. Um único evento é definido em JavaScript da seguinte forma:

{
  // Event envelope fields
  Source: 'custom.myATMapp',
  EventBusName: 'default',
  DetailType: 'transaction',
  Time: new Date(),

  // Main event body
  Detail: JSON.stringify({
    action: 'withdrawal',
    location: 'MA-BOS-01',
    amount: 300,
    result: 'approved',
    transactionId: '123456',
    cardPresent: true,
    partnerBank: 'Example Bank',
    remainingFunds: 722.34
  })
}

A seção Detalhes do evento especifica os atributos da transação. Isso inclui a localização do caixa eletrônico, o valor, o banco parceiro e o resultado da transação.

O arquivo handler.js no subdiretório atmConsumer contém três funções:

exports.case1Handler = async (event) => {
  console.log('--- Approved transactions ---')
  console.log(JSON.stringify(event, null, 2))
}

exports.case2Handler = async (event) => {
  console.log('--- NY location transactions ---')
  console.log(JSON.stringify(event, null, 2))
}

exports.case3Handler = async (event) => {
  console.log('--- Unapproved transactions ---')
  console.log(JSON.stringify(event, null, 2))
}

Cada função recebe eventos de transação, que são registrados por meio das declarações console.log no Amazon CloudWatch Logs. As funções do consumidor operam independentemente do produtor e desconhecem a origem dos eventos.

A lógica de roteamento está contida nas regras do EventBridge que são implantadas pelo modelo da aplicação do AWS SAM. As regras avaliam o fluxo de entrada de eventos e roteiam os eventos correspondentes para as funções do Lambda de destino.

As regras usam padrões de eventos que são objetos JSON com a mesma estrutura dos eventos aos quais correspondem. Aqui está o padrão do evento para uma das regras.

{
  "detail-type": ["transaction"],
  "source": ["custom.myATMapp"],
  "detail": {
    "location": [{
      "prefix": "NY-"
    }]
  }
}

Pré-requisitos

Para concluir este tutorial, serão necessários os seguintes recursos:

Etapa 1: criar uma aplicação

Para configurar a aplicação de exemplo, serão usados a AWS CLI e o Git para criar os recursos da AWS necessários.

Etapa 2: executar a aplicação

Agora que os recursos foram configurados, o console será usado para testar as funções.

Etapa 3: conferir os logs e verificar se a aplicação funciona

Agora que executou a aplicação, usará o console para verificar os CloudWatch Logs.

Etapa 4: limpar os recursos

Agora você pode excluir os recursos criados para este tutorial, a menos que queira mantê-los. Ao excluir os recursos da AWS que não estão mais sendo usados, são evitadas cobranças desnecessárias em sua conta da AWS.