A generic system to build and distribute packages from sources in an automatic, consistent and reproducible way. Release your software for a wide range of operating systems and hardware architectures.
Ruby Perl HTML JavaScript CSS Shell Other
Permalink
Failed to load latest commit information.
.github [dist] Reword the ISSUE_TEMPLATE a bit Feb 15, 2017
contrib [ci] docker-compose based ci setup Sep 25, 2017
dist [ci] Fix backend ports for old test suites Sep 28, 2017
docs [webui][api] Add domain model for Attrib classes to docs. Oct 17, 2017
src [backend] container upload: stylistic improvements Oct 18, 2017
.gitignore [dist] Ignore the docker-compose override file Oct 5, 2017
.gitmodules [webui] no longer put whole bento theme into the git (submodule), but… Sep 18, 2012
.jshintignore [doc] Document the Backend::Api library Oct 1, 2017
.rubocop.yml [ci] Enable Style/GlobalVars rubocop cop Oct 5, 2017
.rubocop_todo.yml [frontend] Freeze mutable constants Oct 13, 2017
.travis.yml [ci] Added Stages for TravisCI configuration Aug 21, 2017
AUTHORS Add more authors to the list May 19, 2016
CONTRIBUTING.md [dist] Adopt rake tasks to container/script changes Sep 25, 2017
COPYING add GPL v2 license file Mar 2, 2006
Dockerfile [dist] Workaround an aufs bug Oct 4, 2017
Dockerfile.423 [dist] Dockerize the development environment Sep 19, 2017
Dockerfile.backend [dist] Dockerize the development environment Sep 19, 2017
Dockerfile.frontend-base [dist] Setup some convenience binaries Oct 5, 2017
Dockerfile.mariadb [dist] Dockerize the development environment Sep 19, 2017
Dockerfile.memcached [dist] Dockerize the development environment Sep 19, 2017
Makefile Revert "Create ./sysvinit/ folder for system V init" Apr 25, 2017
Makefile.include [dist] add test section to main Makefile Dec 4, 2015
README.md [dist] Use the codecov image for master Sep 18, 2017
Rakefile [frontend] Freeze mutable constants Oct 13, 2017
ReleaseNotes-2.9 [webui] Add ReleaseNotes entry for watchlist notifications. Oct 13, 2017
codecov.yml [ci] Enable coverage status reports Mar 23, 2017
docker-compose.ci.yml [ci] docker-compose based ci setup Sep 25, 2017
docker-compose.yml [dist] Ignore the docker-compose override file Oct 5, 2017
hakiri.yml [ci] Tell hakiri where the app is located Oct 5, 2015

README.md

Build Status Code Coverage Code Climate

Open Build Service

The Open Build Service (OBS) is a generic system to build and distribute binary packages from sources in an automatic, consistent and reproducible way. You can release packages as well as updates, add-ons, appliances and entire distributions for a wide range of operating systems and hardware architectures. More information can be found on openbuildservice.org.

The OBS consists of a backend and a frontend. The backend implements all the core functionality (i.e. building packages). The frontend provides a web application and XML API for interacting with the backend. Additionally there is a command line client (osc) for the API which is developed in a separate repository.

Licensing

The Open Build Service is Free Software and is released under the terms of the GPL, except where noted. Additionally, 3rd-party content (like, but not exclusively, the webui icon theme) may be released under a different license. Please check the respective files for details.

Community

You can discuss with the OBS Team via IRC on the channel #opensuse-buildservice. Or you can use our mailing list opensuse-buildservice@opensuse.org.

Development / Contribution

If you want to contribute to the OBS please checkout our contribution readme:-)

Source Code Repository Layout

The OBS source code repository is hosted on Github and organized like this:

    dist          Files relevant for our distribution packages
    docs          Documentation, examples and schema files
    src/api       Rails app (Ruby on Rails)
    src/backend   Backend code (Perl)

Installation

To run the OBS in production we recommend using our appliance which is the whole package: A recent and stable Linux Operating System (openSUSE) bundled and pre-configured with all the server and OBS components you need to get going.

If that is not for you because you have some special needs for your setup (e.g. different partition schema, SLES as base system, etc.) you can also install our packages and run a setup wizard.

After finishing the installation of your base system, follow these steps:

  1. Add the OBS software repository with zypper. Please be aware, that the needed URL differs, depending on your Base Operating System. We use openSUSE Leap 42.1 in this example.

    zypper ar -f http://download.opensuse.org/repositories/OBS:/Server:/2.7/openSUSE_42.1/OBS:Server:2.7.repo
  2. Install the package

    zypper in -t pattern OBS_Server
  3. Run our setup wizard

    /usr/lib/obs/server/setup-appliance.sh

Advanced Setup

If you have a more complex setup (e.g. a distributed backend) we recommend to read the Administration chapter in our reference manual.