Sascha Böhm - Frappe Framework DEV-CONTAINER lokal installieren unter Docker

Um Frappe Framework lokal zu testen oder APPS zu  entwickeln kann man das Framework lokal

unter Windows, Mac oder Linux installieren.

Vorraussetzungen:

1. GIT  
2. Docker oder Docker-Desktop > link
3. Docker-Compose ( bei der Installation von Docker-Desktop folgenden Befehl in der Console aufrufen
4. VS-CODE -> link

docker-compose -v
--> Ausgabe: Docker Compose version v2.32.4-desktop

So starten wir:

git clone https://github.com/frappe/frappe_docker.git
cd frappe_docker

Erstellen des devcontainer aus der Vorlage:

cp -R devcontainer-example .devcontainer

VS-Code Vorlage kopieren:

cp -R development/vscode-example development/.vscode

VS-Code. Remote-Container extension installieren:

code --install-extension ms-vscode-remote.remote-containers

Wenn alles soweit ohne Fehler funktioniert hat, starten wir VSC im Verzeichnis mit folgenden Befehl:

code .

VSC startet, dann sollte eine Meldung kommen das ein Container gefunden wurde und ob man diesen Öffnen möchte, hier einfach auf ja klicken.

Es werden alle benötigten Container installiert, hier warten bis alles erlegt ist.

Im VSC-Terminal solltest DU dann im folgenden Verzeichnis sein

 /workspace/development 

Jetzt installieren wir frappe-bench

bench init --skip-redis-config-generation --frappe-branch version-15-hotfix frappe-bench

wenn man die Zeile  --frappe-branch version-15-hotfix weg lässt wird die letzte Version installiert oder man möchte die Version 14 dann  --frappe-branch version-14

wechseln in das Verzeichnis:

cd frappe-bench

Konfiguration setzen:

bench set-config -g db_host mariadb
bench set-config -g redis_cache redis://redis-cache:6379
bench set-config -g redis_queue redis://redis-queue:6379
bench set-config -g redis_socketio redis://redis-queue:6379

code Procfile
sed -i '/redis/d' ./Procfile

Wir erstellen eine Demo bzw. Testseite hier wäre die Seite development.localhost - Wichtig: man kann auch dev.localhost nutzen, es sollte bei lokaler Installation immer .localhost verwendet werden

bench new-site --db-root-password 123 --admin-password admin --mariadb-user-host-login-scope=% development.localhost

Wir setzen die Seite in dev-mode

bench --site development.localhost set-config developer_mode 1
bench --site development.localhost clear-cache

jetzt können wir die Seite starten mit folgenden Befehl:

bench start 

Öffnen einen Browser und gehen auf folgenden Seite: http://development.localhost:8000

hier loggen wir uns mit administrator und passwort admin ein und schließen das Setup ab.