Add .rst files for readthedocs for Int/Pack
[integration/packaging.git] / docs / rpms.rst
1 RPMs
2 ====
3
4
5 Automated RPM Builds
6 --------------------
7
8 OpenDaylight Integration/Packaging has added support for many variations of
9 fully automated RPM builds.
10
11
12 Build RPM Job
13 ^^^^^^^^^^^^^
14
15 The Jenkins `build_rpm job`_ builds an ODL RPM described by the `given Jenkins
16 build parameters`_, using the `build.py`_ script.
17
18
19 Build Latest Snapshot Job
20 ^^^^^^^^^^^^^^^^^^^^^^^^^
21
22 For a given major version, you can build an RPM from the latest snapshot by
23 passing `- -build-latest-snap` to build.py.
24
25 The Jenkins `build_rpm_snap job`_ builds the latest snapshot into RPM. It
26 extracts ODL version info from the artifact's URL to build artifacts. The
27 necessary JJB params to pass are OpenDaylight's major and minor version to
28 build, sysd_commit (version of ODL systemd unitfile to download and package
29 in RPM), changelog name and email.
30
31
32 CentOS CBS RPMs
33 ---------------
34
35 OpenDaylight's RPMs are built and hosted on the CentOS Community Build System's
36 Koji build servers.
37
38 All OpenDaylight RPMs, and the SRPMs with tarballs from the builds described
39 previously, are permanently available for download `here`_.
40
41 See the `Deployment#RPM`_ wiki for more information about RPMs.
42
43
44 .. _build_rpm job: https://jenkins.opendaylight.org/releng/job/packaging-build-rpm-master/
45 .. _given Jenkins build parameters: https://jenkins.opendaylight.org/releng/job/packaging-build-rpm-master/build?delay=0sec
46 .. _build.py: https://github.com/opendaylight/integration-packaging/blob/master/rpm/build.py
47 .. _build_rpm_snap job: https://jenkins.opendaylight.org/releng/job/packaging-build-rpm-snap-master/
48 .. _here: http://cbs.centos.org/koji/packageinfo?packageID=755
49 .. _Deployment#RPM: https://wiki.opendaylight.org/view/Deployment#RPM