NAME¶

pkgos-salsa-new-openstack-release - roll out a new OpenStack release across all projects of the Debian OpenStack team

SYNOPSIS¶

pkgos-salsa-new-openstack-release --old-openstack-release <release> --new-openstack-release <release> --debian-release <suite> --jenkins-token <token> [--debug]

DESCRIPTION¶

pkgos-salsa-new-openstack-release rolls out a new OpenStack release on all of the team's repositories on salsa.debian.org, by iterating over every repository listed in ALLGIT_FILE using pkgos-salsa-run-on-all-projects(1): it sets the default branch of each project to debian/<new-release> (see pkgos-salsa-set-default-branch(1)), and adds the Jenkins build-on-push webhook (see pkgos-salsa-set-webhook(1)). Note that --old-openstack-release is currently not used by the script, though it is mandatory. With --debug, each involved script only prints the curl commands, but nothing is sent to the GitLab API.

OPTIONS¶

--old-openstack-release <release>

Name of the previous OpenStack release. Currently unused, though mandatory.

--new-openstack-release <release>

Name of the OpenStack release being rolled out, for example "grizzly".

--debian-release <suite>

Debian release name for which the Jenkins instances are named, for example "trixie".

--jenkins-token <token>

Authentication token of the Jenkins instances.

--debug

Only print the curl commands that would be run, and do not perform any API call.

FILES¶

/etc/pkgos/pkgos.conf

Global OpenStack packaging tools configuration file, defining ALLGIT_FILE.

/etc/pkgos/all-git

Default value of ALLGIT_FILE: list of the team's Git repositories, as "openstack-team/<subgroup>/<project>.git,<project-id>" lines.

ENVIRONMENT¶

SALSA_TOKEN

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

EXAMPLES¶

pkgos-salsa-new-openstack-release --old-openstack-release flamingo \

--new-openstack-release grizzly --debian-release forky --jenkins-token <token> --debug

SEE ALSO¶

pkgos-salsa-run-on-all-projects(1), pkgos-salsa-set-default-branch(1), pkgos-salsa-set-webhook(1), pkgos-salsa-new-branch(1).

AUTHOR¶

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