Merge pull request #4038 from luixxiul/fix

Update docs for configuring systemd timer calendars

docs/configuring-playbook-synapse-s3-storage-provider.md

@@ -152,3 +152,9 @@ By default, we periodically ensure that all local files are uploaded to S3 and a
 - … triggered by the `matrix-synapse-s3-storage-provider-migrate.timer` timer, every day at 05:00
 
 So… you don't need to perform any maintenance yourself.
+
+The schedule 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_synapse_ext_synapse_s3_storage_provider_periodic_migration_schedule: "*-*-* 05:00:00"
+```

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