Package: Release erstellen

Dieses Modul erzeugt ein Release-Archiv aus dem aktuellen Stand eines Packages in dem ausgewählten Mandanten. Das Archiv kann mit dem Modul pm.Install in einen beliebigen Mandanten eingespielt werden.

Bezeichnung

Name

pm.Build

Aliase

Build, pm.PackageBuild

Konfiguration

Gruppe: Optionen

Package (package)

Name des Package

Package-Release-Datei (zip-file)

Absoluter Pfad zur Package-Release-Datei

Verzeichnis mit der Dokumentation (docu-dir)

Der Inhalt des angegebenen Verzeichnisses wird zum Package hinzugefügt

Release-Typ (release-type)

Die Option kann genutzt werden, um die Versionnummer des neuen Releases automatisch nach den Regeln des Semantic Versioning zu setzen

Mögliche Werte: Major (major), Minor (minor), Korrektur (fix), Konfiguration (config), Undefiniert (undefined)

Benutzerdefinierte Metadaten-Einträge (custom-metadata-entries)

Eine Liste von zusätzlichen Metadaten-Einträgen, die zur Metadaten-Variable des Package hinzugefügt werden. jeder Listeneintrag besteht aus dem Key und einem Wert separiert mit einem Gleichheitszeichen.

../../_images/pm-build-options.png

Beschreibung

Das erstellte Archiv ist im ZIP-Format und enthält drei Komponenten, die in Unterverzeichnissen aufgeteilt sind.

  • config: In dem Verzeichnis befinden sich alle Konfigurationsvariablen im CSV-Format

  • runtime : In dem Verzeichnis befinden sich alle Laufzeitvariablen als leere Dateien

  • PACKAGES : In dem Verzeichnis befinden sich alle exportierten Objekte im XML-Format

In dem Verzeichnis config können sich Unterverzeichnisse befinden. Bringt ein Package Konfigurationsvariablen für Mandanten oder Umgebungen mit, dann werden diese in Unterverzeichnissen angelegt. Benannt werden die Verzeichnisse nach dem Namen der b4A-Verbindung bzw. nachdem Umgebungsnamen. Beispiel:

Enthält ein Package das Objekt PCK.BEST4AUTOMIC_BASE.VARA.DATA$$$B4A-1, dann ist die Variable eine Mandantenkonfiguration für die b4A-Verbindung B4A-1. Im Package-Archiv wird das Objekt unter folgendem Namen gespeichert:

config/B4A-1/PCK.BEST4AUTOMIC_BASE.VARA.DATA

Das gleiche Verfahren wird auf Objekte angewendet bei denen die Endung den Namen einer Umgebung trägt. Die Umgebungen entsprechen den servers- Definitionen in der Konfiguration. Gibt es in der defaults.conf folgenden Eintrag, dann wird das Objekt PCK.BEST4AUTOMIC_BASE.VARA.DATA$$$TEST als Umgebungskonfiguration identifiziert.

server-TEST = ....

Beispiele

Einfacher Bau eines Package Release

./b4A pm.Build -C DEV-0001 --package B4A.BASE --zip-file B4A.BASE-1.0.0.zip

Bau eines Package Release mit zuvor hinzugefügten benutzerdefinierten Metadaten-Einträgen

./b4A pm.Buid -C DEV-0001 --package B4A.BASE --zip-file B4A.BASE-1.0.0.zip --custom-metadata-entries "Key1=Wert1,Key2=Wert 2"