systemd (Русский)/Timers (Русский)
Таймеры это файлы служб systemd имя которых оканчивается на .timer
они контролируют файлы .service
или события. Таймеры могут использоваться как альтернатива cron (читайте #В качестве замены cron). Таймеры имеют встроенную поддержку временных календарных событий, монотонных временных событий, и могут быть запущены в асинхронном режиме.
Contents
Юниты таймера
Таймеры systemd это файлы юнитов с суфиксом .timer
. Таймеры, как и другие файлы файлы настроек юнитов и загружаются по одному и тому же пути, но включают в себя секцию [Timer]
. Секция [Timer]
определяет, когда и как таймер активизируется. Таймеры определяются в качестве одного из двух типов:
- Монотонный таймер активируется после определенного промежутка времени по отношению к той или иной отправной точки. Есть несколько различных монотонных таймеров, но все они имеют вид:
OnTypeSec=
.OnBootSec
иOnActiveSec
являются общими монотонными таймерами. - Таймер реального времени (также известный как таймер настенный часы) активируется на события календаря (как cronjobs). Для их определения используется опция
OnCalendar=
.
Для полного объяснения опций таймера смотрите systemd.timer(5)
странице справочного руководства. Синтаксис аргументов для событий календаря и промежутка времени определяется на systemd.time(7)
странице справочного руководства.
Служба юнита
For each .timer
file, a matching .service
file exists (e.g. foo.timer
and foo.service
). The .timer
file activates and controls the .service
file. The .service
does not require an [Install]
section as it is the timer units that are enabled. If necessary, it is possible to control a differently-named unit using the Unit=
option in the timer's [Timer]
section.
Управление
To use a timer unit enable and start it like any other unit (remember to add the .timer
suffix). To view all started timers, run:
$ systemctl list-timers
NEXT LEFT LAST PASSED UNIT ACTIVATES Thu 2014-07-10 19:37:03 CEST 11h left Wed 2014-07-09 19:37:03 CEST 12h ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service Fri 2014-07-11 00:00:00 CEST 15h left Thu 2014-07-10 00:00:13 CEST 8h ago logrotate.timer logrotate.service
Пример
No changes to service unit files are needed to schedule them with a timer. The following example schedules foo.service
to be run with a corresponding timer called foo.timer
.
Монотонный таймер
A timer which will start 15 minutes after boot and again every week while the system is running.
/etc/systemd/system/foo.timer
[Unit] Description=Run foo weekly and on boot [Timer] OnBootSec=15min OnUnitActiveSec=1w [Install] WantedBy=timers.target
Таймер в реальном времени
A timer which starts once a week (at 12:00am on Monday). It starts once immediately if it missed the last start time (option Persistent=true
), for example due to the system being powered off:
/etc/systemd/system/foo.timer
[Unit] Description=Run foo weekly [Timer] OnCalendar=weekly Persistent=true [Install] WantedBy=timers.target
В качестве замены cron
Although cron is arguably the most well-known job scheduler, systemd timers can be an alternative.
Полезности
The main benefits of using timers come from each job having its own systemd service. Some of these benefits are:
- Jobs can be easily started independently of their timers. This simplifies debugging.
- Each job can be configured to run in a specific environment (see the
systemd.exec(5)
man page). - Jobs can be attached to cgroups.
- Jobs can be set up to depend on other systemd units.
- Jobs are logged in the systemd journal for easy debugging.
Предостережения
Some things that are easy to do with cron are difficult to do with timer units alone.
- Complexity: to set up a timed job with systemd you create two files and run a couple
systemctl
commands. Compare that to adding a single line to a crontab. - Emails: there is no built-in equivalent to cron's
MAILTO
for sending emails on job failure. See the next section for an example of setting up an equivalent usingOnFailure=
.
MAILTO
You can set up systemd to send an e-mail when a unit fails - much like Cron does with MAILTO
. First you need two files: an executable for sending the mail and a .service for starting the executable. For this example, the executable is just a shell script using sendmail
:
/usr/local/bin/systemd-email
#!/bin/bash /usr/bin/sendmail -t <<ERRMAIL To: $1 From: systemd <root@$HOSTNAME> Subject: $2 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset=UTF-8 $(systemctl status --full "$2") ERRMAIL
Whatever executable you use, it should probably take at least two arguments as this shell script does: the address to send to and the unit file to get the status of. The .service we create will pass these arguments:
/etc/systemd/system/status-email-user1@.service
[Unit] Description=status email for %I to user1 [Service] Type=oneshot ExecStart=/usr/local/bin/systemd-email user1@mailhost %i User=nobody Group=systemd-journal
First notice that the unit to send email about is an instance parameter, so this one service can be used to send email for many other units. However the recipient is hard-coded (since unit templates can only take a single parameter) so you will need to create multiple services if you want to send emails to different sets of recipients. At this point you should test the service to verify that you can receive the emails:
# systemctl start status-email-user1@dbus.service
Then simply edit the service you want emails for and add OnFailure=status-email-user1@%n.service
to the [Unit]
section. %n
passes the unit's name to the template.
Использование crontab
Several of the caveats can be worked around by installing a package that parses a traditional crontab to configure the timers. systemd-cron-nextAUR and systemd-cronAUR are two such packages. These can provide the missing MAILTO
feature.
If you like crontabs just because they provide a unified view of all scheduled jobs, systemctl
can provide this. See #Management.
Смотрите также
- systemd.timer man page на freedesktop.org (Англ.)
- Fedora Project wiki page on systemd calendar timers (Англ.)
- Раздел Gentoo wiki Сервисы таймеров systemd
- systemd-cron-next — утилита для создания таймеров/служб из файлов crontab и anacrontab
- systemd-cron — предоставляет юнитам systemd запускать скрипты cron; используя systemd-crontab-generator для конвертации crontab'ов