PubMan INGe Release Process
Jump to navigation
Jump to search
This page describes how to release PubMan/INGe.
Before the release[edit]
- Download Git (if not already done).
- Work with GitCmd from Git (oder GitShell from Github oder GitBash)
cd c:\temp git clone <INGE repository> (z.B. git clone https://github.com/MPDL/INGe.git) cd c:\temp\INGe git checkout <aktueller_branch> (z.B. git checkout master) git pull
- Check that release branch is not in possible conflict state with the master branch. It might happen if somebody has made a commit in master (although that shouldn't happen)
Release PubMan / INGe[edit]
Prepare the release[edit]
- Download maven (if not already done).
- Download postgres (if not already done).
- Start postgres service (if not already done).
- With pgadmin load File:Inge test.backup (if not already done)
- Work with GitCmd from Git (oder GitShell from Github oder GitBash)
- Ensure that you are inside the MPDL network (directly or VPN)
- Richtigen Java Pfad in Systemsteuerung setzen: (z.B. PATH C:\_tools\java\jdk-11.0.14.1+1\bin)
- Prüfe Java Version: (z.B. java -version)
- Prüfe Maven Version: (z.B. mvn -version)
Enable profiles: (z.B. in C:\Users\przibyll\.m2\settings-inge.xml)
- env-pure
- env-release-build
<profile>
<id>env-release-build</id>
<properties>
<inge.aa.default.target>https://dev.inge.mpdl.mpg.de/auth/clientLogin</inge.aa.default.target>
<inge.aa.instance.url>https://dev.inge.mpdl.mpg.de/auth/</inge.aa.instance.url>
<inge.cone.database.server.name>dev.inge.mpdl.mpg.de</inge.cone.database.server.name>
<inge.cone.database.user.name>xxx</inge.cone.database.user.name>
<inge.cone.database.user.password>xxx</inge.cone.database.user.password>
<inge.cone.service.url>https://dev.inge.mpdl.mpg.de/cone/</inge.cone.service.url>
<inge.database.jdbc.url>jdbc:postgresql://dev.inge.mpdl.mpg.de:5432/inge</inge.database.jdbc.url>
<inge.database.user.name>xxx</inge.database.user.name>
<inge.database.user.password>xxx</inge.database.user.password>
<inge.doi.service.url>https://test.doi.mpdl.mpg.de</inge.doi.service.url>
<inge.es.rest.host-port>https://dev.inge.mpdl.mpg.de</inge.es.rest.host-port>
<inge.es.rest.path-prefix>/es</inge.es.rest.path-prefix>
<inge.es.user/>
<inge.es.password/>
<inge.filestorage.seaweed_master_server_ip>https://dev.inge.mpdl.mpg.de/seaweedfs-master</inge.filestorage.seaweed_master_server_ip>
<inge.pid.service.url>https://test.doi.mpdl.mpg.de</inge.pid.service.url>
<inge.pubman.csl_editor.instance>http://pubman.mpdl.mpg.de/csl-editor/</inge.pubman.csl_editor.instance>
<inge.pubman.instance.url>http://localhost:8080</inge.pubman.instance.url>
<inge.rest.service.url>http://localhost:8080/rest</inge.rest.service.url>
<inge.systemtype>workstation</inge.systemtype>
<inge.unapi.service.url>http://localhost:8080/rest/unapi</inge.unapi.service.url>
<inge.rest.development.enabled>true</inge.rest.development.enabled>
<inge.rest.development.admin.username>jutta</inge.rest.development.admin.username>
<inge.rest.development.admin.password>9dg2zch4PVdshq7z</inge.rest.development.admin.password>
<inge.rest.development.file_url>https://dev.inge.mpdl.mpg.de/pubman_rest_development/development/component/</inge.rest.development.file_url>
<jboss.install.dir>C:\_tools\wildfly\wildfly-26.1.3.Final</jboss.install.dir>
</properties>
</profile>
Windows:
cd c:\temp\INGe GitCmd oder GitShell: mvn -X release:prepare -s [absolutepath/to/settings-inge.xml] -P env-release-build -DignoreSnaphots=true -DupdateReleaseInfos=true -DpreparationGoals="clean install` (z.B. mvn -X release:prepare -s C:/Users/przibyll/.m2/settings-inge.xml -P env-release-build -DignoreSnaphots=true -DupdateReleaseInfos=true -DpreparationGoals="clean install`) -> Hinweis: -X ist Debug Modus (Hab ich gebraucht, weil sonst de Tests nicht richtig liefen - irgendein Prozess hat sich nicht richtig abgemeldet.... org.apache.maven.surefire.booter.SurefireBooterForkException: The forked VM terminated without properly saying goodbye. VM crash or System.exit called?) bzw. GitBash: mvn -X release:prepare -s [absolutepath/to/settings-inge.xml] -P env-release-build -DignoreSnaphots=true -DupdateReleaseInfos=true -DpreparationGoals="clean install" (z.B. mvn -X release:prepare -s C:/Users/przibyll/.m2/settings-inge.xml -P env-release-build -DignoreSnaphots=true -DupdateReleaseInfos=true -DpreparationGoals="clean install") -> Hinweis: -X ist Debug Modus (Hab ich gebraucht, weil sonst de Tests nicht richtig liefen - irgendein Prozess hat sich nicht richtig abgemeldet.... org.apache.maven.surefire.booter.SurefireBooterForkException: The forked VM terminated without properly saying goodbye. VM crash or System.exit called?)
Linux/Mac
mvn release:prepare -s [absolutepath/to/settings-inge.xml] -P env-release-build -DignoreSnaphots=true -DupdateReleaseInfos=true -DpreparationGoals="clean install"
- For the snapshot dependencies (citation languages 1.0.1-SNAPSHOT) do following steps
- Resolve Snapshot dependencies: yes
- 0 - All
- 1.0.1-SNAPSHOT (do not copy paste, may lead to special character Errors)
- 1.0.1-SNAPSHOT (do not copy paste, may lead to special character Errors)
- restliche Vorschläge unverändert übernehmen
Neuerdings muss man sich zwischendrin an GitHub anmelden (Dazu erscheint im Browser ein Anmeldefenster...)
If a problem happened, do a rollback[edit]
mvn release:rollback Auf Github prüfen, ob schon ein neuer Tag angelegt wurde. Falls ja, folgende Befehle ausführen: git tag -d <neuer_tag_name> (z.B. git tag -d INGe-8.0.7) //comment: rollback doesn't remove the tag, that must be removed before doing a new release:prepare git push origin :neuer_tag_name (z.B. git push origin INGe-8.0.7) // comment: remove the tag in remote
Perform the release[edit]
- You need update rights for nexus!
(the site deployment is not supported so far. Therefore we skip it here)
make sure your settings has server entries (including credentials) for nexus, snapshots and releases
<servers>
<server>
<id>nexus</id>
<username>myname</username>
<password>1234</password>
</server>
<server>
<id>snapshots</id>
<username>myname</username>
<password>1234</password>
</server>
<server>
<id>releases</id>
<username>myname</username>
<password>1234</password>
</server>
</servers>
mvn -X release:perform -Dgoals=deploy -s [absolutepath/to/settings-inge.xml] -P env-release-build
(z.B. mvn -X release:perform -Dgoals=deploy -s C:/Users/przibyll/.m2/settings-inge.xml -P env-release-build)
-> Hinweis: -X ist Debug Modus (Hab ich gebraucht, weil sonst de Tests nicht richtig liefen - irgendein Prozess hat sich nicht richtig abgemeldet....
org.apache.maven.surefire.booter.SurefireBooterForkException: The forked VM terminated without properly saying goodbye. VM crash or System.exit called?)
- Ear in C:\temp\INGe\target\checkout\pubman_ear\target
- properties in C:\temp\INGe\pubman_ear\target\classes
- reindex.jar in C:\temp\INGe\target\checkout\reindex_util\target
Rework[edit]
- Reset profiles: (z.B. in C:\Users\przibyll\.m2\settings-inge.xml)
- inge_db_connector mit Tests lokal neu bauen
- Postgres Service stoppen