Update files for matrix-coturn: make the reloading schedule configurable with variables

This commit adopts the common format which can be seen for BorgBackup. It should be probably helpful, though I am not quite sure how much.

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>

docs/configuring-playbook-turn.md

@@ -64,6 +64,18 @@ jitsi_web_stun_servers:
 
 You can put multiple host/port combinations if you'd like to.
 
+### Edit the reloading schedule (optional)
+
+By default the service is reloaded on 6:30 a.m. every day based on the `matrix_coturn_reload_schedule` variable so that new SSL certificates can kick in. It is defined in the format of systemd timer calendar.
+
+To edit the schedule, add the following configuration to your `vars.yml` file (adapt to your needs):
+
+```yaml
+matrix_coturn_reload_schedule: "*-*-* 06:30:00"
+```
+
+**Note**: the actual job may run with a delay. See `matrix_coturn_reload_schedule_randomized_delay_sec` for its default value.
+
 ### Extending the configuration
 
 There are some additional things you may wish to configure about the TURN server.

roles/custom/matrix-coturn/defaults/main.yml

@@ -186,3 +186,9 @@ matrix_coturn_tls_key_path: ~
 
 matrix_coturn_tls_v1_enabled: false
 matrix_coturn_tls_v1_1_enabled: false
+
+# systemd calendar configuration for the reload job
+# the actual job may run with a delay (see matrix_coturn_reload_schedule_randomized_delay_sec)
+matrix_coturn_reload_schedule: "*-*-* 06:30:00"
+# the delay with which the systemd timer may run in relation to the `matrix_coturn_reload_schedule` schedule
+matrix_coturn_reload_schedule_randomized_delay_sec: 1h

roles/custom/matrix-coturn/templates/systemd/matrix-coturn-reload.timer.j2

@@ -3,8 +3,8 @@ Description=Reloads matrix-coturn periodically so that new SSL certificates can
 
 [Timer]
 Unit=matrix-coturn-reload.service
-OnCalendar=*-*-* 06:30:00
+OnCalendar={{ matrix_coturn_reload_schedule }}
-RandomizedDelaySec=1h
+RandomizedDelaySec={{ matrix_coturn_reload_schedule_randomized_delay_sec }}
 
 [Install]
 WantedBy=timers.target