GitHub liegt unter Anbindungen in der Kategorie Git. Empfohlen ist Mit GitHub verbinden (OAuth). Steht OAuth nicht zur Verfügung, hinterlegst du einen Personal Access Token.
Beim Anlegen oder Bearbeiten eines Projekts wählst du ganz unten unter Repositories das Git-Hosting: Automatisch generiert (empfohlen) legt die Repositories in der GitLab-Instanz von MainPath an. GitHub nutzt das hier verbundene Konto.
OAuth
- Öffne Anbindungen → GitHub → Mit GitHub verbinden.
- Melde dich bei GitHub an und erteile von MainPath Zugriff auf Repositories, Workflows und Organisationen.
- Nach dem Callback steht der Zugang in der Projektauswahl.
OAuth braucht eine GitHub-OAuth-App von MainPath (GITHUB_OAUTH_CLIENT_ID / GITHUB_OAUTH_CLIENT_SECRET im Backend). Fehlt sie, bleibt nur der Token-Weg.
Personal Access Token
- Erzeuge in GitHub unter Settings → Developer settings → Personal access tokens einen Token (classic oder fine-grained) mit Rechten für Repositories, Workflows und Packages.
- Öffne Anbindungen → GitHub → API-Token hinzufügen.
- Trage Name, Slug, den Token und optional die GitHub-URL ein (Standard
https://github.com; GitHub Enterprise abweichend).
MainPath prüft den Token gegen die GitHub-API. Bei GitHub Enterprise bleibt die Basis-URL die deiner Instanz.
Im Projekt nutzen
- Beim Projekt ganz unten GitHub wählen und diesen Zugang plus Organisation oder Benutzer-Namespace angeben.
- Pro Komponente kannst du ein bestehendes Repository importieren oder eines anlegen lassen.
- MainPath schreibt
.github/workflows/ci.yml, das die öffentlichen Workflows ausdoppelt-digital/app-project-github-actionseinbindet. GitHub-hosted Runner (ubuntu-24.04,macos-15) installieren Toolchain-Versionen per ASDF.
GitOps liegt ebenfalls in demselben GitHub-Namespace (gitops).