Tutorial do Debian 13 / Agendar tarefas com timers systemd e diagnosticar falhas
No Debian 13, os temporizadores (timers) do systemd definem o horário de execução, e o serviço vinculado realiza o trabalho real. Mesmo que um timer esteja ativo, a tarefa pode falhar, então você deve verificar não apenas o próximo agendamento, mas também o código de saída do serviço, os logs e os resultados gerados.
Verifique os requisitos do laboratório de cópia de arquivos
Desta vez, um único arquivo de texto será copiado para um arquivo de resultado a partir da pasta dedicada do usuário comum lfstudent. Se o conteúdo original e o resultado forem iguais, ele não será sobrescrito, e se outra execução estiver acontecendo simultaneamente, ela será rejeitada por um bloqueio. Este não é um programa de backup que preserva dados de múltiplos pontos no tempo, mas sim direcionado a pequenos arquivos de teste onde o original não muda durante a operação.
Usamos flock, mktemp e cmp no systemd 257 do Debian 13. flock é um comando que obtém um bloqueio exclusivo entre processos baseado em arquivo. Se novas unidades, pastas ou scripts já existirem, verifique o conteúdo primeiro e não sobrescreva.
id lfstudent
command -v flock mktemp cmp
systemctl show lf-timer18.timer -p LoadState
ls -ld /home/lfstudent/lf-timer18
ls -l /usr/local/libexec/lf-timer18.sh /etc/systemd/system/lf-timer18.service /etc/systemd/system/lf-timer18.timer
Confirme que o timer não foi encontrado e que os caminhos de prática restantes não existem. Erros de arquivo não encontrado são um resultado esperado de verificar previamente. Se as ferramentas não existirem, consulte os pacotes com apt-cache show util-linux coreutils diffutils e instale por APT os que forem necessários. A diferença entre estado de execução e início automático é explicada no laboratório de serviços systemd e configurações drop-in.
Escreva um script de cópia de arquivo idempotente
Faça login com lfstudent para criar um original dedicado. Se a pasta já existir, mkdir falhará e o printf encadeado não será executado. Nesse caso, pare e examine o diretório existente antes de continuar.
mkdir /home/lfstudent/lf-timer18 &&
printf 'scheduled-copy-v1\n' > /home/lfstudent/lf-timer18/source.txt
Prepare uma pasta para salvar o script com privilégios de administrador e abra sudo nano /usr/local/libexec/lf-timer18.sh e salve o script completo apresentado abaixo. Se o nano não estiver disponível, escolha um editor que você utilize.
sudo install -d /usr/local/libexec
#!/bin/sh
set -eu
task_dir=/home/lfstudent/lf-timer18
exec 9>"$task_dir/.lock"
if ! flock -n 9; then
printf 'Another copy is running\n' >&2
exit 75
fi
test -r "$task_dir/source.txt"
if test -f "$task_dir/snapshot.txt" && cmp -s "$task_dir/source.txt" "$task_dir/snapshot.txt"; then
printf 'Snapshot unchanged\n'
exit 0
fi
task_tmp=$(mktemp "$task_dir/.snapshot.XXXXXX")
trap 'rm -f -- "$task_tmp"' EXIT HUP INT TERM
cat "$task_dir/source.txt" > "$task_tmp"
mv -- "$task_tmp" "$task_dir/snapshot.txt"
printf 'Snapshot updated\n'
Este é um script para ser salvo em um arquivo e não é executado como um comando ao colá-lo no terminal para substituir todo o shell atual. Após salvar, verifique a permissão de execução e a sintaxe.
sudo chmod 755 /usr/local/libexec/lf-timer18.sh
sh -n /usr/local/libexec/lf-timer18.sh
ls -l /usr/local/libexec/lf-timer18.sh
Arquivos executáveis pertencentes a administradores não podem ser modificados por usuários comuns, e a pasta de dados real é usada pelo lfstudent. mktemp cria um arquivo temporário na mesma pasta e o renomeia após a cópia, então durante a substituição normal, um programa que abre o arquivo de resultado não recebe por esse caminho uma cópia ainda pela metade. Este exemplo não garante durabilidade após falha de disco ou uma cópia consistente de um banco de dados sendo modificado simultaneamente. O novo arquivo de resultado herda as permissões de acesso restritas do mktemp.
Idempotência significa que repetir uma operação com a mesma entrada produz o mesmo resultado. Aqui, copiar a mesma entrada novamente não adiciona dados duplicados. Este script gera Snapshot unchanged e sai se o conteúdo for o mesmo. O bloqueio funciona apenas entre execuções cooperativas usando o mesmo arquivo. Ele não impede outros programas de modificar o original. Você pode verificar a aquisição de bloqueio sem espera e o comportamento de saída no manual flock.
Crie o serviço oneshot e o temporizador de intervalo
Salve a unidade de trabalho como sudo nano /etc/systemd/system/lf-timer18.service.
[Unit]
Description=Copy one lesson 18 test file
[Service]
Type=oneshot
User=lfstudent
ExecStart=/usr/local/libexec/lf-timer18.sh
Como esta é uma tarefa de execução curta que termina rapidamente, usamos oneshot. Como precisa ser chamada repetidamente, não a mantemos ativa com RemainAfterExit=yes. Este serviço será acionado por um temporizador, portanto, não é necessário adicionar uma seção [Install] ao serviço para iniciá-lo automaticamente.
Salve o seguinte em sudo nano /etc/systemd/system/lf-timer18.timer. Os intervalos de 5 segundos e 20 segundos são intervalos de prática para observar os resultados rapidamente e não são recomendados para ciclos operacionais.
[Unit]
Description=Lesson 18 interval timer
[Timer]
OnActiveSec=5s
OnUnitInactiveSec=20s
AccuracySec=1s
Unit=lf-timer18.service
[Install]
WantedBy=timers.target
Após ativar o temporizador, a primeira execução é solicitada em cerca de 5 segundos, e está configurada para ser executada novamente cerca de 20 segundos após a unidade de trabalho entrar em um estado inativo. Isso não garante execução em tempo real com precisão e pode ser atrasado dependendo da carga, das configurações de precisão, etc. Se o mesmo serviço estiver em execução, o temporizador não executará uma instância separada do serviço simultaneamente. Considerando outros pontos de entrada onde o script pode ser executado diretamente, um bloqueio também é colocado dentro do script. As opções de agendamento são baseadas na documentação systemd.timer.
sudo systemd-analyze verify /etc/systemd/system/lf-timer18.service /etc/systemd/system/lf-timer18.timer
sudo systemctl daemon-reload
sudo systemctl start lf-timer18.service
systemctl show lf-timer18.service -p Result -p ExecMainCode -p ExecMainStatus -p ActiveState
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt
sudo systemctl enable --now lf-timer18.timer
systemctl list-timers lf-timer18.timer --no-pager
A execução manual deve relatar Result=success e status de saída 0, e o cmp deve ser bem-sucedido sem saída. Em seguida, ligue o temporizador. O estado inativo de um serviço oneshot concluído pode ser um resultado normal, então leia tanto o Result quanto o código de saída juntos. O temporizador exibirá a próxima execução agendada e o horário da última execução.
Após a primeira ativação agendada, verifique o temporizador, o resultado do trabalho e os dados copiados.
systemctl is-active lf-timer18.timer
systemctl show lf-timer18.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-timer18.service -b --no-pager -n 20
cat /home/lfstudent/lf-timer18/snapshot.txt
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt
Verifique os carimbos de data/hora do journal junto com o Snapshot updated ou Snapshot unchanged e os resultados reais. O teste do curso original confirmou a ativação automática do serviço pelo temporizador e uma nova execução sem alterações quando o arquivo de origem permanecia igual.
Compare uma tarefa com falha e um temporizador ativo
Sem apagar o original, altere apenas seu nome para criar uma falha de leitura. Primeiro, verifique se o source.saved ainda não existe. Execute isso apenas em um exercício dedicado, sem outras tarefas utilizando a mesma pasta de dados.
test ! -e /home/lfstudent/lf-timer18/source.saved &&
mv /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/source.saved
sudo systemctl start lf-timer18.service
systemctl is-active lf-timer18.timer
systemctl show lf-timer18.service -p Result -p ExecMainCode -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-timer18.service -b --no-pager -n 12
systemctl list-timers lf-timer18.timer --no-pager
A solicitação de início falha: o serviço apresenta Result=exit-code e ExecMainStatus=1. O temporizador pode permanecer ativo, e a próxima execução continua agendada. Ou seja, o fato de a programação ser mantida não significa que a cópia do arquivo foi bem-sucedida. No exercício, pode-se confirmar que, após a falha, o arquivo de resultado válido anterior permanece intacto. Se o original não for restaurado antes que o temporizador seja executado novamente, a mesma falha pode se repetir.
mv /home/lfstudent/lf-timer18/source.saved /home/lfstudent/lf-timer18/source.txt
sudo systemctl start lf-timer18.service
systemctl show lf-timer18.service -p Result -p ExecMainStatus
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt
Após restaurar o original, verifique Result=success, status de saída 0 e a correspondência de conteúdo através de reexecução manual. Simplesmente executar reset-failed não restaura o arquivo original. Nas operações, os logs devem ser mantidos e os resultados das tarefas monitorados, ou notificações de falha configuradas separadamente.
Teste um conflito de bloqueio e repita após a liberação
Para observar o conflito sem interferência das chamadas automáticas, primeiro pare o temporizador do exercício e desative seu início automático.
sudo systemctl disable --now lf-timer18.timer
No terminal A, logado como lfstudent, segure o bloqueio temporariamente.
flock /home/lfstudent/lf-timer18/.lock sleep 20
Execute no Terminal B com o mesmo usuário antes que 20 segundos se passem.
/usr/local/libexec/lf-timer18.sh
echo $?
Another copy is running e o código de saída 75 definido pelo script são esperados. O código 75 é escolhido explicitamente pelo script; um conflito em flock -n retorna 1 por padrão. Se você executá-lo novamente após o comando no Terminal A terminar, ele terá sucesso. Não determine que está bloqueado apenas porque o arquivo de bloqueio permanece. O que importa é se um processo ainda mantém o bloqueio sobre o arquivo e, se você excluir o arquivo para resolver uma colisão, um alvo de bloqueio separado pode ser criado, permitindo execução duplicada.
Escolha um temporizador de calendário ou cron
Se você precisar de horários baseados em calendário, como 2h todos os dias no fuso Asia/Seoul, em vez de timers de intervalo para prática, considere OnCalendar. Primeiro, analise a expressão abaixo e confira a próxima execução. O exemplo mantém o fuso do teste original. Para executar às 2h no horário de São Paulo, substitua Asia/Seoul por America/Sao_Paulo tanto nesta consulta quanto em OnCalendar. Para outra região, escolha o identificador IANA correspondente; confira as próximas datas e eventuais transições de horário. Manter Asia/Seoul programa o horário coreano, independentemente da localização do computador.
systemd-analyze calendar '*-*-* 02:00:00 Asia/Seoul'
Abaixo está um exemplo separado que pode ser usado ao substituir o arquivo de timer existente. Substitua as configurações de intervalo; não mantenha OnActiveSec e OnUnitInactiveSec junto com este cronograma de calendário. Se múltiplas condições de agendamento forem usadas juntas, ela pode ser acionada por qualquer uma das condições. A execução automática real e a comparação de falhas no teste do curso original foram realizadas usando o timer de intervalo curto mencionado anteriormente.
[Unit]
Description=Daily lesson 18 file copy
[Timer]
OnCalendar=*-*-* 02:00:00 Asia/Seoul
Persistent=true
Unit=lf-timer18.service
[Install]
WantedBy=timers.target
Se você escolher a variante de calendário, primeiro pare este temporizador de laboratório, substitua todo o seu arquivo e execute sudo systemd-analyze verify /etc/systemd/system/lf-timer18.timer. Se a validação for bem-sucedida, execute sudo systemctl daemon-reload, depois sudo systemctl enable --now lf-timer18.timer e inspecione systemctl list-timers lf-timer18.timer --no-pager. Para retornar ao teste de intervalo curto, pare o temporizador, restaure o arquivo completo anterior, valide, recarregue e inicie-o novamente. A análise do calendário foi verificada no laboratório original; a compensação por execução perdida não foi exercitada.
Persistent=true só tem efeito em temporizadores com OnCalendar. Ao reativá-los, solicita uma execução de compensação se ao menos um horário programado tiver ocorrido durante a inatividade. Ele não reproduz sequencialmente todas as execuções pelo número de vezes perdidas, nem é uma opção que tenha o mesmo efeito que o temporizador de intervalo anterior. Tarefas baseadas em calendário também precisam verificar a sincronização com o tempo do sistema e o fuso horário. As regras de expressão podem ser encontradas na documentação systemd.time.
| Requisitos | Critério de escolha |
|---|---|
| Gestão abrangente de contas de serviço, dependências, códigos de saída e journal | Combinar um serviço e um temporizador systemd |
| Manter comandos periódicos simples existentes específicos do usuário | Verificar a configuração atual do cron, variáveis de ambiente e gerenciamento de saída |
| Compensar tarefas de calendário durante o período em que esteve desligado | Verificar a configuração Persistent do temporizador; não assumir que o cron comum fornece comportamento equivalente de compensação |
| Evitar a execução duplicada do mesmo script | Para qualquer ferramenta de agendamento, verificar também outros pontos de entrada e o design de bloqueio |
Como no manual do crontab do Debian , o cron requer consideração separada do usuário que executa, do ambiente e das condições de manipulação de e-mail ou saída. Não registre a mesma tarefa de forma redundante tanto no cron quanto no timer. Mais importante do que a escolha da ferramenta é uma configuração onde você possa observar os resultados reais da execução e as falhas.
Remova somente as unidades e os arquivos do laboratório
Se você ativou a variante de calendário com Persistent=true, pare o timer e execute sudo systemctl clean --what=state lf-timer18.timer antes de excluir seu arquivo de unidade para remover seu timestamp de ativação armazenado. A versão de intervalo curto não cria esse estado de Persistent.
Se você aplicou um exemplo de calendário, esse temporizador também está sujeito à limpeza. Pare as unidades primeiro, confirme que nenhuma cópia continua em execução e remova apenas os arquivos criados para este exercício.
sudo systemctl disable --now lf-timer18.timer
sudo systemctl stop lf-timer18.service
sudo rm -- /etc/systemd/system/lf-timer18.timer /etc/systemd/system/lf-timer18.service /usr/local/libexec/lf-timer18.sh
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt /home/lfstudent/lf-timer18/.lock
rmdir -- /home/lfstudent/lf-timer18
systemctl show lf-timer18.timer -p LoadState
systemctl show lf-timer18.service -p LoadState
Certifique-se de que ambas as unidades exibem LoadState=not-found e que a pasta foi excluída. Se o nome temporário original ou outros arquivos permanecerem na pasta, reveja o conteúdo antes de processar, e não use exclusão recursiva para contornar essa verificação. Preserve diretórios compartilhados, como /usr/local/libexec, outros temporizadores e arquivos de journal existentes.




