openSUSE Build Service

Reference Guide

Publication Date 25 Jun 2012

AuthorsAdrian Schröter

Copyright © 2006–2012 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 http://www.novell.com/company/legal/trademarks/tmlist.html. 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.


Contents

About this Guide
1. OBS Motivation
1.1. Pre OBS times
1.2. Current Motivation of OBS
1.3. Future dreams
2. OBS Concepts
2.1. Project organization
2.2. The API
2.3. The OBS Interconnect
2.4. Attribute System
2.5. Automatic source processing
3. Build Process
3.1. How is a build process defined
3.2. How does a build process work
3.3. Different ways to build
3.4. Security aspects
4. Source Management
4.1. Find Package Sources
5. The Request And Review System
6. Package Formats
6.1. Setup a format
6.2. Format Specials
7. Source Services
7.1. Using services for validation
7.2. Different Modes when using services
7.3. How are source service definitions stored
7.4. How to write a source service
7.5. Interfaces for using source services
8. Signing
8.1. Package signing
8.2. Repository signing
8.3. Product signing
8.4. Configure sign key
9. Product Building
9.1. Requirements of a product
9.2. Possible shapes of a product
9.3. Product Setup in OBS
9.4. Release Management
9.5. Typical Review Process Setup
10. The Maintenance Support
10.1. Simple Project Setup
10.2. How to use the maintenance process
10.3. OBS Internal Mechanisms
10.4. How to setup projects for doing a maintenance cycle
11. Cross Architecture Build
12. Administration
12.1. Server Components
12.2. Tools for the admin
12.3. Integrate OBS into your environment
13. openSUSE Factory
13.1. openSUSE:Factory project
13.2. Devel Projects
Glossary
A. How to work on this Book
B. GNU Licenses
B.1. GNU General Public License
B.2. GNU Free Documentation License

List of Figures

10.1. Simple Project Setup