Use o template QStash Function Scheduler

Faça o deploy do template QStash Function Scheduler, que despacha pelo QStash um agendamento que você configura.

Última atualização

Ver como Markdown Configurar agente

O template QStash Function 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ê obtém e configura o template pelo Azion Console. Para fazer o deploy, selecione o botão abaixo.

Implantar

Configure o template

O formulário de configuração carrega as informações que configuram sua aplicação. Para preenchê-lo:

Conecte a Azion com sua conta no GitHub

Uma janela abre para confirmar a instalação do Azion GitHub App, uma ferramenta que conecta sua conta do GitHub com a plataforma da Azion. Defina suas permissões e o acesso aos repositórios conforme desejar.

Selecione o Git Scope com o qual trabalhar
Defina um nome para sua application

O bucket para storage e a function usam o mesmo nome. Use um nome único e fácil de lembrar. Se o nome já estiver em uso, a plataforma retorna uma mensagem de erro.

Informe as signing keys do QStash

As duas chaves são obrigatórias, e ambas vêm da aba QStash do seu console do Upstash.

  • QStash Current Signing Key: uma string para assinar todas as mensagens enviadas para o destino. Copie a informação QSTASH_CURRENT_SIGNING_KEY.
  • QStash Next Signing Key: uma string usada para assinar mensagens depois de você ter girado suas chaves de assinatura. Copie a informação QSTASH_NEXT_SIGNING_KEY.
Selecione Deploy para iniciar o deploy

Durante o deploy, uma janela exibe os logs. Quando ele termina, a página mostra a aplicação e as opções para continuar.

nota — O link abre a aplicação no navegador. Propagar e configurar a aplicação pela rede distribuída da Azion leva alguns minutos, portanto a URL pode não responder imediatamente.

Configurações principais

Ao ser implantado, este template cria uma function construída com os argumentos que você forneceu. Ele também cria um repositório no GitHub que carrega uma automação para deploy contínuo, e cria e instancia uma aplicação e seu domínio.

Agende tarefas

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

nota — 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

Para agendar uma tarefa pelo seu ambiente de desenvolvimento:

Obtenha o domínio da sua application
Copie seu token do QStash

No console do Upstash, copie a informação QSTASH_TOKEN na aba QStash.

Abra o terminal no seu ambiente de desenvolvimento
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

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

A cada minuto

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

A cada 10 minutos

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

A cada hora

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

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

Para agendar uma tarefa pelo console do Upstash:

Copie seu domínio da application da Azion
Abra a aba QStash

Vá para o console do Upstash e abra a aba QStash.

Preencha o formulário com as informações solicitadas

No campo Type, selecione Scheduled e escolha o delay. Para enviar uma mensagem imediata e uma única vez, selecione Once.

Selecione Schedule

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

nota — 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

Como essa configuração inicial pode não ser a ideal para a sua aplicação, todas as opções podem ser personalizadas a qualquer momento no Azion Console. Depois do deploy do template, você também tem controle total sobre as configurações da sua conta Upstash e do QStash.

Para gerenciar e editar as configurações da sua application na Azion:

Abra a página Applications

Acesse o Azion Console > Products menu > Applications. A página Applications lista todas as aplicações da conta.

Encontre a application relacionada ao template QStash Function Scheduler

A lista está organizada em ordem alfabética. A barra de busca filtra por Application Name.

Selecione a application

A página que abre carrega todas as configurações que você pode ajustar.

dica — Consulte a documentação sobre gerenciar aplicações para mais detalhes. Para dúvidas sobre Upstash ou QStash, consulte a documentação do Upstash.

Adicione um domínio personalizado

A aplicação criada durante o deploy recebe um domínio Azion Workload para ficar acessível pelo navegador, no formato xxxxxxxxxx.map.azionedge.net/. Você pode adicionar um domínio personalizado para os usuários acessarem a aplicação por ele.

Para mais informações, consulte Adicione um domínio a um workload.