| |
@@ -1,4 +1,6 @@
|
| |
- With Modularity, you no longer build individual packages. Instead, you need to submit a module build.
|
| |
+ = Submitting module builds in Fedora
|
| |
+
|
| |
+ NOTE: With Modularity, you no longer build individual packages. Instead, you need to submit a module build.
|
| |
|
| |
Module builds are triggered using `fedpkg` from within your dist-git repository.
|
| |
|
| |
@@ -12,7 +14,7 @@
|
| |
* `NAME` — name of the module
|
| |
* `BRANCH` — name of the stream branch of the module
|
| |
|
| |
- NOTE: Please note the module build ID. You will need it to verify the build state. It also helps you in the next step.
|
| |
+ NOTE: Please note the module build ID. You will need it to verify the build state and to publish the module later.
|
| |
|
| |
To watch the state of your module build, run:
|
| |
|
| |
@@ -20,4 +22,22 @@
|
| |
$ fedpkg module-build-watch BUILD_ID
|
| |
----
|
| |
|
| |
- When the module is in a "ready" state, the build has successfully completed.
|
| |
\ No newline at end of file
|
| |
+ When the module is in a "ready" state, the build has successfully completed.
|
| |
+
|
| |
+ == Rebuild strategies
|
| |
+
|
| |
+ In case you want to control which packages get rebuilt and which get reused, you can enforce a specific rebuild strategy while submitting a build.
|
| |
+
|
| |
+ There are different rebuild strategies to choose from:
|
| |
+
|
| |
+ * ``all`` — All packages in the module get rebuilt.
|
| |
+ * ``only-changed`` — Only packages that have changed since the last successful build get rebuilt.
|
| |
+ * ``changed-and-after`` — This one leverages xref:making-modules/defining-modules.adoc#_building_in_a_specific_order_optional[build groups (buildorder)]. Packages that have changed changed since the last successful build get rebuilt, and also all packages with a buildorder higher than any of the changed ones get rebuilt as well. This is the **default** in Fedora.
|
| |
+
|
| |
+ To enforce a specific rebuild strategy, submit the module build with the following command:
|
| |
+
|
| |
+ ----
|
| |
+ $ fedpkg module-build --optional rebuild_strategy=STRATEGY
|
| |
+ ----
|
| |
+
|
| |
+ * `STRATEGY` — name of a specific build strategy (listed above)
|
| |
Documenting rebuild strategies.
As part of this I had to move the "building modules" section out of "adding new modules" and "updating modules" to make it more visible.