aboutsummaryrefslogtreecommitdiffstats
path: root/scripts/obs/README
diff options
context:
space:
mode:
Diffstat (limited to 'scripts/obs/README')
-rw-r--r--scripts/obs/README23
1 files changed, 22 insertions, 1 deletions
diff --git a/scripts/obs/README b/scripts/obs/README
index 67d2a2b..e6ca502 100644
--- a/scripts/obs/README
+++ b/scripts/obs/README
@@ -1,3 +1,24 @@
+Overview
+========
+This directory contains the following scripts, related to building Osmocom
+projects in OBS (Open Build Service) and building binary packages. Here is an
+overview of the scripts, run them with -h to get a more detailed description.
+
+* gerrit_binpkgs.sh: build source + binary packages like CI for gerrit
+* build_srcpkg.py: build one source package for an Osmocom project
+* update_obs_project.py: generate source packages and upload them to OBS
+* build_binpkg.py: build rpm/deb packages for one Osmocom project
+* sync_obs_projects.py: sync projects from another instance (OS#6165)
+
+Docker
+------
+The above scripts have a -d parameter, that allows running them inside docker.
+This is how we run it in jenkins to avoid installing dependencies on the host.
+
+Note that when building binary packages, libosmocore socket tests and possibly
+others will fail unless docker has ipv6 configured:
+https://osmocom.org/issues/4700#note-3
+
Usage Example: Submitting source packages to Osmocom's OBS build server
=======================================================================
@@ -29,7 +50,7 @@ Verify that it worked:
libosmo-pfcp
osmo-hnbgw
-FYI, the config file will look like this:
+FYI, the config file (oscrc) will look like this:
[general]
apiurl = https://obs.osmocom.org