Como agendar tarefas recorrentes com crontab direto pelo terminal
Oi! Aqui é a Sensei da GeHost 🌱 Hoje vamos falar de um superpoder que muita gente nem sabe que tem na hospedagem: o crontab. Com ele, você agenda tarefas para rodarem sozinhas — sem você precisar clicar em nada — em horários e frequências que você define. Backup automático de um script, limpeza de arquivos temporários, disparo de um processo do seu sistema... tudo isso pode virar rotina automática.
Vamos com calma, passo a passo, do jeitinho que a Sensei gosta de ensinar.
O que é o crontab, afinal?
Pensa no crontab como uma agenda do servidor. Você escreve nela "rode esse comando todo dia às 3 da manhã" ou "rode essa tarefa toda segunda-feira", e o servidor obedece, sem falha e sem precisar de ninguém acordado para apertar o botão.
💡 Dica da Sensei: crontab é um recurso avançado, feito para quem já tem alguma familiaridade com terminal/SSH. Se você nunca usou terminal antes, tudo bem ir com calma — ou pedir uma mãozinha do suporte para o primeiro agendamento.
Passo 1 — Acesse o terminal via SSH
Primeiro, você precisa estar conectado ao seu servidor via SSH (com um programa como o PuTTY, no Windows, ou o Terminal, no Mac/Linux). Se você ainda não tem os dados de acesso SSH, eles ficam disponíveis no seu painel do cliente, em painel.gehost.com.br, ou podem ser solicitados ao suporte.
Passo 2 — Abra o editor do crontab
Com o terminal aberto e conectado, digite o comando abaixo e aperte Enter:
crontab -e
Na primeira vez, o sistema pode perguntar qual editor de texto você prefere usar. Se aparecer essa pergunta e você não tiver certeza, escolha a opção que menciona nano — é o mais simples de usar (as instruções de "sair e salvar" ficam na parte de baixo da tela).
Passo 3 — Entenda a estrutura de uma linha do crontab
Cada tarefa agendada é uma linha, sempre no mesmo formato:
minuto hora dia-do-mês mês dia-da-semana comando
- minuto: de 0 a 59
- hora: de 0 a 23
- dia-do-mês: de 1 a 31
- mês: de 1 a 12
- dia-da-semana: de 0 a 6 (0 = domingo)
Quando você usa um asterisco (*) em algum desses campos, está dizendo "vale qualquer valor aqui".
Passo 4 — Alguns exemplos práticos
Veja como fica a "tradução" de algumas frases comuns para uma linha de crontab:
- Todo dia, às 3h da manhã:
0 3 * * * /caminho/do/seu/script.sh
- A cada hora, no minuto 0:
0 * * * * /caminho/do/seu/script.sh
- Toda segunda-feira, às 9h:
0 9 * * 1 /caminho/do/seu/script.sh
- No primeiro dia de cada mês, à meia-noite:
0 0 1 * * /caminho/do/seu/script.sh
💡 Dica da Sensei: sempre use o caminho completo do script ou comando (por exemplo /home/seuusuario/scripts/backup.sh), em vez de só o nome do arquivo. O cron não conhece os "atalhos" que o seu terminal conhece, então ele precisa do endereço completinho para não se perder.
Passo 5 — Salve e confira se deu certo
Depois de digitar sua linha, salve o arquivo (no nano, geralmente é Ctrl+O para gravar e Ctrl+X para sair). Para conferir se sua tarefa foi mesmo agendada, digite:
crontab -l
Isso lista todas as tarefas agendadas na sua conta. Se a linha que você criou aparecer ali, está tudo certo!
Como remover uma tarefa agendada
Se quiser remover ou alterar uma tarefa, é só rodar crontab -e de novo, apagar (ou editar) a linha correspondente e salvar. Simples assim — o crontab sempre reflete exatamente o que está escrito nele no momento.
Cuidados importantes
- Teste o comando manualmente antes de agendá-lo, para ter certeza de que ele funciona sozinho, sem depender de nada que só existe quando você está logado.
- Evite agendar tarefas muito pesadas para rodarem com frequência excessiva (por exemplo, a cada minuto) — prefira intervalos que façam sentido para o que você realmente precisa.
- Guarde uma cópia do que você agendou fora do servidor também (num bloco de notas seu, por exemplo), assim você sempre lembra o que configurou e por quê.
💡 Dica da Sensei: se você tiver dúvida sobre um caminho de arquivo, um comando específico do seu projeto, ou não tiver certeza se algo é seguro para automatizar, é sempre melhor chamar o suporte antes de agendar. Um script rodando sozinho, sem supervisão, merece um cuidado extra na hora de configurar. 🌿
E é isso! Agora você já sabe como fazer o servidor trabalhar por você, no automático. Qualquer dúvida durante o processo, o suporte da GeHost está aqui para ajudar. Até a próxima! 🙏
