Voor versiebeheer wordt Git gebruikt. Het centrale systeem waarin dit gebeurt is Forgejo. Dit heeft een webinterface.

De intentie is dat voor iedere component van het dataplatform een zogenaamde repository wordt aangemaakt. Maak hiervoor eerst een organisatie aan in Forgejo, zodat de repository's onafhankelijk zijn van een specifieke ontwikkelaar.

Eerste opzet

Voordat de repository benaderd kan worden, moeten eenmalig een aantal instellingen gezet worden. Voer daarvoor deze instructies uit via de terminal op de ontwikkelmachine met de gebruiker waarmee jij ontwikkelt:

git config --global user.name "Marc Stroo"
git config --global user.email "marc@voorbeeld.nl"
git config --global push.autoSetupRemote true
git config --global http.https://git.<servernaam>.sslVerify false
git config --global --add safe.directory '*'

Vervang <servernaam> door de volledige domeinnaam met subdomein die is gebruikt bij de installatie. Vervang naam en e-mailadres door jouw eigen gegevens.

Nieuwe repository

Maak de nieuwe repository aan in Forgejo met de knop 'Nieuwe repository'. Deze knop staat op de pagina van de organisatie. De richtlijn is om denaam van de repository te schrijven in alleen kleine letters en met liggende streepjes in plaats van spaties. Dat maakt het gebruiken van de repository in instructies makkelijker.

Nadat de repository is aangemaakt, geeft Forgejo een aantal instructies om uit te voeren in de hoofdmap van waar alles staat voor de component die in Git opgenomen moet worden. Daarbij moet een instructie anders zijn. Dit is een voorbeeld van de gewenste instructies:

touch README.md
git init
git switch -c main
git add README.md
git commit -m "first commit"
git remote add origin https://git.<servernaam>/<organisatie>/ggm_stekker_topdesk.git
git push

Vervang <servernaam> door de volledige domeinnaam zoals bij de eerste opzet. Vervang <organisatie> door de gebruikersnaam van de organisatie die is aangemaakt en waar de repository is aangemaakt. Vervang ggm_stekker_topdesk door de naam van de aangemaakte repository.