Maintainer guides

Information for GNPy maintainers

When @jktjkt gets run over by a bus, the show should go on.

Zuul CI

We're using Zuul managed by and hosted at Vexxhost. Support is done via tickets, currently only @jktjkt has access. This is our main target platform for development because it's working well with Gerrit. That way, we get per-patch review, and it's much less painful than dealing with GitHub PRs.

GitHub checks for extra CI

In order to show a shiny green check mark on commits, and to support the related fanciness, we're also using GitHub Actions for running some checks on each push and on each PR (for those cases when someone sends a PR). This is also used for automating releases -- just push a signed tag which begins with the v prefix, and PyPI and Docker gets updated with the right thing.

PyPI

Access: Jan's private account, Esther, and a Jan's dedicated account managed by @jktjkt and tied to his @telecominfraproject.com e-mail. That one has issued service tokens which can upload releases automatically. Upon a push of the release tag, a new release of the gnpy package gets uploaded automatically.

Docker Hub

GitHub Actions also build and upload a Docker image:

• one per each push, tagged as master and as a specific commit ID, such as v2.3.1-27-g88e2a0c7
• one for each release, such as v2.3.1

The uploads go to the telecominfraproject organization, but the service token was issues via the jktjkt account.