Markdown

GitLab: Zugangsdaten

Unter Anbindungen, Kategorie Git, verbindest du GitLab.com oder eine selbst gehostete Instanz per OAuth oder Personal Access Token, damit MainPath Gruppen und Projekte dort anlegen oder importieren kann.

Auf dieser Seite

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)

  1. Öffne Anbindungen → GitLab → Mit GitLab verbinden.
  2. Melde dich an und erteile api-Rechte, damit MainPath Projekte, Dateien und CI-Variablen verwalten kann.
  3. 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

  1. Erzeuge in GitLab unter Preferences → Access Tokens (oder Group → Access Tokens) einen Token mit api.
  2. Öffne Anbindungen → GitLab → API-Token hinzufügen.
  3. Trage Name, Slug, Token, GitLab-URL (https://gitlab.com oder 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.

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