File: dput-ng-profiles.rst

package info (click to toggle)
debusine 0.14.4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 15,344 kB
  • sloc: python: 198,722; sh: 850; javascript: 335; makefile: 117
file content (53 lines) | stat: -rw-r--r-- 2,184 bytes parent folder | download | duplicates (2)
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
.. _dput-ng-profiles:

=======================
dput-ng profile options
=======================

A minimal `dput-ng <https://dput.readthedocs.io/en/latest/>`__ profile for
uploading to a Debusine server is as follows:

.. code-block:: json

    {
        "allow_unsigned_uploads": true,
        "debusine_scope": "debian",
        "debusine_workflow_data": {
            "source_artifact": "@UPLOAD@"
        },
        "debusine_workspace": "developers",
        "fqdn": "debusine.debian.net",
        "incoming": "/",
        "meta": "debusine",
        "method": "debusine"
    }

``incoming`` must be set, but its value is ignored.  In addition, either
``debusine_workflow`` or ``debusine_workflows_by_distribution`` must be set.

Supported options:

* ``fqdn``: the host name of the Debusine server
* ``debusine_scope``: the :ref:`scope <explanation-scopes>` to upload to
* ``debusine_workspace``: the :ref:`workspace <explanation-workspaces>` to
  upload to
* ``debusine_workflow``: the name of the :ref:`workflow
  <explanation-workflows>` template to start (configured by the workspace
  owners, and normally an instance of :workflow:`debian_pipeline`); optional
  if ``debusine_workflows_by_distribution`` is set)
* ``debusine_workflows_by_distribution``: a mapping from target distribution
  names in the ``.changes`` file to workflow template names, as in
  ``debusine_workflow``; optional if ``debusine_workflow`` is set.
  The ``*`` entry will be used if the target distribution is not present
  in the dictionary, and its value will be processed so that
  ``{distribution}`` is replaced by the distribution name.
* ``debusine_workflow_data``: run-time parameters to provide to the
  workflow; the string ``@UPLOAD@`` will be replaced with the artifact ID
  of your upload and the string ``@DISTRIBUTION@`` will be replaced
  with the name of the target distribution.

If you are uploading to ``debusine.debian.net``, then these options are set
to reasonable values by default.  In some cases you may need to override
``debusine_workspace`` and/or ``debusine_workflow``, and you can do that
with ``dput -O debusine_workspace=myworkspace -O
debusine_workflow=myworkflow``.