Use o template QStash EdgeFunction Scheduler

O template QStash EdgeFunction Scheduler foi projetado para configurar e gerenciar uma function personalizada, que recebe um agendamento configurado pelo usuário e o despacha através do QStash.

Ver como Markdown

Preview

O template QStash EdgeFunction Scheduler foi projetado para configurar e gerenciar uma function personalizada, que recebe um agendamento configurado pelo usuário e o despacha através do QStash, agendador e gestor de tarefas e mensagens para tempos de execução serverless.

Pré-requisitos

Antes de usar este template, você precisa:

  • Criar uma conta no Upstash.
  • No console do Upstash, obter sua Current Signing Key, a Next Signing Key e o QStash Token na aba QStash.
  • Ter uma conta no GitHub para conectar com a Azion e criar seu novo repositório.
    • Cada push será implantado automaticamente neste repositório para manter seu projeto atualizado.
  • O template usa Functions. Isso pode gerar custos relacionados ao uso. Consulte a página de preços para mais informações.

Implante o template

Você pode obter e configurar seu template pelo Azion Console. Para implantá-lo facilmente no edge, clique no botão abaixo.

Implantar

Configure o template

No formulário de configuração, forneça as informações para configurar sua aplicação. Preencha os campos apresentados.

Os campos identificados com asterisco são obrigatórios.

  1. Conecte a Azion com sua conta no GitHub.
  2. Selecione o Git Scope com o qual trabalhar.
  3. Defina um nome para sua application.
  4. Complete os campos:
  • QStash Current Signing Key *: uma string para assinar todas as mensagens enviadas para o destino.
    • Acesse o console do Upstash e copie a informação QSTASH_CURRENT_SIGNING_KEY na aba Qstash.
  • QStash Next Signing Key *: uma string usada para assinar mensagens depois de você ter girado suas chaves de assinatura.
    • Acesse seu console do Upstash e copie a informação QSTASH_NEXT_SIGNING_KEY na aba Qstash.
  1. Clique no botão Deploy para iniciar o processo de implantação.

Agende tarefas

Depois que a implantação for concluída e propagada, você poderá começar a agendar tarefas.

As tarefas devem ser agendadas em qualquer formato que possa ser transmitido em uma requisição HTTP, como JSON, XML, ou binary. Os exemplos abaixo estão usando JSON.

Para fazer isso, você tem duas opções: via terminal ou via console Upstash.

Via terminal

  1. Obtenha seu domínio da application.
  2. No console do Upstash, copie a informação QSTASH_TOKEN na aba QStash.
  3. Em seu ambiente de desenvolvimento, abra o terminal.
  4. Faça uma requisição HTTP POST para a URL especificada para agendar suas mensagens.

Use os seguintes exemplos para sua solicitação, de acordo com o intervalo necessário:

Uma vez

curl --request POST "https://qstash.upstash.io/v1/publish/{add your domain here}" \
-H "Authorization: Bearer {add your QStash token here}" \
-H "Content-Type: application/json" \
-d "{ \"hello\": \"world\"}"

A cada minuto

curl --request POST "https://qstash.upstash.io/v1/publish/{add your domain here}" \
-H "Authorization: Bearer {add your QStash token here}" \
-H "Content-Type: application/json" \
-H "Upstash-Cron: * * * * *" \
-d "{ \"hello\": \"world\"}"

A cada 10 minutos

curl --request POST "https://qstash.upstash.io/v1/publish/{add your domain here}" \
-H "Authorization: Bearer {add your QStash token here}" \
-H "Content-Type: application/json" \
-H "Upstash-Cron: */10 * * * *" \
-d "{ \"hello\": \"world\"}"

A cada hora

curl --request POST "https://qstash.upstash.io/v1/publish/{add your domain here}" \
-H "Authorization: Bearer {add your QStash token here}" \
-H "Content-Type: application/json" \
-H "Upstash-Cron: 0 * * * *" \
-d "{ \"hello\": \"world\"}"

Pronto. A sua tarefa está agendada e será executada de acordo o agendamento definido. Suas tarefas agendadas ficam visíveis no console do Upstash, dentro da aba QStash*, para sua revisão e monitoramento.

Via console do Upstash

  1. Copie seu domínio da application da Azion.
  2. Vá para o console do Upstash e abra a aba QStash.
  3. Preencha o formulário com as informações solicitadas.
  • No campo Type, selecione Scheduled e escolha o delay.
  • Como alternativa, selecione Once para enviar uma mensagem imediata e uma única vez.
  1. Clique no botão Schedule.

Pronto. Sua tarefa está agendada e visível na seção Scheduled Jobs para sua revisão e monitoramento.

Você também pode publicá-los usando uma request do tipo API REST. Para mais informações, leia a documentação do QStash.

Gerencie o template

Para gerenciar e editar as configurações da sua application na Azion, siga estas etapas:

  1. Acesse o Azion Console.
  2. No canto superior esquerdo, selecione Products menu > Applications.
  3. Encontre a application relacionada ao template Qstash Scheduler e selecione-a.

Adicionar um domínio personalizado

consulte o guia para configurar domínios