Contents
Current Perl Team infrastructure
Git
Perl Team most prominent service is git, plus some Salsa specific features.
Salsa Group is https://salsa.debian.org/perl-team
Repository Structure
Perl Team Group on Salsa is organized as follow:
Debian Perl Group
interpreter (Perl itself)
modules (Perl modules, i.e. CPAN distributions, and other perl software)
packages (actively maintained packages)
attic (packages not in unstable anymore)
?AliothRewriter (redirects for VCS-* control fields)
perl.debian.net
scripts (Various scripts used by the team)
perl-team.pages.debian.net
Team members have "maintainer" access to the "modules" tree.
FIXME: Permissions and roles need to be described in more details
Projects settings
Short version: use dpt-salsa (1) to manage repositories on Salsa. It will set up permissions and webhooks properly.
webhooks
- tagpending: tag bugs in the BTS with "pending" when fix is seen in d/changelog
https://webhook.salsa.debian.org/tagpending/<package>
- KGB: sends notifications to IRC
http://kgb.debian.net:9418/webhook/?channel=debian-perl
Specific Repositories
MR
mr (multi repo) is the tool used by the perl team to facilitate maintaining 3K+ packages as a team.
https://salsa.debian.org/perl-team/modules/meta holds the parent repo, with the main .mrconfig.
Website
perl-team.pages.debian.net holds the website.
Static pages are generated from POD and an index is created using update-website, run on each push using gitlab CI (see .gitlab.ci.yml in the repo).
Calendar
The pkg-perl calendar file in website repo is built manually by dmn.
A static file, manually curated in git and exposed via the webspace FIXME: needs automation, should be included in CI job
Debian Package Tracker
Debian Perl Team Tracker page tracks the state of packages maintained by the team.
Tracker is taking over the (now defunct) PET, thanks to it's team features. It's still a work in progress, but features are coming in thanks to the GSoC 2018 Tracker Improvement project
Packages are tracked based on the maintainer address from d/control.
Missing features should be at least partially covered by Perl Team DMD
Missing (for now) stuff:
- sorting/filtering packages according to state
- real time (at least more often than once a day) update
Other services
Mailing Lists
lists.debian.org
Debian-perl ML on lists.debian.org
- is the main discussion list.
Mailman - https://alioth-lists.debian.net
pkg-perl list (pkg-perl-maintainers@lists.alioth.debian.org) is used for the Maintainer field. Discussion should happen on Debian-perl ML on lists.debian.org
FIXME: This is a continuation of Alioth mailman service. It might go away in the future. We will need to switch to another medium, like using tracker.debian.org for maintainer field.
LHF reminder
The LHF reminder uses https://salsa.debian.org/perl-team/scripts/tree/master/lhf-reminder and is run by dom.
perl.debian.net
Server runs on Dom's hardware. ntyni also has access.
Dependencies on (retired) alioth services (aka broken stuff)
Things that are broken now that alioth.debian.org is shut down.
Annual ping reminder
The annual ping reminder for pkg-perl members is run in alioth via pkg-ruby-extras' find-inactive-contributors, plus some additional steps for pkg-perl.
Status
This will need replacement.
Sphinx
There's a proof of concept pkg-perl manual in the website repo that is build from POD files via Sphinx and then rsync-ed to alioth manually.
Status
This should be easy to reproduce with Git pages (actually, the pkg-perl web pages were used to test the Gitlab Pages during the sprint). We might even have Sphinx available on Salsa to build the pages directly in Gitlab (if it's worth building on every push).
Examples of building gitlab pages with sphinx:
https://salsa.debian.org/tryton-team/tryton-team.pages.debian.net/blob/master/.gitlab-ci.yml
https://salsa.debian.org/qa/distro-tracker/blob/master/.gitlab-ci.yml
- ...
QA
There are also scripts/cronjobs to produce the 2 files in https://pkg-perl.alioth.debian.org/qa/
Status
This will need replacement, and won't run on Salsa.
CI coverage
script (kgb-ci-report) to post "CI coverage" notices daily on IRC: run by dam on alioth.