Anleitungen im Zusammenhang mit Beach

Wie man Neos und Flow von einem benutzerdefinierten Stammordner ausführt

Manchmal befindet sich dein Neos Projekt in einem Unterordner deines Git-Repositorys - kein Problem für das Hosting in Beach

Übersicht

Gehen wir von einem Projekt aus, bei dem das Neos Setup nur ein Teil eines größeren Setups ist. Alle Bausteine befinden sich im selben Git-Repository, und der Neos Teil liegt in einem Unterordner dieses Repositorys.

Wenn du versuchst, dieses Setup zu hosten, indem du das Git-Repository einfach an Flownative Beach weitergibst, wird der Build (höchstwahrscheinlich) sehr früh fehlschlagen, da das Composer-Manifest nicht gefunden werden kann.

Die Lösung ist allerdings recht einfach...

Konfiguration

Im folgenden Beispiel befindet sich der Neos Teil des Systems im Ordner packages/acme innerhalb des Git-Repositorys.

Zuerst musst du dem Build-Prozess mitteilen, wo sich das Composer-Stammmanifest in deinem Repository befindet. Dazu legst du im Stammverzeichnis deines Git-Repositorys eine Datei namens .beach.yaml ab. Der Inhalt gibt den Pfad zum Composer Root Manifest an:

builder:
  composerManifestPath: packages/acme

Mit diesen Informationen kann der Build-Prozess tun, was er tun muss. Um das Ergebnis nach einer Bereitstellung tatsächlich ausliefern zu können, musst du zusätzlich die Instanz-Umgebungsvariable BEACH_APPLICATION_PATH mit dem Wert /application/packages/acme setzen. Dies muss unter Beach in den Instanzdetails geschehen. Sobald diese Variable gesetzt ist, sollte dein Projekt nach dem nächsten Deloyment einsatzbereit sein.

Falls noch Fragen offen sind, kontaktiere uns für Unterstützung.