GitLab liegt unter Anbindungen in der Kategorie Git. Empfohlen ist Mit GitLab verbinden (OAuth gegen GitLab.com). Andernfalls hinterlegst du einen Personal Access Token; das funktioniert auch für Self-hosted.
Beim Projekt wählst du ganz unten GitLab statt Automatisch generiert, wenn die Anwendungscode-Repositories bei GitLab.com (oder deiner Instanz) liegen sollen. Dasselbe gilt für das GitOps-Repo: es wird in derselben Gruppe angelegt. Tenant-IaC von MainPath bleibt in der MainPath-GitLab-Gruppe.
OAuth (GitLab.com)
- Öffne Anbindungen → GitLab → Mit GitLab verbinden.
- Melde dich an und erteile
api-Rechte, damit MainPath Projekte, Dateien und CI-Variablen verwalten kann. - Nach dem Callback steht der Zugang zur Auswahl.
OAuth braucht GITLAB_OAUTH_CLIENT_ID / GITLAB_OAUTH_CLIENT_SECRET im Backend. Fehlt die App, nutze einen Token.
Personal Access Token
- Erzeuge in GitLab unter Preferences → Access Tokens (oder Group → Access Tokens) einen Token mit
api. - Öffne Anbindungen → GitLab → API-Token hinzufügen.
- Trage Name, Slug, Token, GitLab-URL (
https://gitlab.comoder deine Instanz) und optional den Gruppenpfad ein.
Pipelines auf GitLab.com
MainPath schreibt .gitlab-ci.yml, das die öffentliche Pipeline-Lib doppelt-digital/app-project-pipelines einbindet, plus templates-common/hosted-runner.yml. Jobs laufen auf GitLab-hosted Linux- und macOS-Runnern (saas-linux-small-amd64, saas-macos-medium-m1) mit ASDF statt Tart.
Container-Images landen in der Container Registry derselben GitLab-Instanz (registry.gitlab.com/<gruppe>/<repo> auf GitLab.com, sonst <host>:5050/...). GitOps zieht von dort, nicht von der MainPath-Registry. Dafür legt MainPath in der Gruppe ein Deploy-Token mit read_registry an (langlebig); ohne Gruppenrechte fällt GitOps auf den OAuth- oder API-Token zurück (docker login mit Benutzer oauth2). Das GitOps-Repo liegt in derselben GitLab-Gruppe (<gruppe>/gitops). Ansible, SOPS/OpenBao und SSH-Tunnel laufen in der Hosted-CI dieses Repos. App-Pipelines schreiben Image-Tags dorthin (GITOPS_CONFIGURATION_* auf den Anwendungsprojekten, GITOPS_DEPLOY_ENABLED). GITOPS_BOT_* gehört nur auf das GitOps-Projekt, nicht auf die App-Repos — sonst spricht update-version mit dem falschen Token gegen gitlab.com. mp clone holt Anwendungs- und GitOps-Repos von dieser GitLab-Gruppe.