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``.
|