Führen Sie Jitterbit App Builder auf Docker aus

Einführung

Auf dieser Seite wird gezeigt, wie man App Builder als Docker Container mit Jitterbit App Builder Docker-Image und eine gültige App Builder Lizenz.

Der App Builder Das Docker-Image unterstützt diese Datenbanken:

Standard- oder Enterprise x64-Editionen von Microsoft SQL Server 2016 oder höher. Dies sollte mit der Sortierreihenfolge konfiguriert werden SQL_Latin1_General_CP1_CI_AS und Authentifizierung im gemischten Modus.
MySQL 8.0 oder höher.
PostgreSQL 14 oder höher.

Wichtig

Während Sie laufen sollten an App Builder Instanz und ihre Datenbank separat auf Hosts, die App BuilderSystemanforderungen, der Einfachheit halber wird in dieser Anleitung ein Host für beides verwendet.

Bevor Sie beginnen, benötigen Sie eine Docker-Engine und Docker compose installiert sein und beachten Sie die Einschränkungen. Für die docker run Beispiel ist eine vorhandene Datenbank erforderlich. Die docker compose und zusätzlich Beispiele hierfür sind ein Dienst, der an App Builder Datenbank, daher ist keine vorhandene erforderlich.

Unterstützte Tags

Die Docker-Image-Tags Seite zeigt, welche Tags verfügbar sind.

Tags bestehen aus App Builder Versionsnummer mit einer optionalen Buildnummer (zum Beispiel 4.0.{{ bauen }}). Tags ohne Build-Nummern (4.0) sind die aktuellsten Builds.

Aus Stabilitätsgründen sollten Sie Tags mit Buildnummern verwenden und Ihre App Builder Instanz zu diesem Build. Um eine auszuwählen, konsultieren Sie die Versionshinweise.

Start an App Builder Instanz mit `docker run`

Zum Anfang an App Builder -Instanz, die eine Verbindung zu einer vorhandenen Datenbank herstellt, die auf demselben Host ausgeführt wird, gehen Sie folgendermaßen vor:

Erstellen Sie eine Datei vinyl.env enthält die folgenden Umfeld, wobei die Werte gemäß der folgenden Tabelle ersetzt werden:

ConnectionInfo__DatabaseType=<DB TYPE>
ConnectionInfo__HostName=<DB HOSTNAME>
ConnectionInfo__DatabaseName=<DB NAME>
ConnectionInfo__Port=<DB PORT>
ConnectionInfo__UserName=<DB USERNAME>
ConnectionInfo__Password=<DB PASSWORD>

Wert	Ersetzen durch
`<DB TYPE>`	Einer von `SQLServer`, `MySQL`, oder `PostgreSql`.
`<DB HOSTNAME>`	Hostname oder IP-Adresse des Datenbankservers.
`<DB PORT>`	(Optional) Portnummer, auf der der Datenbankdienst ausgeführt wird. Standard: `1433` (SQL Server), `3306` (MySQL), `5432` (PostgreSQL).
`<DB NAME>`	(Optional) App Builder Datenbankname. Standard: `App Builder`. Dies kann alles sein, muss aber den Namensregeln der Datenbank entsprechen.
`<DB USERNAME>`	App Builder Datenbank-Benutzername.
`<DB PASSWORD>`	App Builder Passwort des Datenbankbenutzers.

(Diese und andere Umfeld werden beschrieben in Konfigurieren App Builder beim Start.)

Beispiel für PostgreSQL:

ConnectionInfo__DatabaseType=PostgreSql
ConnectionInfo__HostName=host.docker.internal
ConnectionInfo__DatabaseName=vinyl
ConnectionInfo__Port=5432
ConnectionInfo__UserName=postgres
ConnectionInfo__Password=postgres

Starten Sie den Docker-Container:

docker run --publish "80:80" --env-file vinyl.env jitterbit/vinyl:3.3

Eingeben http://localhost in die Adressleiste Ihres Browsers ein und warten Sie, bis die App Builder Anmeldeseite:
(Optional) Verwenden Sie Ihren Browser, curl oder ein Web API -Testtool, um eine GET Anfrage an den Endpoint des Containers http://localhost:80/ping Die Antwort sollte sein App Builder - OK - YYYY-mm-DDTHH:MM:SSZ, wobei Datum und Uhrzeit im UTC-Format nach ISO 8601 angegeben sind.
Melden Sie sich mit diesen Anmeldeinformationen an:
- Benutzername: admin
- Passwort: P@55w0rd (Die Standardeinstellung App Builder Administratorkennwort.)
Ändern Sie auf der Seite Kennwort abgelaufen das Standardkennwort und klicken Sie dann auf Kennwort speichern:
Klicken Sie auf der Seite Passwort geändert auf Weiter.
Klicken Sie auf der Seite Aktive Lizenz auf Hochladen:
Klicken Sie auf der Seite Lizenz-Upload auf Durchsuchen, um den Dateibrowser Ihres Systems zu öffnen. Suchen und öffnen Sie Ihre App Builder Lizenzdatei, dann auf Speichern klicken:
Klicken Sie auf der Seite Lizenz hochladen auf Aktivieren:
Klicken Sie auf der Seite Aktive Lizenz auf Starten:
Die App Builder Willkommensseite öffnet sich:

Start an App Builder Instanz und Datenbank mit `docker compose`

Das folgende Beispiel verwendet Docker Compose zum Starten an App Builder Instanz und eine Microsoft SQL Server Datenbank (weitere Beispiele unten):

Erstellen Sie in einem leeren Verzeichnis eine Datei docker-compose.yml enthält Folgendes:

version: "3"

services:
  db:
    image: mcr.microsoft.com/mssql/server
    hostname: vinyldb
    environment:
      MSSQL_SA_PASSWORD: P@55w0rd
      ACCEPT_EULA: Y
    volumes:
      - ./db_data:/var/opt/mssql/data

  vinyl:
    depends_on:
      - db
    image: jitterbit/vinyl:3.3
    ports:
      - 80:80
    volumes:
      - ./vinyl_data:/app/data
      - ./vinyl_logs:/app/logs
      - ./vinyl_keys:/app/keys
    environment:
      ConnectionInfo__DatabaseType: SQLServer
      ConnectionInfo__HostName: vinyldb
      ConnectionInfo__DatabaseName: App Builder
      ConnectionInfo__UserName: sa
      ConnectionInfo__Password: P@55w0rd

volumes:
  db_data:
  vinyl_data:
  vinyl_logs:
  vinyl_keys:

Starten Sie die Dienste:
```
docker compose up -d
```
Überprüfen Sie die Protokolldateien in vinyl_logs, montiert auf dem App Builder Protokollverzeichnis /app/logs (Die anderen Halterungen sind /app/keys wo die Verschlüsselung gespeichert sind und /app/data, das Datenverzeichnis.)
Fahren Sie fort, indem Sie die Schritte 3 bis 12 aus dem vorherigen Abschnitt.

Einschränkungen

Die folgenden Einschränkungen gelten für App Builder Ausführung als Docker-Container und für alle Linux-basierten Installationen:

Die Unterstützung für Windows Funktionen variiert je nach App Builder Version:

Anwendung	Unterstützt auf App Builder 3.3+	Unterstützt auf App Builder 3.2
IBM DB2 für i
Salesforce-Plattform1
Active Directory-Authentifizierung
Crystal-Berichte
Dateisystem-Identitätswechsel
Integrierte Windows-Authentifizierung (IWA)
SAP ABAP
Plugins von Drittanbietern

Datei-Uploads sind standardmäßig auf 30.000.000 Bytes (28,6 MB) begrenzt. Dies dient dem Schutz vor Denial-of-Service (DoS)-Angriffen.

Um dieses Limit zu erhöhen, setzen Sie die Umfeld Kestrel__Limits__MaxRequestBodySize auf die gewünschte maximale Dateigröße in Bytes.

Zusätzlich `docker compose` Beispiele

Beispiel docker-compose.yml für App Builder Verwendung von MySQL als Backend-Datenbank:

version: '3.0'

services:
  db:
    image: mysql
    hostname: vinyldb
    environment:
      MYSQL_ROOT_PASSWORD: P@55w0rd
    volumes:
      - db_data:/var/lib/mysql

  vinyl:
    depends_on:
      - db
    image: jitterbit/vinyl:3.3
    ports:
      - 80:80
    volumes:
      - ./vinyl_data:/app/data
      - ./vinyl_logs:/app/log
      - ./vinyl_keys:/app/keys
    environment:
      ConnectionInfo__DatabaseType: MySQL
      ConnectionInfo__HostName: vinyldb
      ConnectionInfo__UserName: root
      ConnectionInfo__Password: P@55w0rd

volumes:
  db_data:
  vinyl_data:
  vinyl_logs:
  vinyl_keys:

Beispiel docker-compose.yml für App Builder Verwendung von PostgreSQL als Backend-Datenbank:

version: "3"

services:
  db:
    image: postgres
    hostname: vinyldb
    environment:
      POSTGRES_PASSWORD: postgres
    volumes:
      - db_data: /var/lib/postgresql/data

  vinyl:
    depends_on:
      - db
    image: jitterbit/vinyl:3.3
    ports:
      - 80:80
    volumes:
      - ./vinyl_data:/app/data
      - ./vinyl_logs:/app/logs
      - ./vinyl_keys:/app/keys
    environment:
      ConnectionInfo__DatabaseType: PostgreSql
      ConnectionInfo__HostName: vinyldb
      ConnectionInfo__UserName: postgres
      ConnectionInfo__Password: postgres

volumes:
  db_data:
  vinyl_data:
  vinyl_logs:
  vinyl_keys: