Trabalhando com temporizadores do systemd

No exemplo a seguir, usamos o comando mailx do pacote mailx. Ele requer a instalação e a configuração correta do servidor de e-mail Postfix.

1. Crie o script /usr/local/bin/send_systemd_email.

   1. O script requer dois parâmetros: $1, o endereço de e-mail, e $2, o nome do arquivo de serviço no qual a notificação de falha é recebida. Ambos os parâmetros são fornecidos pelo arquivo de unidade que executa o script de e-mail.

      #!/bin/sh
      systemctl status --full "$2" | mailx -S sendwait\
       -s "Service failure for $2" -r root@$HOSTNAME $1

   2. Verifique se o script é executável:

      > sudo chmod 755 /usr/local/bin/send_systemd_email

2. Crie o arquivo /etc/systemd/system/send_email_to_USER@.service.

   [Unit]
   Description=Send systemd status information by email for %i to USER
   
   [Service]
   Type=oneshot
   ExecStart=/usr/local/bin/send_systemd_email EMAIL_ADDRESS %i
   User=root
   Group=systemd-journal

   Substitua USER e EMAIL_ADDRESS no arquivo pelo login e endereço de e-mail do usuário que deve receber o e-mail. %i é o nome do serviço que falhou (ele é passado para o serviço de e-mail pelo parâmetro %n).

3. Verifique o arquivo de serviço e corrija os problemas relatados:

   > systemd-analyze verify /etc/systemd/system/send_email_to_USER@.service

   Se o comando não retornar nenhuma saída, o arquivo foi aprovado na verificação.

4. Para verificar o procedimento completo, inicie o serviço usando a instância dbus para teste. (Você pode usar qualquer outro serviço que esteja em execução. O dbus é usado neste exemplo porque a execução do serviço é garantida em qualquer instalação.)

   > sudo systemctl start send_email_to_USER@dbus.service

   Se for bem-sucedido, EMAIL_ADDRESS receberá um e-mail com o assunto Service failure for dbus contendo mensagens de status do dbus no corpo. (Isso é apenas um teste, não há problema com o serviço dbus. Você pode apagar o e-mail com segurança, nenhuma ação é necessária).

   Se o e-mail de teste for enviado com êxito, continue integrando-o ao arquivo de serviço.

5. Para adicionar uma notificação por e-mail ao serviço, adicione uma opção OnFailure à seção Unit do arquivo de serviço para a qual você deseja ser notificado em caso de falha:

   [Unit]
   Description="Hello World script"
   OnFailure1=send_email_to_USER2@%n3.service
   
   [Service]
   ExecStart=/usr/local/bin/helloworld.sh

   1	A opção OnFailure usa um serviço como argumento.
   2	Substitua a parte do nome de arquivo da unidade de serviço pelo nome de login.
   3	Especifica o nome do serviço (neste exemplo, helloworld). Esse nome está disponível no arquivo de serviço de e-mail como %i.

Você configurou com êxito a notificação de falha para os serviços do systemd.

1. Crie um arquivo de serviço executando o script. Consulte o Exemplo 1, “O arquivo de serviço” para obter os detalhes.

2. Crie um arquivo de temporizador executando o arquivo de serviço. Consulte o Exemplo 2, “O arquivo de temporizador” para obter instruções gerais.

   1. Converta entradas de calendário. O horário é especificado de forma diferente no cron e no systemd. Use os padrões abaixo como modelo de conversão:

      Cron:               Minute Hour Day Month DayOfWeek
      systemd: OnCalendar=DayOfWeek Year-Month-Day Hour:Minute:Second

      Para testar a entrada de calendário convertida, siga as instruções na Seção 5, “Testando entradas de calendário”.

   2. Converta apelidos do cron (@NICK):

      Cron     : systemd timer
      -------- : ----------------------------
      @reboot  : OnBootSec=1s
      @yearly  : OnCalendar=*-01-01 00:00:00
      @annually: OnCalendar=*-01-01 00:00:00
      @monthly : OnCalendar=*-*-01 00:00:00
      @weekly  : OnCalendar=Sun *-*-* 00:00:00
      @daily   : OnCalendar=*-*-* 00:00:00
      @hourly  : OnCalendar=*-*-* *:00:00

   3. Converta atribuições de variáveis. A atribuição de variável do systemd deve ir para a seção [Service]. Você não pode converter MAILTO dessa forma. Consulte a próxima etapa para isso.

      cron: VARIABLE=VALUE
      systemd: Environment="VARIABLE=VALUE"

   4. Configure notificações por e-mail para substituir o recurso MAILTO do cron seguindo as instruções na Seção 6, “Recebendo notificações por e-mail quando há falha no temporizador”.