Debusine: a software factory for Debian-based distributions

Debusine is a general-purpose software factory tailored to the needs of a Debian-based distribution. It manages the scheduling and distribution of tasks to distributed worker machines.

The documentation is structured by following the Diátaxis principles: tutorials and explanation are mainly useful to discover and learn, howtos and reference are more useful when you are familiar with debusine already and you have some specific action to perform or goal to achieve.

If you are new to debusine, you will want to read Introduction to Debusine first.

Tutorials

• Install your first debusine instance
  • Configure the hypervisor to host the debusine instance (with Incus)
  • Install the debusine virtual machine
  • Install the packages
  • Configure the webserver
  • Test the access to the web interface
  • Configure the worker
• Getting started with debusine
  • Pre-requisites
  • Install the client and configure it
  • Create a build environment
  • Create an artifact by uploading a source package
  • Submit a work request to build binary packages

Explanations

• Introduction to Debusine
  • What is Debusine
  • Debusine for Debian development
  • Next generation Debian infrastructure
  • Run distribution-wide QA experiments
  • Current development plan
  • Learn more
• Why this project
  • A central place for tasks processing the Debian archive
  • Including package building
  • With custom workflows
  • And GitLab integration
  • Conclusion
• Debusine concepts
  • Artifacts
  • Collections
  • Workspaces
  • Workers
  • Tasks
  • Work Requests
  • Workflows
• Work request scheduling
  • Lifecycle of a work request
  • Priorities
  • Ordering of work request
  • Matching of workers and work requests
  • Management of architecture-specific tasks

Todo

Add new explanation pages to cover:

• architecture (server, worker, client)

How-to guides

• Set up debusine-client
  • Introduction
  • Initial setup
  • Test the configuration
• Create an API token
  • As a debusine user
  • As a debusine administrator
  • Next steps
• Tasks for administrators
  • Set up a debusine server
  • Set up a debusine worker
  • Set up a debusine signing worker
  • Set up Incus for Debusine Task Execution
  • Add a new worker
  • Add a new user
  • Configure and manage a worker
  • Enable logins with GitLab accounts
  • Enable notifications for work requests
  • Set up APT mirroring
• Contribute to debusine
  • Join the community
  • Where to start?
  • How to contribute
  • Test latest devel branch code
  • Write access to the git repository
  • Django Debug Toolbar

Reference

• Tasks
  • Ontology for generic tasks
  • Specifications of tasks
  • GenerateKey task
  • ExtractForSigning task
  • Sign task
  • AssembleSignedSource task
• Artifacts
  • Category debian:source-package
  • Category debian:binary-package
  • Category debian:binary-packages
  • Category debian:upload
  • Category debian:package-build-log
  • Category debian:system-tarball
  • Category debian:system-image
  • Category debusine:work-request-debug-logs
  • Category debian:blhc
  • Category debian:lintian
  • Category debian:autopkgtest
  • Category debusine:signing-key
  • Category debusine:signing-input
  • Category debusine:signing-output
• Collections
  • Derived collections
  • Category debian:archive
  • Category debian:suite
  • Category debian:environments
  • Category debian:suite-lintian
  • Category debian:suite-signing-keys
  • Category debusine:workflow-internal
  • Category debian:package-build-logs
• Workflows
  • Workflow noop
  • Workflow sbuild
  • Workflow update_environments
• Lookup syntax
  • String lookup
  • Integer lookup
  • Single lookup
  • Dictionary lookup
  • List lookup
  • Multiple lookup
• Signing service
  • Requirements
  • Prior art
  • Signing workflows
  • Signing key management
  • Backend overview
  • Database models
  • HSM key availability
• Frequently Asked Questions about Debusine
  • Design choices
• Runtime environment
• Package repositories
  • The Debian repository
  • The upstream repository
  • The snapshot repository
• The debusine-admin command
  • Command output
  • Managing workers
  • Managing users
  • Manage workspaces
  • Manage work requests
  • Manage notification channels
  • Managing tokens
  • Administrative commands
• The debusine command
  • Output of the debusine command
  • Return values
  • Sub-commands
• Python client API
  • The Debusine class
  • Associated data models
  • Representation of artifacts
• Reference for debusine contributors
  • Design goals
  • Team organization
  • Design practices
  • Coding practices
  • Documentation practices
  • Internal API
• Development blueprints
  • Debootstrap task
  • Access Control Rules
  • Implementation of workflows
  • Coordinating sub-workflows
  • UI views
  • Uploading packages
  • Dependency-wait handling
• Release history
  • 0.5.0 (2024-09-03)
  • 0.4.1 (2024-06-28)
  • 0.4.0 (2024-06-24)
  • 0.3.2 (2024-06-03)
  • 0.3.1 (2024-05-28)
  • 0.3.0 (2024-05-23)
  • 0.2.1 (2024-03-07)
  • 0.2.0 (2024-02-29)
  • 0.1.0 (2022-09-09)

Todo

Add new reference pages to cover:

• debusine-client configuration file

• debusine-server configuration file

• debusine-worker configuration file

Indices and tables

• TODO to fix in the documentation

• Index

• Module Index