From 612313d725d99a8f3f0cdb591b37fa049313e4fa Mon Sep 17 00:00:00 2001
From: cubicroot <github@cubicroot.xyz>
Date: Sun, 8 Dec 2024 13:05:56 +0100
Subject: [PATCH] Entwickler-Doku: CSS mit docker compose lokal ausliefern &
 docker/ZFS Probleme

---
 Development.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/Development.md b/Development.md
index a5a059342..9826c302c 100644
--- a/Development.md
+++ b/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
-- 
GitLab