NAME¶

pkgos-salsa-new-branch - create a new debian/<release> branch in a project of the Debian OpenStack team

SYNOPSIS¶

pkgos-salsa-new-branch --old-openstack-release <release> --new-openstack-release <release> --project-id <id> --project-name <name> [--debug]

DESCRIPTION¶

pkgos-salsa-new-branch creates a new debian/<new-release> Git branch from debian/<old-release> in a single project of the Debian OpenStack team on salsa.debian.org, using the GitLab REST API. It is normally invoked through pkgos-salsa-run-on-all-projects(1) to create the branch in all of the team's repositories at once. With --debug, the curl command is printed, but nothing is sent to the GitLab API.

OPTIONS¶

--old-openstack-release <release>

Name of the OpenStack release of the branch to branch from, for example "flamingo".

--new-openstack-release <release>

Name of the OpenStack release of the branch to create.

--project-id <id>

Numeric ID of the project.

--project-name <name>

Name of the project, for example "nova". 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.

--debug

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

ENVIRONMENT¶

SALSA_TOKEN

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

EXAMPLES¶

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

--project-name nova --debug

SEE ALSO¶

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

AUTHOR¶

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