Richten Sie die kontinuierliche Lokalisierung für die GitHub Action, GitLab CI/CD, Bitbucket Pipelines oder die eigenständige CLI ein. Alle führen die Lingo.dev CLI in Ihrer Pipeline aus – deshalb ist das Setup immer gleich und umfasst drei Schritte: CLI konfigurieren, API-Schlüssel hinterlegen und einen Workflow auswählen.
Möchten Sie stattdessen die GitHub App einrichten?
Die GitHub App nutzt diesen Ablauf nicht – es gibt keine lokale CLI, i18n.json und auch kein API-Key-Secret. Sie installieren die App einmal und fügen dem Repository eine .lingo/config.json hinzu. Folgen Sie stattdessen der Anleitung zur GitHub App.
Voraussetzungen
Bevor Sie CI/CD hinzufügen, benötigen Sie ein funktionierendes CLI-Setup mit einer i18n.json-Datei und müssen npx lingo.dev@latest run lokal ausführen können.
Schritt 1. CLI konfigurieren#
Falls noch nicht geschehen, folgen Sie der Anleitung CLI Setup. Am Ende sollten Sie Folgendes haben:
- Eine
i18n.json-Datei im Stammverzeichnis Ihres Projekts - Einen API-Schlüssel (entweder
LINGO_API_KEYfür die Lingo.dev Engine oder einen Provider-Schlüssel wieOPENAI_API_KEY) - Die Möglichkeit, Übersetzungen lokal mit
npx lingo.dev@latest runzu erstellen
Schritt 2. API-Schlüssel als CI-Secret hinterlegen#
Speichern Sie Ihren API-Schlüssel in der Secret-Verwaltung Ihrer CI-Plattform:
- Gehen Sie zu Settings > Secrets and variables > Actions
- Klicken Sie auf New repository secret
- Name:
LINGODOTDEV_API_KEY, Wert: Ihr API-Schlüssel - Klicken Sie auf Add secret
Schritt 3. Workflow wählen und Konfiguration hinzufügen#
Wählen Sie den Workflow, der zu Ihrem Team passt, und folgen Sie dann der plattformspezifischen Anleitung:
| 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 i18n.json zu ändern.
Plattformspezifische Einrichtungsanleitungen und Workflow-Beispiele finden Sie hier:
Setup überprüfen#
Nachdem Sie Ihren CI-Workflow konfiguriert haben, pushen Sie eine Änderung, um ihn auszulösen. Die Integration sollte dann:
- Die Übersetzungspipeline ausführen
- Übersetzungen committen oder eine PR öffnen (je nach Workflow)
- Die Datei
i18n.lockaktualisieren
Um in CI zu prüfen, ob die Übersetzungen vollständig sind, ohne neue zu erzeugen, verwenden Sie das Flag --frozen:
npx lingo.dev@latest run --frozenDer Prozess endet mit einem Nicht-Null-Status, wenn Inhalte unübersetzt sind – nützlich als Deployment-Gate. Beispiele finden Sie unter Advanced Patterns.
