NAME¶

pkgos-salsa-create-project - create a new project in the Debian OpenStack team namespace on Salsa

SYNOPSIS¶

pkgos-salsa-create-project --project-group <group> --project-name <name>

DESCRIPTION¶

pkgos-salsa-create-project creates a new project in one of the subgroups of the openstack-team group on salsa.debian.org, using the GitLab REST API. It then resolves the numeric ID of the newly created project, appends it to ALLGIT_FILE if not already present, and finally configures IRC notifications (see pkgos-salsa-set-irker(1)), the tagpending hook (see pkgos-salsa-set-tagpending-hook(1)) and emails-on-push (see pkgos-salsa-set-emails-on-push(1)) for it.

OPTIONS¶

--project-group <group>

Name of the subgroup (of the openstack-team group) in which to create the project, for example "services". Must be listed in SUBGROUP_FILE.

--project-name <name>

Name of the project to create, for example "nova".

--jenkins-token <token>

Accepted for convenience, though currently unused by this script.

FILES¶

/etc/pkgos/pkgos.conf

Global OpenStack packaging tools configuration file, defining SUBGROUP_FILE and ALLGIT_FILE .

/etc/pkgos/all-subgroups

Default value of SUBGROUP_FILE: list of the team's subgroups, as "<subgroup-name>,<id>" lines.

/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-create-project --project-group services --project-name nova

SEE ALSO¶

pkgos-salsa-set-irker(1), pkgos-salsa-set-tagpending-hook(1), pkgos-salsa-set-emails-on-push(1).

AUTHOR¶

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