Was neben dem Quellcode zum Projekt gehört
Eine Entwicklungsumgebung ist die Zusammenstellung, in der du Code bearbeitest, ausführst und prüfst. Dazu gehören ein Editor, die Laufzeit der verwendeten Sprache, installierte Abhängigkeiten und die Dienste, mit denen deine Anwendung spricht. Bei einem Backend kann das zum Beispiel eine lokale Datenbank sein.
Der Quellcode allein beschreibt diese Zusammenstellung nicht vollständig. Welche Version der Laufzeit erwartet das Projekt? Wie wird die Datenbank gestartet? Wo findet die Anwendung ihre Adresse? Diese Angaben sollten im Projekt nachvollziehbar sein, damit die nächste Person die Umgebung einrichten kann.
Warum eine Anwendung nur auf einem Rechner startet
Ein anderer Datenbankport kann schon reichen, damit eine Verbindung fehlschlägt. Ebenso können unterschiedliche Laufzeitversionen oder eine fehlende Umgebungsvariable das Verhalten verändern. Dann muss zuerst die Umgebung verglichen werden, bevor jemand den Anwendungscode ändert.
Entwicklung und Produktion brauchen dabei nicht überall dieselben Werte. Lokal zeigt die Datenbankadresse auf den Dienst für die Entwicklung, auf dem Server auf die dortige Datenbank. Entscheidend ist, dass jede Umgebung die passenden Werte erhält und klar ist, wo diese gepflegt werden.
Versionen und Startbefehle in MainPath
In MainPath stehen die Laufzeitversionen eines Repositories in .tool-versions. mp bootstrap installiert sie, ohne die Anwendung zu starten; mp doctor zeigt fehlende Werkzeuge an. Mit mp run-local startest du die Anwendung im jeweiligen Repository. Bei einem Backend gehören dazu auch die lokalen Dienste in Docker. Den Ablauf beschreibt Lokal entwickeln.
Generierte Einstellungen liegen in env/*.generated.env. Eigene Werte ergänzt du in den passenden Dateien unter env/*.custom.env und startest die Anwendung anschließend neu. Welche Datei zu welcher Umgebung gehört, erklärt Mit Umgebungsvariablen arbeiten.
Auf dem eigenen Rechner oder im Workspace arbeiten
Eine Entwicklungsumgebung kann auf deinem Rechner oder in einem bereitgestellten Workspace liegen. MainPath Workspaces basieren auf Docker Images. Auch dort bleiben der Projektstand, die benötigten Dienste und die passende Konfiguration Teil der Entwicklungsarbeit.
Ein erfolgreicher lokaler Start ist die erste Prüfung. Ob die Änderung mit den Prüfungen und dem Build des Projekts zusammenpasst, zeigt anschließend die Pipeline.