Schnellstart

Docker

Die GBD WebSuite wird als Container ausgeliefert. Um einen Container zu starten benötigen Sie eine Container Runtime wie z.B. Docker. In diesem Beispiel verwenden wir Docker mit dem Compose Plugin: Docker Engine Installationsanleitung.

docker-compose.yml

Erstellen Sie eine Datei mit dem Namen docker-compose.yml und dem folgenden Inhalt in einem beliebigen Verzeichnis:

docker-compose.yml

version: '3'

services:
    gws:
        image: gbdconsult/gws-amd64:8.1
        container_name: gws
        ports:
            - 3333:80

Download & Starten

Weisen Sie Docker an das benötigte Image herunterzuladen (ca. 500MB) und den Container zu starten:

docker compose -f docker-compose.yml up

Abhängig von Ihrem Betriebssystem und User müssen Sie dies möglicherweise als Administrator (auf Ubuntu z.B. mit sudo) tun, oder Ihrem Benutzer die benötigten Rechte geben (auf Ubuntu sudo adduser <myuser> docker).

Betrachten im Browser

Sobald der Download und der Startvorgang abgeschlossen sind, können Sie in ihrem Browser auf http://localhost:3333 das Testprojekt der GBD WebSuite sehen.

Beenden

Um die GBD WebSuite wieder zu beenden drücken Sie in dem Terminal in dem Sie aktuell die Logausgabe sehen STRG+C, oder schließen dieses.

Wo mache ich weiter?

Um basierend auf diesem Schnellstart anzufangen mit der Konfiguration der GBD WebSuite zu experimentieren, erweitern Sie die docker-compose.yml wie folgt:

MYGWSDIRECTORY/docker-compose.yml

version: '3'

services:
    gws:
        image: gbdconsult/gws-amd64:8.1
        container_name: gws
        volumes:
            - MYGWSDIRECTORY/data:/data
            - MYGWSDIRECTORY/gws-var:/gws-var
        ports:
            - 3333:80
        tmpfs:
            - /tmp
    qgis:
        image: gbdconsult/gbd-qgis-server-amd64:3.34
        container_name: qgis
        volumes:
            - MYGWSDIRECTORY/data:/data
            - MYGWSDIRECTORY/gws-var:/gws-var
        tmpfs:
            - /tmp

Passen Sie die Verzeichnis-Pfade unter volumes: für beide Container ihrem System entsprechend an. Ersetzen Sie dafür alle Vorkommen von MYGWSDIRECTORY durch einen für Ihr System gültigen Pfad.

Unter Windows könnte das z.B. C:/Users/<myusername>/Desktop/gwstest sein, und unter Linux /home/<myusername>/gwstest.

Stellen Sie sicher, dass die Verzeichnisse data und gws-var innerhalb des gwstest Verzeichnisses existieren.

Sollte Sie das erste Konfigurationsbeispiel gestartet & beendet haben müssen Sie noch mit docker rm gws den dadurch erstellen Docker Container entfernen.

Die GBD WebSuite wird dann zunächst nicht mehr funktionieren, da Sie das Konfigurationsverzeichnis auf das so eben erstellte gwstest/data Verzeichnis umgeleitet haben und dieses aktuell noch leer ist. Wie Sie dieses Verzeichnis mit einer initiellen Konfiguration füllen können wird hier beschrieben:

Guide: Einfaches Projekt

Wie Sie die GBD WebSuite auf einem Server installieren können, so dass diese Installation auch als Produktivumgebung genutzt werden kann wird hier beschrieben: Guides/Installation