Agendando execuções automáticas
Com os agendamentos do GoAMS, você programa seus processos para rodarem automaticamente em horários e frequências específicas. Neste tutorial, você vai aprender a criar agendamentos, configurar a frequência usando opções predefinidas ou expressões cron, e deixar tudo rodando no piloto automático.
O que é um agendamento?
Um agendamento é uma configuração que define quando e com que frequência um processo deve rodar. Quando chega o momento programado, o GoAMS cria automaticamente um Job e o envia para o Runner designado. Você não precisa fazer nada manualmente — basta configurar uma vez.
Tela de agendamentos
Na seção de Agendamentos do painel GoAMS, você encontra a lista de todos os seus agendamentos. Cada agendamento mostra o nome, o processo vinculado, o Runner designado e a frequência configurada. A partir dessa tela você pode criar novos agendamentos, editar ou desativar os existentes.
Criando um novo agendamento
Passo 1: Acesse a seção de Agendamentos
No painel do GoAMS, vá até a seção de Agendamentos (Schedules). Você verá a lista de agendamentos existentes.
Passo 2: Clique em criar novo agendamento
Clique no botão para adicionar um novo agendamento. Um formulário será exibido.
Passo 3: Preencha os dados do agendamento
Informe os dados básicos:
- Nome — um nome descritivo para identificar o agendamento
- Processo — selecione qual processo será executado
- Runner — selecione qual Runner vai executar o processo
Passo 4: Configure a frequência
Defina quando o processo deve rodar. Você pode usar as opções predefinidas ou configurar manualmente uma expressão cron.
Passo 5: Salve o agendamento
Revise as informações e salve. O agendamento ficará ativo e criará Jobs automaticamente nos horários programados.
Configurando a frequência
O GoAMS oferece duas formas de configurar quando o processo deve rodar:
Opções predefinidas
Escolha uma das opções prontas para configurar rapidamente:
A cada hora — executa o processo a cada 60 minutos
Diariamente — executa uma vez por dia no horário escolhido
Semanalmente — executa em dias da semana específicos
Mensalmente — executa em um dia específico do mês
Expressão cron (avançado)
Para configurações mais específicas, você pode editar diretamente a expressão cron. A expressão cron é gerada automaticamente quando você escolhe as opções predefinidas, mas pode ser ajustada manualmente para cenários personalizados.
Formato: minuto hora dia-do-mês mês dia-da-semana
0 9 * * * — Todos os dias às 9h
0 8 * * 1-5 — De segunda a sexta às 8h
30 18 1 * * — Dia 1 de cada mês às 18h30
*/15 * * * * — A cada 15 minutos
Dica
Você não precisa decorar a sintaxe cron. Use as opções predefinidas e o GoAMS gera a expressão automaticamente. A edição manual é apenas para quem precisa de frequências muito específicas.
Como funciona
Depois de criar o agendamento, o fluxo é automático:
O GoAMS monitora os agendamentos ativos
Quando chega o horário programado, um Job é criado automaticamente
O Job é enviado para o Runner designado
Se o Runner estiver online, a execução começa imediatamente
Você pode acompanhar os Jobs gerados na seção de Jobs
Importante
Se o Runner estiver offline no momento do agendamento, o Job será criado com status "Pendente" e executará assim que o Runner ficar online.
Resumo
Para programar execuções automáticas:
- 1
Acesse a seção de Agendamentos no painel do GoAMS
- 2
Crie um novo agendamento com nome, processo e Runner
- 3
Configure a frequência (opções predefinidas ou expressão cron)
- 4
Salve o agendamento — Jobs serão criados automaticamente
- 5
Acompanhe os Jobs gerados na seção de Jobs
Próximos passos
Com os agendamentos configurados, você pode: