Einrichtung
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 --wait 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 push --waitausfü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.