Skapa release (generell instruktion)

Skarpa releaser och RC bör skapas med hjälp ett release jobb i Ineras Jenkins server men kan i undantagsfall skapas enligt instruktion nedan. Se även Skapa release med Jenkins.

Här beskrivs hur vi genomför en release mha Git, Maven och Ineras Nexus( samt tidigare Sonatype). För allmän information om releasehantering se Release management.

För mer information om hur Git används se /wiki/spaces/SKLTP/pages/3187835204.

Kontrollera se.skltp komponenter i Ineras Nexus

1. Logga in på Ineras Nexus och verifiera att det inte redan finns komponent byggd med samma versionnummer. Finns redan en komponent kommer deployjobbet att misslyckas.

Merge develop till master

2. Kontrollera att det inte finns några utestående ändringar lokalt eller centralt för develop.

$ git pull
$ git status

3. Byt till master. Kolla att inga utestående ändringar finns!

$ git checkout master
$ git pull
$ git status

4. Merge develop till master

$ git merge develop -m "Merge from develop"

Gör release mha Maven release plugin

För att deploya krävs att projektet är uppsatt korrekt i pom och i maven settings, se Release management

5. Bygg och verifiera att du har en stabil och korrekt version.

$ mvn clean test

6. Gör eventuellt en dryRun för att se hur en release kommer att påverka din kod. Detta görs framförallt när man hanterar nya artefakter/projekt och då för att verifiera att versionhanteringsparametrar är korrekt satta.

$ mvn release:clean release:prepare -DdryRun=true

7. Utför första steget av releasen med prepare kommandot.

För mer information se http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html

$ mvn release:clean release:prepare

8. Gör steg 2 i releasen mha perform kommandot

För mer information se http://maven.apache.org/maven-release/maven-release-plugin/perform-mojo.html

$ mvn release:perform

Möjliga problem vid körning av release pluginet

Man fastnar vid steget git push: detta kan lösas genom att skicka med användarnamn och lösenord "-Dusername=USERNAME -Dpassword=XXX"
Fel vid generering av javadoc: För att skippa javadoc kan man lägga till -Darguments="-Dmaven.javadoc.skip=true". Kör man deploy skip läggs "-Dmaven.javadoc.skip=true" i befintliga "-Darguments."

Förbered för nästa utvecklingscykel

10. Byt till develop

$ git checkout develop

11. Merge develop från master

$ git merge master -m "Merge from master"

12. Bygg i Maven för att verifiera att du inte har några problem i develop.

$ mvn clean install

13. Push master och develop samt taggar till origin (eller använd SourceTree))

$ git push --tags origin develop:develop master:master

Redeploy till Nexus

Om releasen av någon anledning inte laddas upp till Nexus så kan man köra om uppladdningen med

mvn deploy --no-plugin-updates -P skltp -f pom.xml

Man får antingen checka ut den tag som ska laddas upp eller så kan man ställa sig i checkoutkatalogen som relese:perform skapat i targetkatalogen.