Project

General

Profile

OBS Maintenance » History » Version 4

osmith, 05/20/2019 10:04 AM

1 3 osmith
h1. OBS Maintenance
2
3 2 osmith
{{>toc}}
4 1 osmith
5
6
The Osmocom [[binary packages]] are built with OBS, the "openSUSE build service":https://build.opensuse.org/project/show/network:osmocom. In order to do that, the jenkins jobs "Osmocom_OBS_latest":https://jenkins.osmocom.org/jenkins/job/Osmocom_OBS_latest/ / "_nightly":https://jenkins.osmocom.org/jenkins/job/Osmocom_OBS_nightly/ ("config":https://git.osmocom.org/osmo-ci/tree/jobs/osmocom-obs.yml) checkout the source repositories and build debian *source* packages, then upload these to OBS.
7
8
h2. Install osc
9
10
Get the command-line client for managing OBS. When using for the first time, it will ask for the credentials.
11
12
<pre>
13
$ sudo apt install osc
14
$ osc ls
15
</pre>
16
17
h2. Workflow for testing OBS configurations
18
19 4 osmith
OBS has a "project configuration":https://en.opensuse.org/openSUSE:Build_Service_prjconf, which may need to be adjusted to state preferred dependencies for example. Before we apply project configurations to the official Osmocom OBS projects, we can test them in our own OBS project. Copy the relevant package first (adjust the username accordingly in all following examples):
20 1 osmith
21
<pre>
22
$ osc copypac network:osmocom:nightly osmo-gsm-manuals home:osmith42
23
</pre>
24
25
Visit the site in your browser:
26
* https://build.opensuse.org/package/show/home:osmith42/osmo-gsm-manuals
27
28
Set up build targets:
29
* https://build.opensuse.org/project/add_repository_from_default_list/home:osmith42
30
31
The package should get added to the queue already.
32
33
Open your project config next to the osmocom:nightly one:
34
* https://build.opensuse.org/project/prjconf/home:osmith42
35
* https://build.opensuse.org/project/prjconf/network:osmocom:nightly
36
37
First copy everything from the Osmocom project over to your own project. Then make changes to your config, until the builds are working as expected (dependency problems are resolved etc.). Whenever you change the config, OBS will immediately re-evaluate the build dependencies, no need to upload the source packages again.
38
39
When everything works as expected, copy the config changes you have made to the Osmocom project (nightly and latest).
40
41
Note that changing network:osmocom's project config did not seem to have any effect. It seems that we really must change both network:osmocom:nightly and :latest instead.
42
43
h2. Workflow for modifying packages
44
45
h3. (Optional) modify the debian dir
46
47
* clone the source git repository
48
* make changes to the debian dir
49
* commit your changes
50
* push to a "user/..." branch
51
52
h3. Build source packages and upload to your own OBS project
53
54
* clone osmo-ci.git
55
* open "osmo-nightly-packages.sh":https://git.osmocom.org/osmo-ci/tree/scripts/osmocom-nightly-packages.sh
56
* if you intend to make changes to the script, do them and commit the changes
57
* change "PROJ":https://git.osmocom.org/osmo-ci/tree/scripts/osmocom-nightly-packages.sh?id=dc5fc51c1fa76e64db774ecb9e71fc25ad6c46cd#n10 to home:USERNAME
58
* if you made changes to the debian dir, insert your branch name after the related "checkout line":https://git.osmocom.org/osmo-ci/tree/scripts/osmocom-nightly-packages.sh?id=dc5fc51c1fa76e64db774ecb9e71fc25ad6c46cd#n172 (e.g. <code>checkout osmo-gsm-manuals osmith/some-random-change</code>)
59
* run osmocom-nightly-packages.sh
60
* check in your browser if all packages have been built by OBS as expected (iterate until you get everything right)
61
62
When everything works fine, contribute your patches with [[Gerrit]] as usually.
63
64
65
h2. Troubleshooting
66
67
h3. Debian dir doesn't work for multiple debian versions
68
69
Following what has been done for osmo-trx:
70
* create the debian dir to work with the latest debian stable
71
* create a patch that would make it work with an earlier release (debian 8) and save it as debian/patches/build-for-debian8.patch
72
* adjust the osmocom-*-packages.sh scripts to upload a second debian source package, which has the patch applied
73
* configure OBS to build the patched package only for the older debian releases, and the unpatched package only for the stable release
74
75
h3. Package is not resolvable
76
77
78
<pre>
79
have choice for jadetex needed by docbook-utils: jadetex texlive-formats-extra
80
</pre>
81
82
You'll need to adjust the OBS project configuration (mind the testing workflow above):
83
<pre>
84
Prefer: texlive-htmlxml
85
</pre>
86
87
88
h2. See also
89
90
* https://en.opensuse.org/Portal:Build_Service
91
* https://en.opensuse.org/openSUSE:Build_Service_prjconf
Add picture from clipboard (Maximum size: 48.8 MB)