Eventos: recebendo e lidando com eventos

Eventos: recebendo e lidando com eventos

Introdução

Algumas interações no VTEX IO podem gerar eventos e estes podem ser utilizados como gatilhos para ações, como a atividade presente neste passo. Por enquanto, utilizaremos os eventos disparados pela app events-example.

Eventos no VTEX IO

Em apps do VTEX IO, eventos podem ser disparados e utilizados como gatilhos para ações. Por exemplo, uma app que escuta por pedidos e ativa um gatilho de email de confirmação. É importante ressaltar que eventos são dependentes da conta e do workspace, o que significa que são apenas visíveis pela conta e pelo workspace de onde foram disparados. Ou seja, eventos disparados no seu workspace pessoal de desenvolvimento serão apenas escutados por apps que estão linkadas no mesmo workspace.

Vamos começar?

Ouvindo eventos na aplicação

  1. Em primeiro lugar, vamos começar com o disparo de eventos sendo feito através da app events-example. Esta app irá disparar um evento a cada X segundos. Após rodar o comando vtex link no diretório de events-example, clique na rota de healthcheck disponível e uma mensagem "ok" deve aparecer no navegador:

    image

    Este acesso à rota de healthcheck cria um contexto de cache que é necessário para que o VTEX IO dispare eventos. Sem isso, a app events-example não será capaz de disparar eventos que sua app irá ouvir.

  2. Agora, precisamos adicionar o handler de eventos na declaração de Service, que é responsável por definir o que a app vai fazer enquanto estiver ouvindo os eventos que podem chegar. Para fazer isso, no arquivo /node/index.ts, incremente a declaração de Service:

    //node/index/ts
    
    + const THREE_SECONDS_MS = 3 * 1000
    + const CONCURRENCY = 10
    
    export default new Service<Clients, State, ParamsContext>({
        clients: {
        implementation: Clients,
        options: {
            default: {
                retries: 2,
                timeout: 10000,
            },
    +       events: {
    +           exponentialTimeoutCoefficient: 2,
    +           exponentialBackoffCoefficient: 2,
    +           initialBackoffDelay: 50,
    +           retries: 1,
    +           timeout: THREE_SECONDS_MS,
    +           concurrency: CONCURRENCY,
    +      },
    +    },
    +  },
    })
    

    Passando por cada uma das configurações, temos o seguinte:

    CampoTipoDescrição
    exponentialTimeoutCoefficientsecondsfator exponencial em que timeout é incrementado a cada tentativa
    exponentialBackoffCoefficientsecondsfator exponencial em que o backoff delay será incrementado a cada tentativa
    initialBackoffDelaysecondstempo que a app irá esperar até a próxima tentativa
    retries-quantidade máxima de tentativas da app
    timeoutsecondstimeout até ser considerado como uma tentativa mal sucedida
    concurrency-quantidade de processos simultâneos que o evento é capaz de ter

    Ao adicionar esse código ao Service, estamos adicionando ao Client de Service a capacidade de lidar com eventos. Neste ponto, não estamos utilizando ainda os clientes em si ao lidar com eventos.

    Por enquanto, vamos apenas criar um log de recebimento de eventos. Para criar este handler, vá ao arquivo liveUsersUpdate.ts, que se encontra na pasta /node/event e faça as seguintes alterações:

    //node/event/liveUsersUpdate.ts
    export async function updateLiveUsers() {
      console.log('EVENT HANDLER: received event')
    }
    
  3. Após adicionar o bloco de código mencionado anteriormente, precisamos declarar em Service, a referência para esta função. No arquivo /node/index.ts, adicione o seguinte código:

    ...
    + import { updateLiveUsers } from './event/liveUsersUpdate'
    ...
    
    export default new Service<Clients, State, ParamsContext>({
        ...
    +  events: {
    +    liveUsersUpdate: updateLiveUsers,
    +  },
    })
    
    
  4. Também é necessário modificar o arquivo service.json. De forma a ouvir os eventos que são enviados, precisamos declarar isto para darmos a app de serviço que estamos desenvolvendo esta capacidade. É possível fazer isso através das seguintes alterações no arquivo service.json:

    //node/service.json
    {
      "memory": 128,
      "ttl": 10,
      "timeout": 10,
      "minReplicas": 2,
      "maxReplicas": 10,
      "workers": 4,
    +  "events": {
    +    "liveUsersUpdate": {
    +      "sender": "vtex.events-example",
    +      "keys": ["send-event"]
    +    }
      },
      ...
    }
    

    Note que fazemos esta declaração ao utilizar o resolver de eventos, definir a referência para a app que efetivamente dispara os eventos (declarada como sender) e, por fim, adicionar a referência à key do evento (declarada como keys).

  5. Por fim, rode o comando vtex link e espere que os eventos sejam disparados através da app events-example. Quando escutados, o log deve aparece no terminal, como na imagem abaixo:

    image

Está com dúvidas?

Veja o gabarito para esta etapa ou acompanhe nosso [office hours] no canal VTEX Developers(https://www.youtube.com/c/VTEXDevelopers)


Ajude-nos a fazer este conteúdo melhor!

Os cursos do VTEX IO são de código aberto. Se você perceber algum problema, pode abrir um pull request!

Faça uma contribuição

ou abra uma issue