Merge branch 'dev-docu-additions' into 'develop'

Entwickler-Doku: CSS mit docker compose lokal ausliefern & docker/ZFS Probleme

See merge request hub/hub!1078

Development.md

@@ -114,6 +114,16 @@ Als Beispiel kann das [`hub-high-contrast.scss`](./src/plainui/styles/themes/hub
 3. Führe `yarn build` aus um das CSS zu kompilieren
 4. Um das CSS beim Entwickeln automatisch neu zu kompilieren gibt es `yarn watch`
 
+#### Kompiliertes CSS mit lokalem docker-compose Setup ausliefern
+
+Um das kompilierte CSS über eine lokale Instanz auszuliefern die z.B. mit `docker compose up` ausgeliefert wurde muss dem `nginx` Container in der `docker-compose.yml` ein zusätzlicher Ordner gemounted werden:
+
+```
+volumes:
+  - ./src/plainui/static:/www/static
+  ...
+```
+
 #### CSS Watch im Container
 
 1. Um die Styles zu kompilieren und eine watch zu starten benutze `docker compose --profile build up -d local-static`
@@ -247,6 +257,8 @@ Manuell kann es folgendermaßen ausgeführt werden:
 
 ## Häufige Fehler
 
+**Datenbank-Migration schlägt fehl mit "'DatabaseOperations' object has no attribute 'geo_db_type'"**
+
 ```
 $ ./manage.py migrate
 <snip>
@@ -255,6 +267,16 @@ AttributeError: 'DatabaseOperations' object has no attribute 'geo_db_type'
 
 Dieser Fehler tritt auf, wenn man [PostGIS](https://postgis.net/)-Felder mit dem normalen Django-Postgres-Backend anlegen möchte. Statt dessen als Engine `django.contrib.gis.db.backends.postgis` verwenden.
 
+**Docker-Build schlägt fehl mit "error creating zfs mount"**
+
+Hierbei handelt es sich um ein Problem von Docker multi-stage Builds und dem ZFS-Storage Treiber. 
+
+Da das Problem nur auftritt wenn einzelne Image-Layer nicht im Cache sind lässt sich das Problem umgehen indem man den Build solange ausführt bis er erfolgreich ist.
+
+Ab Version 22 von `docker-ce` sollte das Problem nicht mehr auftreten.
+
+Siehe auch den [zughörigen Issue auf GitHub](https://github.com/moby/buildkit/issues/1758).
+
 ## Docker Image Abhängigkeiten
 
 Das Bild zeigt die aktuellen Docker Image Abhängigkeiten aus dem Multistage Dockerfile