GSB 7.0 Standardlösung

Mandantenrelease erstellen

1. Aufbau des Mandanten-Releases

Zur Ablage eines Mandanten-Releases ist folgende Ordnerstruktur vorgesehen: Zuerst ein Verzeichnis mit dem Namen des Mandanten. Darin dann ein Verzeichnis dessen Name die Version des Release angibt, inklusive der Information ob es sich bei dem Release um einen Snapshot handelt. In diesem Verzeichnis werden die Artefakte für die einzelnen Service-Typen abgelegt:

  • eventdispatcher
  • httpd
  • indexer
  • infrastructure
  • site
  • solr

Alle weiteren Daten, die nicht für das Deployment des GSB/OS benötigt werden, wie z.B. die Beispiel-Laufzeitkonfiguration, können in einem beliebigen Verzeichnis abgelegt werden.

Bei Artefakten die als Webapplikation innerhalb eines Tomcats deployed werden sollen, wie der Site oder dem Indexer, wird folgende Ablagestruktur vorrausgesetzt: {Servicetyp}/webapps/{Name der Webapplikation}

2. Erzeugung des Mandanten-Releases

Bitte nutzen Sie zum Einbinden des Projektes in eine IDE die zusätzlich bereitgestellten Entwicklersourcen. Diese finden Sie ebenfalls im Downloadbereich.

Hinweise:

Um den Einstieg in die Entwicklung zu erleichtern werden die beiden Zip-Dateien
benötigt:

- standardlsg-10.1.0-git.zip enthält die Sourcen des kompletten Mandanten Standardlösung
- gsbos-full-10.1.0-maven.zip enthält ein "Maven-Repository" welches für das Aufsetzen der Umgebung benötigt wird.

Die Informationen sind zwar im 10.1.0er Release im Wesentlichen schon enthalten, müssten aber noch geeignet zusammenkopiert werden. Dies kann durch Nutzung der Zip-Files abgekürzt werden.

Als Quick-Reader finden Sie an dieser Stelle nochmals kurz die Schritte für eine einfache Einrichtung einer GSB 10 Mandantenentwicklungsumegbung:

- Entpacken der Standardlösung (standardlsg-10.1.0-git.zip) in einem Ordner standardlsg
- Entpacken des Maven-Repositories (gsbos-full-10.1.0-maven.zip) in einem Ordner m2
- Ergänzung des lokal (entpackten Maven-Repositories) in der Datei standardlsg/build.gradle
s.a. Kommentare "//Hier ggf. noch das Repository mit den GSB-Artefakten eintragen"
bspw. maven { url "file:///ABSOLUTER-PFAD-ZUM-LOKALEN-MAVEN-REPOSITORY" }

Anschließend kann die Standardlösung in der IDE der Wahl (IDEA, Eclipse) als Gradle-Projekt geöffnet werden.

Diese Tasks führt einen gleichnamigen Task in den Unterprojekten des Mandanten aus. Diese Kompilieren bei Bedarf die enthaltenen Java und sammeln die Konfigurationen, Templates und sonstige Dateien ein und legen sie in der benötigten Struktur ab.

Der Task des Hauptprojekts führt die Ergebnisse der übrigen Tasks zusammen und kopiert sie in ein temporäres Release-Verzeichnis. Aus diesem wird ein Zip-Archiv erzeugt, welches das vollständige Release des Mandanten enthält. Das Zip-Archiv befindet sich im Verzeichnis „build/distributions“ im Hauptverzeichnis des Mandanten.

3. Bereitstellung des Mandanten-Releases für das Deployment

Damit ein zuvor erstelltes Mandanten-Release beim Deployment berücksichtigt werden kann, muss diese in dem „customers“-Ordner des Gesamt-Releases entpackt abgelegt werden.

Die Beschreibung der weiteren Deployment-Schritte, wie der Erzeugung eines PlatformBundles, ist der GSB/OS Installationsanleitung zu entnehmen.