[pbs-devel] applied-series: [PATCH proxmox-backup v3 00/10] notifications: cleanup in preparation of overridable templates

Thomas Lamprecht t.lamprecht at proxmox.com
Wed Apr 2 14:45:08 CEST 2025


Am 28.03.25 um 11:22 schrieb Lukas Wagner:> When the notification system was brought to PBS, the template strings
> were moved to the template files as they were, without any changes.
> The original templates were an implementation detail which were not
> exposed to the user in any way.
> They were bit inconsistent with regards to how template variables were
> named (e.g. '{{datastore}}', '{{store}}', '{{job.store}}' for
> referring to a datastore), as well es how variables/helpers 
> were accessed ({{ var }} vs {{var}}).
> 
> With [#6143] on the horizon, notification templates, template variables
> and template helpers become part of our public API and as such
> we should provide some stability guarantees for them.

Series seems alright to me, I'm just wondering a bit how that guarantee
will look like? But probably better part of the series that is actually
implementing [#6143].

> As a result, we use this opportunity to do a 'final' cleanup.
> 
> The aims of this series are:
>   - cleanup inconsistencies in the existing templates
>   - add custom types which are used to pass template variables
>     to the notification system, serving as documentation of what
>     is passed exactly to each template, as well as protection
>     against accidentally leaking interal code changes into
>     the template rendering process
> 
> This series also removes the HTML version of the test notification template.
> In PBS, this was the only template for which we shipped an HTML version.
> This might bee a bit confusing for users writing their own templates,
> hence it is removed. If we ever add HTML templates for the other notification
> types we can add it back.
> 
> [#6143] https://bugzilla.proxmox.com/show_bug.cgi?id=6143
> 

> proxmox-backup:
> 
> Lukas Wagner (10):
>   notifications: move make notifications module a dir-style module
>   notifications: add type for GC notification template data
>   notifications: add type for ACME notification template data
>   notifications: add type for APT notification template data
>   notifications: add type for prune notification template data
>   notifications: add type for sync notification template data
>   notifications: add type for tape backup notification template data
>   notifications: add type for tape load notification template data
>   notifications: add type for verify notification template data
>   notifications: remove HTML template for test notification
> 

applied series, thanks!




More information about the pbs-devel mailing list