Bereitstellen des Integrationsdiensts auf einem lokalen Server

  • Veröffentlicht am Sep 5, 2025
  • 1 Gelesene Minute(n)
Prev Next

Voraussetzungen

  • Server mit einem Betriebssystem, das mit Docker kompatibel ist

    • Die Bereitstellung erfolgte tester auf Windows-Rechnern

  • DNS-Eintrag und entsprechendes SSL-Zertifikat für den Webdienst des Integrationsdienstes

  • Project Access Token zum Abrufen des Docker-Images aus dem privaten Gitlab-Repository von Prevu3d mit den folgenden Berechtigungen:

    • Registrierung lesen

    • Rolle des Entwicklers

  • Docker CLI installiert

  • Docker-Desktop - Optional

Anmerkung

Das Project Access Token wird von Prevu3D nur bei Bedarf bereitgestellt. Bitte kontaktieren Sie unser Team, um den Zugang anzufordern.

Schritte zur Bereitstellung

  1. Melden Sie sich mit dem mitgelieferten Project Access Token beim Gitlab-Docker-Image-Repository an.

    docker login registry.gitlab.com -u <ANY_USERNAME> -p <PROJECT_ACCESS_TOKEN>

  2. Pullen Sie das Docker-Image für den Entwicklungsintegrationsdienst.

    docker pull registry.gitlab.com/prevu3d/product/integration-service:develop

  3. Erstellen Sie auf dem Host einen Ordner "Assets" und einen Ordner "Config". Diese Ordner werden als Mounten innerhalb des Docker-Containers verwendet. Assets enthalten Dateien, die möglicherweise für die Integrationen erforderlich sind, z. B. JSON-Schemata für die HTTP-Integration. Config enthält die Konfigurationsdatei und stellt sicher, dass sie beibehalten wird.

  4. Starten Sie den Container mit der Docker-CLI. Stellen Sie sicher, dass Sie die Ressourcen- und Konfigurationsordner bereitstellen und den Port des Integrationsdiensts binden. Der Standardwert ist 3000.

    docker run registry.gitlab.com/prevu3d/product/integration-service:develop -v path\to\assets\folder\on\host:/usr/app/assets -v path\to\config\folder\on\host:/usr/app/config -p 3000:3000

    1. Diese Umgebungsvariablen stehen auch während der Ausführungsphase zur Verfügung:

      1. PORT : Port, an den der Integrationsdienst innerhalb des Containers gebunden wird. Der Standardwert ist 3000.

      2. DEBUG_MODE : Legen Sie diesen Wert auf "true" fest, um Debug-Protokolle zu aktivieren.

      3. ASSET_SERVICE_PUBLIC_KEY : Verschlüsselungsschlüssel, der von Asset Service für diese Integration Service-Bereitstellung bereitgestellt wird.

      4. CONFIG_FILE : Name und Pfad der Konfigurationsdatei. Der Standardwert ist "/config/config.json".

      5. CONFIG_FILE_TYPE : Typ der Konfigurationsdatei. Legen Sie diese Option auf S3 fest, um eine in AWS S3 gehostete Datei oder lokal für eine Datei zu verwenden, die im Container gehostet wird. Der Standardwert ist "local"

  5. Navigieren Sie zu http://localhost:3000/config , um zu bestätigen, dass der Integrationsdienst ausgeführt wird.

  6. Konfigurieren Sie einen DNS-Eintrag, der auf den Integrationsdienst verweist, und fügen Sie ein SSL-Zertifikat hinzu, um HTTPS-Datenverkehr zu aktivieren.