Sovereign Cloud Stack

Eine Plattform — standardisiert, entwickelt und betrieben von Vielen.

Introducing github-manager for consistent repository and organization management

Tim Beermann, Eduard Itrich 16. August 2022

Thanks to the preliminary work from our friends at OTC and the extensive support by Tim from OSISM GmbH, we’re introducing a new way to manage our repositories and our Sovereign Cloud Stack organization on GitHub.

Why?

As our project progresses and the community grows, so does the number of repositories and members of our organization on GitHub. Keeping a consistent set of protection and access rules can be hard, especially if we want to foster a self-organizing community.

Using a gitops-like approach helps us to address this challenge in several ways:

How?

To achieve this, we’re making use of the awesome gitcontrol Ansible collection by the OTC team.

Both, configuration and workflows can be found at the github-manager repository. This will be the single source of truth to manage our repositories and GitHub organization.

Some caveats and further hints

The github-manager workflow has some limitations that need to be considered.

To be able to manage the GitHub organization, the workflow needs a valid PAT of a organization owner. This is currently only the case for Eduard. The SIG Community is working on extending the workflow to add multiple PAT. Until then, only Eduard is currently able to trigger the workflow by merging into the main branch or dispatching it manually.

In the transition to the github-manager we also renamed all old master branches to main. To switch to the new default branch, please do the following in the corresponding repositories:

git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a

Next steps

This was only a first step. In the following, we will discuss how we want to grant write and access rights within our community and which protection rules are reasonable to enforce among our repositories.

If you have any questions or feedback, you can always contact Eduard or reach out to the SIG Community that meets biweekly Wednesday at 11:05 CEST.

Über den Autor

Eduard Itrich
After graduating from university, Eduard was part of a software development team and responsible for the release management of a Linux enterprise distribution. Following up his two-year parental leave, during which he orchestrated his twin daughters rather than continuous deployment pipelines, he became the head of digitalization and IT of the medium-sized town Bühl in southwestern Germany. From 2021 until 2023, Eduard empowered the Sovereign Cloud Stack community as Open Source Community Manager and enjoyed learning from a inspiring team and fellows.