Open Build Service

Reference Guide

Authors: Adrian Schröter, Frank Schreiner, and Karsten Keil
Publication Date: 11/25/2016
About this Guide
1 Distributing Free Software: Herding Cats
1.1 Goals of the OBS
1.2 History of the OBS
1.3 Future of the OBS
2 OBS Architecture
2.1 Overview graph
2.2 Backend Components
2.3 Communication flow
3 OBS Concepts
3.1 Project organization
3.2 The API
3.3 The OBS Interconnect
3.4 Download on Demand Repositories (DoD)
3.5 Integrate External Source Repositories
3.6 Attribute System
3.7 Automatic source processing
4 Build Process
4.1 How is a build process defined
4.2 How does a build process work
4.3 Different ways to build
4.4 Security aspects
5 Source Management
5.1 Find Package Sources
6 Request And Review System
6.1 What a request looks like
7 Package Formats
7.1 Setting up a format
7.2 Recipe Specials
8 Build Configuration
8.1 Configuration File Syntax
8.2 Macro Section
9 Source Services
9.1 Using services for validation
9.2 Different Modes when using services
9.3 How are source service definitions stored
9.4 Dropping a source service again
9.5 How to write a source service
9.6 Interfaces for using source services
10 Signing
10.1 Package signing
10.2 Repository signing
10.3 Product signing
10.4 Configure sign key
11 Product Building
11.1 Requirements of a product
11.2 Possible shapes of a product
11.3 Product Setup in OBS
11.4 Release Management
11.5 Typical Review Process Setup
12 Maintenance Support
12.1 Simple Project Setup
12.2 How to use the maintenance process
12.3 OBS Internal Mechanisms
12.4 How to setup projects for doing a maintenance cycle
12.5 Optional Channel Setup
13 Binary Package Tracking
13.1 Which binaries get tracked?
13.2 What data is tracked?
13.3 osc search interface
13.4 webui search interface
13.5 API search interface
14 Cross Architecture Build
15 Administration
15.1 OBS Components
15.2 OBS Appliances
15.3 Backend Administration
15.4 Frontend Administration
15.5 Tools for the admin
15.6 Integrate OBS into your environment
16 Scheduling and Dispatching
16.1 How is a build process defined
16.2 Scheduling strategies
17 Build Job Constraints
17.1 hostlabel
17.2 sandbox
17.3 linux
17.4 hardware
17.5 Constraint Handling
18 Build Preinstall Images
19 Authorization
19.1 OBS Authorization Methods
19.2 OBS Token Authorization
20 Quality Assurance(QA) Hooks
20.1 Source related checks
20.2 Build time check
20.3 Work-flow checks
21 openSUSE Factory
21.1 openSUSE:Factory project
21.2 Devel Projects
A How to work on this Book
B GNU Licenses
B.1 GNU General Public License
B.2 GNU Free Documentation License

Copyright © 2006– 2016 Novell, Inc. and contributors. All rights reserved.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled GNU Free Documentation License.

For Novell trademarks, see the Novell Trademark and Service Mark list Linux* is a registered trademark of Linus Torvalds. All other third party trademarks are the property of their respective owners. A trademark symbol (®, ™ etc.) denotes a Novell trademark; an asterisk (*) denotes a third party trademark.

All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Novell, Inc., SUSE LINUX Products GmbH, the authors, nor the translators shall be held liable for possible errors or the consequences thereof.

Print this page