Skip to content

Cevi Entwicklungsinstanz starten

Patrick Uhlmann edited this page Feb 15, 2025 · 5 revisions

Untenstehende Prozedur wurde am 15.02.2025 mit ArchLinux erfolgreich ausgeführt und ist für das Cevi.DB Release vom 15.01.2025 (V2.4.5) ausgelegt.

image

Vorbereiten

Prüfen ob die Datei /etc/timezone existiert. Falls nicht kann diese so angelegt werden: echo 'Europe/Zurich' | sudo tee /etc/timezone > /dev/null

Nachfolgende Schritte laden den Hauptcode von Hitobito, die Erweiterungen der Jugendverbände und die Erweiterungen der Cevi herunter und bereitet die notwendigen Docker Volumes vor. Im aktuellen Ordner wird ein neues Verzeichnis development erstellt.

git clone https://github.com/hitobito/development.git
cd development
git reset --hard dfe2fcc
(cd app && git clone --branch 2.4.5 https://github.com/hitobito/hitobito.git)
(cd app && git clone --branch 2.4.5 https://github.com/hitobito/hitobito_youth.git)
(cd app && git clone --branch 2.4.5 https://github.com/hitobito/hitobito_cevi.git)
docker volume remove hitobito_bundle
docker volume remove hitobito_yarn_cache
docker volume create hitobito_bundle
docker volume create hitobito_yarn_cache

Erster Start

docker compose pull   # lädt alle Container herunter

Es gab bei mir Fehler wegen einem fehlenden Gemfile.lock. Ich musste in der Datei development/docker-compose.yml sowohl beim webpack wie auch beim rails container die Zeile `- ./docker/rails/Gemfile.lock:/usr/src/app/hitobito/Gemfile.lock` unter volumes entfernen.

docker compose up -d  # startet die Container im Hintergrund
docker-compose logs --follow rails # verfolgt den Startprozess

Der Start dauert mehrere Minuten. Es werden unter anderem Ruby Gems installiert, DB Migrationen ausgeführt. Der Start ist fertig wenn Listening on http://0.0.0.0:3000steht.

Zugriff auf die Applikation

Hinweis: Es werden keine Mails "versendet". Diese landen alle in der Mailtrap.

Umgebung herunterfahren

docker compose stop

Umgebung wieder hochfahren

docker compose up -d
docker-compose logs --follow rails

Wiederholte Starts sollten nur noch wenige Sekunden dauern.

Quelle: Hitobito Development