MainPath generiert aus einer Projekt-Konfiguration GitLab-Repositories mit Code-Gerüst, Pipelines und Deployment-Konfiguration und betreibt den Weg von git push bis zum laufenden Container; dein Anteil ist der Produktcode.
Organisation, Projekt und Repositories
Eine Organisation bündelt Mitglieder, Abrechnung, Server, Store-Accounts und Anbindungen wie Sentry, Cloudflare, GitHub, GitLab oder SMTP; Administratoren verwalten sie, Developer arbeiten an ihren Projekten. Ein Projekt ist ein Produkt darin und bekommt standardmäßig eine GitLab-Gruppe auf gitlab.application-platform.com mit einem Repository pro Komponente, gitlab-profile für die README und zwei Repositories von MainPath. Unten im Projekt kannst du stattdessen GitHub oder GitLab.com wählen.
local-configurationenthält die Editor-Konfiguration (.vscode,.idea) und liegt per Symlink im Projektordner. Regeln für KI-Agenten kommen aus dem Agent-Plugin (mp agent install).gitops-configurationbeschreibt pro Umgebung (Dev und Prod), welche Version mit welcher Konfiguration läuft; die Pipelines schreiben die Versionen hinein, eigene Werte gehören incustom.yaml.
Vom Push zur Produktion
flowchart LR push["Push oder Merge auf main"] --> pipeline["Pipeline: Test, Version, Build"] pipeline -->|"automatisch"| dev["Dev"] pipeline -->|"manueller Job"| prod["Prod"]
Ein Push oder Merge auf main startet die Pipeline, die die Version aus den Commit-Nachrichten (feat:, fix:) berechnet, das Artefakt baut und den Stand in gitops-configuration einträgt; Dev wird automatisch ausgerollt, Produktion per manuellem Job in GitLab, und Feature-Branches bauen ohne Versions-Commit. Den Ablauf mit Rollback beschreibt Git-Workflow und Deployment.
Wo was liegt
In der Web-Oberfläche unter app.application-platform.com verwaltest du Organisationen, Projekte, Server, Anbindungen, Docker Apps, Domains und Workspaces. In GitLab liegen Code, Pipelines, Job-Logs und Merge Requests, und Sentry sammelt Fehler, sobald unter Anbindungen ein Sentry-Konto verbunden ist. Wie Ansible, Image-Tags und Server zusammenspielen, steht unter Architektur.
Zwei Arbeitswege
Lokal richtet die MainPath Toolbox deinen Rechner ein und klont alle Repositories nach ~/Documents/MainPath/<organisations-slug>/<projekt-slug>/; alternativ arbeitest du in einem Remote-Workspace, einer Ubuntu-VM in der Cloud. In beiden Fällen öffnest du den Projektordner im Editor und startest jede Anwendung mit mp run-local im Repo-Root, siehe Lokal entwickeln und CLI und Agent-Plugin. Danach legst du ein neues Projekt an oder importierst ein bestehendes Repository.