Bakehouse Development

    Getting Started

    Code im Git

    Der Code wird im Repository cookis/bakehouse zur Verfügung gestellt.

    Unser interner Gitea-Service

    Updaten

    Um im Team arbeiten zu können, sollte man immer auf dem aktuellsten Stand sein, sprich den Code, den andere in das Repository commited haben, auschecken: git pull

    composer install oder composer update:

    Bei update werden neuste Versionen der Packages geladen und das composer.lock neu geschrieben. Somit werden dann im Deployprozess oder bei anderen Entwicklern. die composer install ausführen, auch diese Versionen geladen.

    Projekt importieren

    Folgenden Befehl in einem lokalen Terminal (direkt am Mac) ausführen:

    Apache Config
    ssh -A dev_werner@werner.bakehouse.dev 'cd web && bash import.sh'

    Damit das Import-Script auch auf Projekte von anderen Servern zugreifen kann, muss die SSH-Session mit dem Argument -A gestartet werden. Damit wird die Authentifzierungssitzung geforwarded. Der lokale SSH-Key wird somit für den Zugriff auf andere Server verwendet.

    Außerdem muss in der .ssh/config Datei Folgendes gesetzt sein, damit die Keys bei einer SSH-Verbindung richtig übergeben werden:

    Text
    Host * UseKeychain yes AddKeysToAgent yes IdentityFile ~/.ssh/id_rsa

    Backend (bearbeiten)

    Vue Interface

    Folgender Befehl muss zumindest einmal nach der Aufsetzung ausgeführt werden, damit das Interface funktioniert:
    composer build-interface

    Anschließend muss das Interface über Vue-CLI gestartet und über folgenden Befehl ausgeliefert werden - Änderungen am Vue werden automatisch und live sichtbar:
    composer serve-interface

    jQuery Interface

    TYPO3 + PHP

    Frontend (Website)

    Folgender Befehl muss zumindest einmal nach der Aufsetzung ausgeführt werden, damit das Interface funktioniert:
    composer build-cookiepopup

    Anschließend muss das Interface über Vue-CLI gestartet und über folgenden Befehl ausgeliefert werden - Änderungen am Vue werden automatisch und live sichtbar:
    composer serve-cookiepopup

    Bakehouse Javascript

    jQuery Plugins

    Update Workflow

    Nachdem die Änderungen umgesetzt und getestet sind, müssen diese in das zentrale Git übergeben und der Deploy Prozess angestoßen werden.

    TYPO3 Core - Patches

    Patches liegen im Verzeichnis src/patches/ und werden im Dev Projekt cookis/bakehouse ind der composer.json definiert.

    Diese Patches werden mit einem Composer Plugin cweagans/composer-patches bei jedem composer update eingespielt.

    Währen dem Deploy Process werden die Patches auf die selbe Weise eingespielt, jedoch muss dort anschließend ein sogenannter Fork aus dem gepatcheden Package erstellt werden.

    Fork im Deploy Prozess einstellen