1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
Debusine: a CI platform for Debian-based distributions
======================================================
Debusine's goal is to be an integrated solution to build, distribute and
maintain a Debian-based distribution.
Debusine is already a modern cloud-powered Continuous Integration (CI)
platform to run many packaging and distribution related workflows
for the Debian ecosystem. It can be used to automate everything from the
package build up to the generation of installer/disk/cloud/container
images, including all the intermediary quality assurance checks. It is
very versatile and easy to extend to cater to custom requirements.
To cope with the scale (dozens of thousands of packages), and with the
breadth of supported CPU architectures of a Linux distribution, Debusine
manages the scheduling and distribution of individual tasks to distributed
worker machines, including cloud workers on demand.
The following picture tries to give you a glimpse of what Debusine can do
through a sample workflow:
.. image:: images/debusine-overview.png
:alt: Sample workflow orchestrated by Debusine
If you are new to Debusine, you will want to read
:ref:`introduction` first.
.. note::
The documentation is structured by following the `Diátaxis
<https://diataxis.fr/>`_ 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.
.. toctree::
:caption: Tutorials
:maxdepth: 2
tutorials/install-your-first-debusine-instance
tutorials/getting-started-with-debusine
tutorials/set-up-workflow-templates
.. toctree::
:caption: Explanations
:maxdepth: 2
explanation/introduction
explanation/roadmap
explanation/concepts
explanation/lookups
explanation/permissions
explanation/work-request-scheduling
explanation/expiration-of-data
explanation/workflow-orchestration
explanation/signing-service
explanation/package-repositories
explanation/talks
.. todo::
Add new explanation pages to cover:
* architecture (server, worker, client)
.. toctree::
:caption: How-to guides
:maxdepth: 2
howtos/set-up-debusine-client
howtos/create-an-api-token
howtos/dput-ng
howtos/create-package-repository
howtos/manage-task-configuration-collection
howtos/index-admin
howtos/contribute
howtos/contribute-workflow
.. toctree::
:caption: Reference
:maxdepth: 2
reference/index-building-blocks
reference/deployment/index
reference/index-misc
reference/index-cli
reference/api/python-client
reference/internals/index
reference/index-contributors
reference/devel-blueprints/index
reference/release-history
reference/sponsors
.. todo::
Add new reference pages to cover:
* debusine-server configuration file
* debusine-worker configuration file
Indices and tables
==================
* :ref:`todo`
* :ref:`genindex`
* :ref:`modindex`
|
