De branch main (in oudere repositories ook wel master) wordt gebruikt voor productie. Hierin bevindt zich dus alleen productie waardige code.

Voor werk aan de code maak je altijd een nieuwe branch aan vanuit main.

De naamgeving van de branch waarin je werkt is een samenstelling van een topdesk ticketnummer of een Jira userstory nummer en de naam van degene die er aan werkt.

Doe je werk het liefst in een apparte branch. zo zitten wijzigingen van verschillende mensen elkaar het minst in de weg en is het ongedaan maken van alle wijzigingen die in voor 1 change gedan zij in 1 keer te doen.

hoe maak je in een bash shell een nieuwe branch aan:

• clone de repository van het gitlab project waar je aan gaat werken: git clone git@sv1603280.frd.shsdir.nl:ansibletower/ansible-sudoers.git
• zorg dat je in de sios branch bent: git checkout sios
• zorg dat je de laatste versie lokaal hebt: git pull origin sios
• maak lokaal een nieuwe branch vanuit deze sios branch (als voorbeeld hier een Topdesk ticket W220902489): git checkout -b W220902489_abel
• doe je wijzigingen.
• voeg eventueel nieuwe files toe door: git add -A
• commit de wijzigingen in alle files: git commit -am “commentaar over wijziging”
• Doe je een push naar de GitLab server van jou branch : git push origin W220902489_abel

op dit moment is je werk opgeslagen in je eigen remote branch (dwz op de git server)

Als je alle wijzigingen hebt doorgevoerd en vanuit je eigen branch hebt getest is het tijd om deze te mergen naar sios .

Dit doe je op de GitLab server. Log in en ga naar de repository waar je aan werkt. bovenaan zul je je laatste push zien:

druk op Create merge request en druk vervolgens op change branches om de Target branch naar sios te veranderen aangezien GitLab automatisch daar de main branch invult.

als je nog niet helemaal klaar bent maar alleen een onderdeel van je wijzigingen wilt testen in samenhang met de wijzigingen van anderen kan je eventueel het vinkje Delete source branch uitzetten, normaal gesproken wordt je change branch opgeruimd.

Vervolgens druk druk je op Assign om de merge request toe te kennen aan een collega die de merge uitvoert.

Als collega krijg je een merge request op je naam van andere collegae om het vier ogen principe te hanteren.

Als er geen merge conflicten zijn check je de wijzigingen op rare dingen en mogelijke verstoringen druk hiervoor op de knop Open in Web IDE, hier krijg je ge-highlight de wijzigingen te zien.

(plaatje hier)

Als je geen rare dingen bent tegen gekomen druk je op Merge en geef je aan degene die de wijziging heeft gedaan door dat hij kan gaan testen met de sios branch.

Wanneer de tests met develop succesvol zijn is het tijd om een merge request te doen voor develop of sios naar main.

in de rechter zijbalk druk je op Merge requests, in het scherm wat verschijnt druk linksboven op de blauwe knop New merge request

in het volgende venster selecteer sios in het pulldown menu Select source branch Target branch staat meestal al op main druk op Compare branches and continue

vervolgens assign je de merge request weer aan een andere collega wederom ter controle en om er voor te zorgen dat er als team gewerkt wordt en niet als een “Remy” allerlei wijzigingen door te voeren waar het team later door verrast wordt.