Markdown

Für Entwickler

Überblick in fünf Minuten

Organisationen, Projekte und die generierten Repositories, der Weg vom Push bis zur Produktion und die zwei Arbeitswege bilden den Rahmen, in dem du als Entwickler mit MainPath arbeitest.

Auf dieser Seite

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, Docker Hub 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.mainpath.ai 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; GitHub braucht Docker Hub, externes GitLab die Registry derselben Instanz.

  • local-configuration enthä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-configuration beschreibt pro Umgebung (Dev und Prod), welche Version mit welcher Konfiguration läuft; die Pipelines schreiben die Versionen hinein, eigene Werte gehören in custom.yaml.

Vom Push zur Produktion

Ablauf im Überblick
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.mainpath.ai 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.

Danke für deine Anfrage

Wir haben deine Anfrage erhalten und melden uns schnellstmöglich bei dir.

Du möchtest direkt mit uns sprechen?

Buche hier einen passenden Termin für ein Erstgespräch mit Robin.

Kalender in einem neuen Tab öffnen