Updating modules in Fedora

This page will guide you through the process of updating an existing module.

  1. Updating RPM Packages — Pushing new sources.

  2. Updaging the Module — Pushing a new version of the modulemd.

  3. Updaging the Module — Module is built as a unit. No individual package builds are done.

  4. Publishing the Module — Submitting a Bodhi update.

Updating RPM Packages

Update your RPM packages the same way you would do traditionally, exept submitting individual package builds.

Useful resources:

Updaging the Module

Even when you don’t need to make any changes to the modulemd, you still need to push a new commit to build a new version.

$ fedpkg clone modules/NAME
$ cd NAME
$ fedpkg switch-branch BRANCH
$ git commit --allow-empty -m "update"
git push

  • NAME — name of the module

  • BRANCH — name of the stream branch of the module

Module Build

With Modularity, you no longer build individual packages. Instead, you need to submit a module build.

Module builds are triggered using fedpkg from whithin your dist-git repository.

$ fedpkg clone modules/NAME
$ cd NAME
$ fedpkg switch-branch BRANCH
$ fedpkg module-build

  • NAME — name of the module

  • BRANCH — name of the stream branch of the module

Please note the module build ID. You will need it to verify the build state. It also helps you in the next step.

To watch the state of your module build, run:

$ fedpkg module-build-watch BUILD_ID

When the module is in a "ready" state, the build has successfully completed.

Publishing the Module

To make your module available to users, submit submit as an update to Fedora Bodhi. Make sure you are logged in, and then click on Create / New Update at the top-right corner. Fill out the following fields:

  • Candidate Builds: MODULE_BUILD_ID

  • Update notes: notes for the users

  • Final details: check what applies

One way of geting the MODULE_BUILD_ID is running the same command as in the previous step:

$ fedpkg module-build-info BUILD_ID

and changing the "koji tag" value in the following way:

module-nodejs-10-20180607142235-6c81f848   <- koji tag
       nodejs-10-20180607142235.6c81f848   <- MODULE_BUILD_ID

that is removing the "module-" part at the beginning, and replacing the last "-" with a ".".