Processen
Processen övergripande
Git flow exempel hämtade från:
https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow
http://nvie.com/posts/a-successful-git-branching-model/
http://danielkummer.github.io/git-flow-cheatsheet/
Övergripande om processen
- Branchen master innehåller endast taggade produktions-releaser.
- Branchen develop är där ny funktionalitet införs (integration branch)
- Varje feature utvecklas i en egen branch med develop som ursprunglig branch.
- När en feature är klar mergas den tillbaka in i develop.
- När branchen develop innehåller tillräckligt med features för en release, skapas en release-branch, och samtidigt startas utvecklingen för nästa release.
- I release-branch görs endast bug-fixar och dokumentationsuppdateringar.
- När den release-branch är redo att skeppas, mergas den till master och taggas med version, efter det mergas ändringar till develop.
- En support branch är en långlivad 'master-branch' för en viss version.
Namnkonventioner
develop-branch: develop
release-branch: release/v<version>, tex release/v2.3.0
feature-branch: feature/<JIRA nr>, tex feature/SKLTP-123
hotfix-branch: hotfix/<JIRA nr>, tex hotfix/SKLTP-123
support-branch: support/<version>, tex support/v.2.3.0
tag: <version>, tex v2.3.0
kommentar: ex SKLTP-123: Loggning av payload skall vara konfigurerbar av/på
SKLTP/NTjP/Inera's Informationstjänster git branch mot driftmiljö
Git flow processen och exempel med git-flow installerat
Nedan exempel med verktyget git-flow och motsvarande git kommandon om man inte har tillgång till verktyget
https://github.com/nvie/gitflow
https://github.com/nvie/gitflow/wiki/Command-Line-Arguments
Installera verktyget git flow
Git flow kommer med git installation (verifierat på Windows)
Git flow första gången
Git flow krävs att man kör init det första gången. Med parametrar -d tar det default konfiguration.
─$ git flow init -d
Införa ny funktionalitet (feature branch)
Starta en feature branch
─$ git flow feature start SKLTP-123
Switched to a new branch 'feature/SKLTP-123'
Summary of actions:
- A new branch 'feature/SKLTP-123' was created, based on 'develop'
- You are now on branch 'feature/SKLTP-123'
Now, start committing on your feature. When done, use:
git flow feature finish SKLTP-123
Dela en feature branch
╰─$ git flow feature publish SKLTP-123 Total 0 (delta 0), reused 0 (delta 0) To git@github.com:skltp-aggregerandetjanster/riv.clinicalprocess.healthcond.basic.GetAggregatedObservation.git * [new branch] feature/SKLTP-123 -> feature/SKLTP-123 Already on 'feature/SKLTP-123' Your branch is up-to-date with 'origin/feature/SKLTP-123'. Summary of actions: - A new remote branch 'feature/SKLTP-123' was created - The local branch 'feature/SKLTP-123' was configured to track the remote branch - You are now on branch 'feature/SKLTP-123'
Stega upp version i källkoden (pom.xml) genom att köra update-versions. Det ska säkerställa att vi har rätt version i pom filerna i develop när kod blir mergat från feature till develop.
╰─$ mvn release:update-versions -DdevelopmentVersion=x.x+1.x-SNAPSHOT ╰─$ git commit -a -m "Updated pom version on feature branch before merge" ╰─$ git push
Färdigställ en feature branch
╰─$ git flow feature finish SKLTP-123 Switched to branch 'develop' Already up-to-date. Deleted branch feature/SKLTP-123 (was 039205e). Summary of actions: - The feature branch 'feature/SKLTP-123' was merged into 'develop' - Feature branch 'feature/SKLTP-123' has been removed - You are now on branch 'develop'
Göra en release (release branch)
Starta en release branch
Ersätta 1.0.0 med lämplig version nummer.
─$ git-flow release start 1.0.0
Switched to a new branch 'release/1.0.0'
Summary of actions:
- A new branch 'release/v1.0.0' was created, based on 'develop'
- You are now on branch 'release/1.0.0'
Follow-up actions:
- Bump the version number now!
- Start committing last-minute fixes in preparing your release
- When done, run:
git flow release finish '1.0.0'
Stega upp version i källkoden (pom.xml) genom att köra update-versions och slutföra med git flow release publish så att andra utvecklare kan se den
╰─$ mvn release:update-versions -DdevelopmentVersion=x.x.x-RC1-SNAPSHOT ╰─$ git commit -a -m "Updated pom version to RC1-SNAPSHOT" ╰─$ git flow release publish 1.0.0
Release RC version:er
╰─$ mvn release:prepare -DtagNameFormat=@{project.version}
╰─$ mvn release:perform -Darguments="-Dmaven.deploy.skip=true"
eller om man har behörighet att checka in på Nexus
╰─$ mvn release:perform
╰─$ git push --all
Verifiera att versionen stegats upp och taggats korrekt i git
╰─$ git status On branch release/1.0.0 No changes to be committed: ╰─$ git tag 1.0.0-RC1
Release utan RC version:er. Final release.
Obs: Stega upp version i källkoden (pom.xml) genom att köra update-versions to x.x+1.x-SNAPSHOT
╰─$ mvn release:update-versions -DdevelopmentVersion=1.0.0
╰─$ git commit -a -m "Updated pom version to final version"
╰─$ git push
╰─$ mvn release:prepare -DtagNameFormat=@{project.version}
╰─$ mvn release:perform -Darguments="-Dmaven.deploy.skip=true"
eller om man har behörighet att checka in på Nexus
╰─$ mvn release:perform
Stega upp version i källkoden (pom.xml) genom att köra update-versions igen
╰─$ mvn release:update-versions -DdevelopmentVersion=1.1.0-SNAPSHOT ╰─$ git commit -a -m "Updated pom version to 1.1.0-SNAPSHOT" ╰─$ git push --all
Verifiera att versionen stegats upp och taggats korrekt i git
╰─$ git status On branch release/1.0.0 No changes to be committed: ╰─$ git tag 1.0.0 1.0.0-RC1
Färdiställ release branch
╰─$ git flow release finish -n -p
Göra en rättning på en publicerad release (hotfix branch)
Påbörja en hotfix branch
╰─$ git-flow hotfix start v.2.3.1
Färdigställ en hotfix branch
╰─$ git-flow hotfix finish v.2.3.1
Skapa en långlivad support branch för att kunna rättningar på äldre versioner (support branch)
Påbörja en långlivad support branch
╰─$ git-flow support start v.2.3.0
Skapa en långlivad support branch för att kunna rättningar på äldre versioner (support branch)
Skapa en långlivad support branch
git checkout -b support/v2.3.0 master