# dput-ng profile options

A minimal dput-ng profile for uploading to a Debusine server is as follows:

    {
        "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 scope to upload to

- `debusine_workspace`: the workspace to upload to

- `debusine_workflow`: the name of the workflow template to start (configured by the workspace owners, and normally an instance of 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`.