Contents
User Guide
- About this Guide
- I First Steps
- II Concepts
- III Setup
- IV Usage
- V Best Practices
- VI Reference
- 21 OBS Architecture
- 22 OBS Concepts
- 23 Build Process
- 24 Build Containers
- 25 Source Management
- 26 SCM Bridge
- 27 Supported Formats
- 28 Request And Review System
- 29 Image Templates
- 30 Multiple Build Description File Handling
- 31 Maintenance Support
- 32 Binary Package Tracking
- 33 Administration
- 34 Scheduling and Dispatching
- 35 Build Constraints
- 36 Building Preinstall Images
- 37 Authorization
- 38 Quality Assurance(QA) Hooks
- 39 openSUSE Factory
- Glossary
- A GNU Licenses
- About this Guide
- I First Steps
- 1 Beginnerʼs Guide
- 1.1 Target Audience
- 1.2 Conceptual Overview
- 1.3 Requirements for Working with the
oscCommand-Line Tool - 1.4 Covered Scenarios
- 1.5 Configuring Your System for OBS
- 1.6 Setting Up Your Home Project for the First Time
- 1.7 Creating a New Project
- 1.8 Patching Source Code
- 1.9 Branching a Package
- 1.10 Installing Packages from OBS
- 1.11 Other Useful
oscCommands
- II Concepts
- III Setup
- IV Usage
- V Best Practices
- VI Reference
- 21 OBS Architecture
- 22 OBS Concepts
- 23 Build Process
- 24 Build Containers
- 25 Source Management
- 26 SCM Bridge
- 27 Supported Formats
- 28 Request And Review System
- 29 Image Templates
- 30 Multiple Build Description File Handling
- 31 Maintenance Support
- 32 Binary Package Tracking
- 33 Administration
- 34 Scheduling and Dispatching
- 35 Build Constraints
- 36 Building Preinstall Images
- 37 Authorization
- 38 Quality Assurance(QA) Hooks
- 39 openSUSE Factory
- Glossary
- A GNU Licenses
List of Figures
- 1.1 Conceptual Overview of Open Build Service
- 8.1 Webhooks on GitHub.
- 8.2 Webhooks on GitLab.
- 8.3 Webhooks on Gitea.
- 8.4 Configuration File Location Options in Edit Token
- 8.5 Build Status
- 8.6 Build Status for Several Multibuild Flavors
- 8.7 Tokens list
- 8.8 Workflow Runs
- 8.9 Workflow Runs - Request
- 8.10 Workflow Runs - Response
- 8.11 Workflow Runs - Artifacts
- 10.1 "Manage Your Notifications" link.
- 10.2 Mark Web Notifications.
- 10.3 Mark Web Notifications for Groups.
- 10.4 Notifications Link.
- 10.5 Notifications Page.
- 10.6 Mark single notification as read.
- 10.7 Mark notification as read through toolbar.
- 10.8 Checkboxes to mark multiple notifications.
- 10.9 Mark all as read.
- 10.10 Example of notification filters.
- 11.1 Code of Conduct
- 11.2 Configuration Code of Conduct
- 11.3 Report a Comment
- 11.4 Report a User
- 11.5 Report Comment and Author
- 11.6 Reports Warning
- 11.7 Moderation-related Notifications
- 11.8 Decision Form
- 11.9 Comment Edition History
- 11.10 Moderate a Comment
- 11.11 Appeal to Decision
- 11.12 Canned Responses
- 12.1 Start page
- 12.2 Login
- 12.3 Logged in
- 12.4 Project Page
- 12.5 Updating project description
- 12.6 Creating Subprojects
- 12.7 My Projects
- 12.8 Status Monitor
- 12.9 My Projects
- 12.10 Branch Package
- 12.11 Apache Flood Branch
- 12.12 Branched Package
- 12.13 flood_succeeded_finished
- 12.14 flood_build_success
- 12.15 flood_build_log
- 12.16 My_Repository
- 12.17 Repository Structure
- 12.18 Adding a Repository to a Project
- 12.19 Adding a Download on Demand Repository
- 12.20 Download on Demand Repository Form
- 12.21 Adding Download on Demand repository sources
- 12.22 Form for Adding DoD Repository Sources
- 12.23 Form for editing DoD repository sources
- 12.24 OBS Templates Page
- 12.25 Form for creating image template subproject
- 12.26 New Image Template
- 12.27 Enabling the KIWI Image Build Repository
- 12.28 Overview of Sources of a Custom Image Template
- 12.29 Example of a Package with a KIWI XML File
- 12.30 KIWI Editor. Show screen
- 12.31 KIWI Adding a new repository - Basic Mode
- 12.32 KIWI Adding a new repository - Expert Mode
- 12.33 KIWI Use project configuration
- 12.34 KIWI Adding a new package
- 12.35 Manage a Group
- 12.36 Staging Workflow Basic Schema
- 12.37 Staging Workflow Schema
- 12.38 Creating a Staging Workflow for openSUSE:Factory
- 12.39 Staging Workflow Show Screen
- 12.40 Staging Workflow Delete Icon
- 12.41 Delete a Staging Workflow
- 12.42 Staging Workflow Configure Icon
- 12.43 Configuring a Staging Workflow
- 12.44 Create a New Staging Project
- 12.45 Copy Staging Project from Template
- 12.46 Looking into a Staging Project
- 12.47 History
- 12.48 Exclude Requests
- 15.1 openSUSE download page for package from OBS
- 21.1 Simplified OBS Component Overview
- 21.2 OBS Communication (Simplified)
- 31.1 Simple Project Setup
- 33.1 Simplified OBS Component Overview
List of Tables
List of Examples
- 1.1 Skeleton of a Spec File
- 2.1 SimpleImage File (
simpleimage) - 2.2 Flatpak Manifest (
flatpak.yaml) - 2.3 Flatpak Project config (
prjconf) - 2.4 Flatpak Project meta example
- 2.5 mkosi minimal build recipe (
mkosi.suse) for a Tumbleweed image - 2.6 mkosi Project config (
prjconf) - 2.7 mkosi Project meta example
- 4.1 Structure of a Macro Definition
- 5.1 XML Structure of Build Service Metadata
- 5.2 Directory Structure of a Build Root (
/var/tmp/build-root/) - 5.3 Excerpt of Build and Installation Requirements
- 7.1 Structure of a
_serviceFile - 24.1 registry.yaml
- 24.2 policy.json
- 24.3 policy.json
Copyright © 2006– 2024 SUSE LLC 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 SUSE trademarks, see http://www.suse.com/company/legal/. All other third-party trademarks are the property of their respective owners. Trademark symbols (®, ™ etc.) denote trademarks of SUSE and its affiliates. Asterisks (*) denote third-party trademarks.
All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither SUSE LLC, its affiliates, the authors nor the translators shall be held liable for possible errors or the consequences thereof.