Richte Kontinuierliche Lokalisierung für GitHub, GitLab oder Bitbucket ein. Dafür gibt es zwei unterstützte Wege: die verwaltete Lingo.dev GitHub App oder @lingo.dev/cli in deiner eigenen Pipeline. Wähle die Option, die zu deiner Plattform und deinem gewünschten Maß an Kontrolle passt.
Welcher Weg ist der richtige?#
| Weg | Am besten geeignet für | Voraussetzungen |
|---|---|---|
| GitHub App | Auf GitHub gehostete Repositories | Installiere die App und committe .lingo/config.json mit einer engineId. Kein Runner, Secret oder CLI nötig. |
@lingo.dev/cli in einem Runner | GitLab, Bitbucket oder GitHub Actions, wenn du volle Kontrolle willst | Node 22+, @lingo.dev/cli, ein LINGO_API_KEY-Secret und ein Job, der lingo push ausführt. |
Auf GitHub? Starte mit der GitHub App
Die GitHub App läuft serverseitig. Sie liest eine committete .lingo/config.json (einschließlich deiner engineId), reagiert auf Pushes und Pull Requests und benötigt weder Runner noch API-Key-Secret oder Lock-Datei. Folge einfach der Anleitung für die GitHub App – der Rest dieser Seite zeigt, wie du die CLI in deiner eigenen Pipeline ausführst.
Die CLI in deiner Pipeline ausführen#
Wenn du GitLab oder Bitbucket nutzt oder die Lokalisierung auf GitHub selbst steuern möchtest, führe @lingo.dev/cli als Job in deiner Pipeline aus. Das Setup besteht auf jeder Plattform aus denselben drei Schritten: CLI konfigurieren, API-Key hinzufügen und einen Workflow auswählen.
Voraussetzungen
Bevor du CI einrichtest, brauchst du ein funktionierendes CLI setup mit einer .lingo/config.json-Datei und musst lingo push lokal ausführen können.
Schritt 1. CLI konfigurieren#
Falls noch nicht geschehen, folge dem CLI Quickstart. Danach solltest du Folgendes haben:
- Eine
.lingo/config.json-Datei im Projektstamm (siehe Konfiguration) - Ein
LINGO_API_KEYfür die Lingo.dev Engine - Die Möglichkeit, Übersetzungen lokal mit
lingo pushzu erstellen
Die CLI läuft mit Node 22+. Installiere sie in deiner Pipeline mit:
npm install -g @lingo.dev/cliSchritt 2. API-Schlüssel als CI-Secret hinterlegen#
lingo push authentifiziert sich über die Umgebungsvariable LINGO_API_KEY. Speichere sie in der Secret-Verwaltung deiner CI-Plattform:
- Gehen Sie zu Settings > Secrets and variables > Actions
- Klicken Sie auf New repository secret
- Name:
LINGO_API_KEY, Wert: Ihr API-Schlüssel - Klicken Sie auf Add secret
Schritt 3. Workflow wählen und Konfiguration hinzufügen#
Dein Job führt lingo push aus, um Übersetzungen zu erstellen, und committet anschließend das Ergebnis oder öffnet mit den nativen Tools deiner Plattform einen Pull Request. Wähle den Workflow, der zu deinem Team passt:
| Workflow | Am besten geeignet für |
|---|---|
| Commit auf main | Kleine Teams, die reibungslose, unauffällige Übersetzungsupdates möchten |
| PR von main | Teams, die Übersetzungen prüfen möchten, bevor sie auf main landen |
| Commit auf Feature-Branch | Teams mit langlebigen Feature-Branches |
| PR von Feature-Branch | Teams, die maximale Kontrolle über jede einzelne Übersetzungsänderung möchten |
Sie sind unsicher, was Sie wählen sollen? Starten Sie mit „Commit auf main“ – das ist die einfachste Option. Sie können später wechseln, ohne Ihre .lingo/config.json zu ändern.
Plattformspezifische Einrichtungsanleitungen und Workflow-Beispiele finden Sie hier:
Setup überprüfen#
Sobald dein CI-Job konfiguriert ist, pushe eine Änderung, um ihn auszulösen. Die Pipeline sollte:
lingo pushausführen, um neue und geänderte Inhalte zu übersetzen- Übersetzungen committen oder eine PR öffnen (je nach Workflow)
- Die
.lingo/lock.json-Datei aktualisieren, die erfasst, was bereits übersetzt wurde
Wenn du in CI prüfen möchtest, ob die Übersetzungen vollständig sind, ohne neue zu erzeugen, führe lingo check aus:
lingo checkDer Prozess endet mit einem Nicht-Null-Status, wenn Inhalte unübersetzt sind – nützlich als Deployment-Gate. Beispiele finden Sie unter Advanced Patterns.
