Story #3919


As a user, I can manage modular Errata content

Added by ttereshc almost 6 years ago. Updated about 5 years ago.

Start date:
Due date:
% Done:


Estimated time:
(Total: 0:00 h)
Platform Release:
Sprint Candidate:
Pulp 2
Sprint 43


If an erratum is released for modular content, it will contain information about a module the RPMs are relevant to.
Information about a module is added to a collection in a pkglist.
Each collection corresponds to one module or to non-modular content.
There can be multiple collections in one pkglist (this is just for information, no changes here, it's this way now).
The module element is optional. Absence of the module element means that the collection is for normal non-modular RPMs and should be processed as usual.

Example of the modular errata content can be found in updateinfo.xml in the fixtures repo:

Here is the snippet of the new format:

    <collection short="">
        <module name="kangaroo" stream="0" version="20180730223407" context="deadbeef" arch="noarch"/>
        <package arch="noarch" name="kangaroo" release="1" src="" version="0.3">
        <package ... >
    <collection short="">

For upload, JSON is usually used, so the format will be:

    "issued": "2015-03-05 05:42:53 UTC",
    "pkglist": [{
                   "name": "coll_name1",
                   "module": {
                                 "name": "duck",
                                 "stream": "0",
                                 "version": "20180730233102",
                                 "context": "deadbeef",
                                 "arch": "noarch"
                    "packages": [{
                                    "arch": "noarch",
                                    "filename": "duck-0.7-1.noarch.rpm",
                                    "name": "duck",
                                    "release": "1",
                                    "sum": ["sha256", "ceb0f0bb58be244393cc565e8ee5ef0ad36884d8ba8eec74542ff47d299a34c1"],
                                    "version": "0.7",
                                }, { 
                   "name": "coll_name2",



  • Sync should recognize module element in the erratum and save it on the model
  • no changes to the model itself are needed (aka migration is not needed) due to changes in the nested structure, inside a pkglist.
  • Publish should respect the module element and publish info about the module in the errata if this info is available
  • see the fixture repo
  • publish should filter by module being available in the repo; modular errata rpms not attached to a module present in the repo should be excluded from publishing
  • publish should continue filtering by rpms being available in the repo
  • if no rpms are found for/associated with an erratum but module information is specified, such erratum has to be published. It's possible that just module metadata changed and no rpms has been updated, e.g an rpm was removed from the artifacts to fix the module issue.
  • document that filtering of errata being published is performed according to rpms and modules present in a repo
  • make sure collection names are unique per erratum (Pulp takes care of that and regenerates collection names to make them unique. I think at the moment coll_name = repo_id + idx, the suggestion is to make it, repo_id + module info + idx)
  • Upload should support the module element
  • see the JSON format in the description above
  • Copy
  • simple copy is expected to just work
  • copy with --recursive flag should respect the module info in the erratum
  • a whole module should be copied in this case: all its RPMs, module itself but related module_defaults should not be copied.
  • Search API
  • probably no changes needed, it should just work

Out of scope: Applicability (it will be implemented as a separate story).


Mind that the module and rpms listed in the erratum are the fixed ones (the ones present in the repo)

Sub-issues 2 (0 open2 closed)

Story #3959: Modular errata sync and publishCLOSED - CURRENTRELEASEmilan

Issue #4002: pulp-admin doesn't support uploading modular errataCLOSED - WONTFIXActions

Also available in: Atom PDF