Installation unter SAP BTP (Connect 2024)

Der Connect Server kann in einer SAP BTP Cloud Foundry-Umgebung gehostet werden. Dieses Kapitel beschreibt das Verfahren zur Bereitstellung des Connect Server auf der SAP BTP.

Als Voraussetzung benötigen Sie mindestens die Version 2022.1.0.1108 des Connect Servers und ein Konto auf Docker Hub mit einem privaten Repository.

Erstellung einer neuen PostgreSQL-Instanz

In diesem Abschnitt wird davon ausgegangen, dass bereits ein Space erstellt wurde, der einem Quota Plan zugewiesen ist.

Für das Hosting eines Connect Servers auf SAP BTP in Cloud Foundry wird derzeit nur Postgre SQL für die Speicherung persistenter Daten unterstützt. Um eine neue PostgreSQL-Instanz zu erstellen, navigieren Sie zu "Instances and Subscriptions" in Ihrem bevorzugten Subaccount.

Klicken Sie auf die Schaltfläche "Create", wählen Sie "PostgreSQL, hyperscaler option" als Ihren Dienst und "Cloud Foundry" als Laufzeitumgebung. Wählen Sie einen geeigneten Plan, z.B. den kostenlosen Plan, weisen Sie den zuvor erstellten Space zu und geben Sie den Namen für die Instanz ein, z.B. "connect-postgresql".

Auf dem nächsten Bildschirm können Sie die Engine-Version und das Gebietsschema konfigurieren oder die Erstellung durch Klicken auf die Schaltfläche "Create" abschließen.

Ein Service Key für die PostgreSQL-Instanz erstellen

Nachdem die PostgreSQL-Instanz erstellt wurde, können Sie Anmeldedaten für den Datenbankzugriff erstellen. Klicken Sie dazu auf das Meatballs-Menü (das Symbol mit den drei horizontalen Punkten) und wählen Sie den Punkt "Create Service Key", um einen neuen Dialog zu öffnen. In diesem Dialogfeld müssen Sie nur den Namen des Dienstschlüssels angeben. Wenn Sie fertig sind, schließen Sie das Dialogfeld mit der Schaltfläche "Create".

Wenn der Berechtigungsnachweis erstellt wurde, können Sie auf den Link in der Spalte "Credentials" klicken, um sich die Details anzusehen. Wechseln Sie im Dialog auf die Registerkarte "Form" und notieren Sie sich die folgenden Werte.

dbname
hostname
port
username
password

Anwendungseinstellungen konfigurieren und ein Docker-Image erstellen

Wenn Sie die Anmeldeinformationen für die PostgreSQL-Datenbank notiert haben, müssen Sie in den Anwendungseinstellungen des Connect Servers einen Verbindungsstring zur Datenbank definieren.

Entpacken Sie die Auslieferungsdatei der Docker-Version in einen temporären Ordner und navigieren Sie zu "/bin/server/<version>/docker". In diesem Ordner finden Sie eine Datei namens "Dockerfile" und eine Datei namens "appsettings.Default.json". Erstellen Sie eine Kopie der Datei appsettings.Default.json und benennen Sie diese “appsettings.json”.

In der Datei “appsettings.json” können Sie die Einstellungen der Anwendung nach Ihren Wünschen vornehmen. Um von der Anwendung aus auf die PostgreSQL-Datenbank zugreifen zu können, nehmen Sie bitte die folgenden Einstellungen im Abschnitt "Workspace" vor.

Legen Sie "PostgreSql" als Wert für die Eigenschaft "DbType" fest.
Legen Sie "Database" als Wert für die Eigenschaft "Provider" fest.
Fügen Sie im Abschnitt "DataSource" eine neue Eigenschaft namens "ConnectionString" hinzu.
Setzen Sie die Eigenschaft "ConnectionString" auf "User ID=<username>;Password=<password>;Host=<hostname>;Port=<port>;Database=<dbname>;Pooling=true;". Ersetzen Sie die Werte in <> durch die Werte der Anmeldedaten der PostgreSQL-Instanz.
Löschen Sie optional die Eigenschaft "RootPath" im Abschnitt "ConnectObjects", da sie nicht benötigt wird, wenn Objekte in einer Datenbank gespeichert sind.

Öffnen Sie nun das Dockerfile und nehmen Sie folgende Anpassungen vor.

Fügen Sie in der ersten Spalte von Zeile 39 das Zeichen # ein.
Entfernen Sie den relativen Pfad in Zeile 55 nach "settings=".
Löschen Sie den Port 443 in Zeile 57.

Nun können Sie das Docker-Image erstellen. Dazu öffnen Sie eine Shell und navigieren zu dem Ordner, in dem sich das Dockerfile und die Datei appsettings.json befinden.

Erstellen Sie das Docker-Image mit der folgenden Anweisung.

Ändern Sie die Werte <docker_account_name> und <repository_name> in Ihr Docker-Konto und Ihren privaten Repository-Namen. Die Angabe des Tag ist optional. Sie können z. B. die Rolle Ihres SAP BTP-Subaccounts wählen, wie z. B. "Entwicklung", "Test", "Produktion" oder etwas anderes, das Ihren Anforderungen entspricht.

Übertragen Sie das Docker-Image mit der folgenden Anweisung in den Hub.

Bereitstellung des Connect Servers auf der SAP BTP

Um das Docker-Image auf der SAP BTP bereitzustellen, öffnen Sie eine Shell und melden Sie sich bei Cloud Foundry mit der Anweisung cf login an. Verwenden Sie dann die folgende Anweisung, um das Docker-Image in Cloud Foundry zu deployen.