ceph/README-packaging.txt

53 lines
2.2 KiB
Plaintext

!!! DO NOT SUBMIT CEPH.SPEC MODIFICATIONS TO OBS !!!
!!! CEPH.SPEC IS MAINTAINED UPSTREAM !!!
So you have an idea for how to improve ceph.spec and are preparing to submit it
to the Factory devel project. You might also intend to test your patch in the
OBS, first. Please read this before proceeding!
Instructions for submitting
---------------------------
The ceph.spec file is maintained upstream at https://github.com/ceph/ceph
The Ceph package in OBS is built from SUSE's downstream fork at
https://github.com/SUSE/ceph (specifically, the ses7p branch).
To patch ceph.spec, ideally you should use the following procedure:
1. find out the current Factory ceph maintainer(s) (e.g. by examining the
most recent entries in the ceph.changes file)
2. open PR targeting the main branch at https://github.com/ceph/ceph
Make sure to sign your commit ("git commit --signoff") using your real name
and real email address. If this is a problem, contact the current Factory
maintainers: they can act as a proxy.
3. ping the Factory ceph maintainers about your PR
The Factory ceph maintainers will take care of getting your upstream PR
reviewed, tested, merged and, if necessary, backported. They will also take care
of submitting the patch to Factory.
Alternately, for patches that make no sense to submit to upstream main,
you can open a PR against the ses7p branch of https://github.com/SUSE/ceph
then ping the Factory ceph maintainers to get that reviewed and submitted to
Factory.
Caveat for testing
------------------
If you want to test your patch (e.g. in your home project), please read the
following CAVEAT:
The ceph.spec file is maintained upstream. As a consequence of that, we cannot
simply run the downstream spec file cleaner on it. (If you are now asking
"why?", here is one reason: the spec file cleaner changes the copyright notice!
Another reason is: the spec file cleaner has been known to munge ceph.spec so
badly that it breaks the build!)
Now, if special action is not taken, the spec file cleaner will run on the
server each time you commit. That must be avoided at all costs. Fortunately, it
is easy to avoid it by passing the "--noservice" option to "osc commit", e.g.:
osc commit --noservice