Issue #5493 has been updated by Nick Lewis.

Status changed from Unreviewed to Accepted


----------------------------------------
Bug #5493: Add version info to reports and write migration code
https://projects.puppetlabs.com/issues/5493

Author: Paul Berry
Status: Accepted
Priority: Normal
Assignee: 
Category: 
Target version: 
Affected Puppet version: 
Keywords: 
Branch: 


This ticket captures a task that Jesse, Nick, and I agreed we need to do to 
support "inspect" capability.

We would like to add a top-level attribute to the YAML for reports called 
"report_format", indicating the format of the data encoded in the report.  Its 
value will be an integer, and its meaning will be:

0=Report format used by Puppet 0.25.x

1=Report format used by Puppet 2.6.0-2.6.4

2=Report format used by Puppet 2.6.5-???

3...=Reserved for future formats

(Note: the values 0 and 1 will have to be inferred sometimes because there are 
existing reports in the field that use these formats but lack the 
"report_format" field)

In addition, we will write migration code which accepts a report object in any 
format (as deserialized from YAML) and converts it into the latest format (2) 
by modifying the data.  The first job of this migration code will be to infer 
report formats 0 and 1 if necessary.  Then it will apply transformations to get 
to format 2.  This code will be used in Dashboard to (a) translate all incoming 
reports into a common format, and (b) interpret stored reports when migrating 
to the new database schema.

Note that the transformation from version 0 to 2 will have to be done directly, 
because version 1 reports lack a "total time" metric, and this metric needs to 
be preserved when converting from version 0 to 2.  But in the future we hope to 
do transformations one version at a time.


-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to