From a5cc5ac10af7c5eeed98447faa404827a41fe033 Mon Sep 17 00:00:00 2001 From: ncoghlan Date: Aug 14 2017 08:27:52 +0000 Subject: [PATCH 1/2] Fix dist-git link for httpd module Previous link 404s, this is the actual destination --- diff --git a/source/development/building-modules/adding-modules-to-fedora.rst b/source/development/building-modules/adding-modules-to-fedora.rst index a867cf4..c12be7a 100644 --- a/source/development/building-modules/adding-modules-to-fedora.rst +++ b/source/development/building-modules/adding-modules-to-fedora.rst @@ -13,5 +13,5 @@ and give you write access. Make sure to mention that you need a **'module**' repository, and that you need it in production or staging. The repositories will be available in the Fedora dist git - see the `httpd -module `__ as an +module `__ as an example. From c855b15555cb86fa43a3c5dbc6b8cc2eaeb5d97d Mon Sep 17 00:00:00 2001 From: ncoghlan Date: Aug 14 2017 09:32:39 +0000 Subject: [PATCH 2/2] Explain how to clone an example module on Fedora The local module building guide didn't give a clear example of how to check that your local build environment actually works independently of the specific module you're working on. This adds an example using the F26 Boltron httpd module, while adding the caveat the Boltron's bootstrapping pretty much downloads the world as build dependencies. --- diff --git a/source/development/building-modules/building-local.rst b/source/development/building-modules/building-local.rst index 9c54e1b..f15c744 100644 --- a/source/development/building-modules/building-local.rst +++ b/source/development/building-modules/building-local.rst @@ -26,3 +26,16 @@ To build your module, run a command similar to the following: An output will be a yum/dnf repository beneath the modulebuild directory in the home of the user. Right now, using sudo, this will be root. + +To test your local build environment on Fedora, the ``httpd`` module is a +reasonable example module to start with:: + + $ fedpkg clone --branch f26 modules/httpd + $ cd httpd + $ sudo mbs-build local + +.. note:: + As an interim bootstrapping technique, building any of the F26 Boltron modules + will download and cache around 15k RPMs from Koji as potential build dependencies. + Replacing that bulk download with proper build dependency management is part of + the work being undertaken in F27.