NAME¶

pkgos-salsa-edit-webhook - add a Jenkins build-on-push webhook to a project of the Debian OpenStack team

SYNOPSIS¶

pkgos-salsa-edit-webhook --project-name <name> --debian-release <suite> --openstack-release <release> --jenkins-token <token> [--project-id <id>]

DESCRIPTION¶

pkgos-salsa-edit-webhook adds a push webhook to a project of the Debian OpenStack team on salsa.debian.org, so that any push on the debian/<openstack-release> branch triggers a build on the Jenkins instance at https://<debian-release>-<openstack-release>.debian.net. This is an alternative command line interface to pkgos-salsa-set-webhook(1). Note that this script always prints the curl command that it runs, as it enables "set -x". Like pkgos-salsa-set-webhook(1), it doesn't set a push_events_branch_filter on the webhook if the project's default branch on the GitLab side isn't named debian/<release> (for example "master"), decided by a read-only GET on the project, and sets branch_filter_strategy to all_branches instead.

OPTIONS¶

--project-name <name>

Name of the project, for example "nova". Used to resolve the project ID through pkgos-salsa-get-project-id(1) if --project-id is not given. If omitted, it defaults to the name of the Git repository containing the current working directory (ie: the basename of the toplevel directory), when running from inside a Git repository. A --project-name passed on the command line always takes precedence.

--project-id <id>

Numeric ID of the project, as optional alternative to --project-name.

--debian-release <suite>

Debian release name for which the Jenkins instance is named, for example "trixie". If omitted, it is guessed from --openstack-release using /etc/pkgos/openstack-debian-release.txt, when that release is available on exactly one Debian release; when it is available on several (eg: zed), the script refuses to guess and --debian-release must be passed explicitly.

--openstack-release <release>

OpenStack release name, for example "flamingo". Also used as the push_events_branch_filter of the webhook (ie: the debian/<openstack-release> branch). If omitted, it defaults to the OpenStack release of the currently checked-out debian/<release> Git branch, provided that release is listed in /etc/pkgos/openstack-release.txt.

--jenkins-token <token>

Authentication token of the Jenkins instance.

FILES¶

/etc/pkgos/pkgos.conf

Global OpenStack packaging tools configuration file, sourced for consistency with the other scripts.

ENVIRONMENT¶

SALSA_TOKEN

Salsa personal access token with API access. May also be set in /etc/pkgos/pkgos.conf.

EXAMPLES¶

pkgos-salsa-edit-webhook --project-name nova --debian-release trixie \

--openstack-release flamingo --jenkins-token <token>

SEE ALSO¶

pkgos-salsa-set-webhook(1), pkgos-salsa-get-project-id(1), pkgos-salsa-run-on-all-projects(1).

AUTHOR¶

This script and its man page: (c) 2026, Thomas Goirand <zigo@debian.org>, released under the Apache-2.0 license.