Deployment von BPC Modulen und Themes

Es gibt verschiedene Methoden, um ein Modul oder ein Theme zu deployen. Im Folgenden erhalten Sie einen umfassenden Überblick über alle verfügbaren Optionen. Für detaillierte Anleitungen zum Deployment von BPC-Instanzen, einschließlich der Konfiguration von Zielsystemen und der Nutzung des Deployment-Wizards, siehe Deployment.

Deployment über den deploy-Ordner

Die erzeugte WAR-Datei soll in den deploy Ordner des Karaf Servers kopiert werden.

  • Manuell
    aus dem jeweiligen Repository-Ordner/build die War-Datei kopieren und in karaf-4.x.x/deploy einfügen.

  • Via Terminal
    z.B. über den Befehl
    cp build/bpc-theme-template.war /usr/local/opt/bpc/karaf-4.2.0-SNAPSHOT/deploy

Deployment über den Modul-Upload im BPC

Die WAR-Datei kann außerdem über die BPC-Benutzeroberfläche hochgeladen werden:

Dazu öffnen Sie Globales Menü > Über Business Process Center.

Der Button für Modul-Upload befindet sich im sich öffnenden Fenster:

module upload deployment

Deployment über SSH

Voraussetzungen

Um den Deployment-Prozess erfolgreich durchzuführen, müssen folgende Voraussetzungen erfüllt sein:

  • Die Public/Private Key-Authentifizierung ist eingerichtet.
    Den generierten Schlüssel finden Sie im Verzeichnis ~/.ssh.

    Alternativ können Sie auch die Authentifizierung mit Benutzername und Passwort verwenden. Stellen Sie sicher, dass in der Datei users.properties die Rolle "ssh" für den Benutzer gesetzt ist.

  • Ihr öffentlicher SSH-Schlüssel ist auf dem Server hinterlegt.
    Der Schlüssel muss in die Datei ~/.ssh/authorized_keys des Zielservers kopiert werden. Dies kann von einem Administrator oder einer berechtigten Person durchgeführt werden.

Deployment und Bauen des Moduls

  1. Bauen Sie das Modul, um zu testen, ob alles funktioniert:

    • Unter Linux/Mac: ./gradlew --stacktrace

    • Unter Windows: gradlew --stacktrace

  2. Verwenden Sie scp (Secure Copy Protocol), um die WAR-Datei von Ihrem lokalen Rechner auf den Zielserver zu übertragen.
    Der Standardport ist 8101.

    scp -P PORT PFAD/ZUR/DATEI USER@SERVER:/deploy

    Beispiel:

    scp -P 8101 path/to/local/war/mywar.war virtimo@<ip_address>:/deploy

Ihr Build-Artefakt wurde damit erfolgreich in das BPC-System deployed und sofort aktiviert.

Über das Deployment können Sie innerhalb des BPC einzelne Module und BPC Konfigurationen von einer BPC Installation auf eine andere übertragen.