diff --git a/Development.md b/Development.md index a5a0593428dcc0e556d58a457c5740923ae57f8f..9826c302ca9e0e4087848f98369359752fc44af0 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