Mettez en place la localisation continue sur GitHub, GitLab ou Bitbucket. Deux options sont prises en charge : la GitHub App Lingo.dev gérée, ou l’exécution de @lingo.dev/cli dans votre propre pipeline. Choisissez celle qui correspond à votre plateforme et au niveau de contrôle que vous recherchez.
Quelle option choisir ?#
| Option | Idéal pour | Prérequis |
|---|---|---|
| GitHub App | Dépôts hébergés sur GitHub | Installez l’app, validez .lingo/config.json avec un engineId. Aucun runner, secret ni CLI. |
@lingo.dev/cli dans un runner | GitLab, Bitbucket ou GitHub Actions si vous voulez un contrôle total | Node 22+, @lingo.dev/cli, un secret LINGO_API_KEY et un job qui exécute lingo push. |
Sur GitHub ? Commencez par la GitHub App
La GitHub App s’exécute côté serveur. Elle lit un fichier .lingo/config.json versionné (y compris votre engineId), réagit aux pushs et aux pull requests, et ne nécessite ni runner, ni secret de clé API, ni fichier de verrouillage. Suivez le guide de la GitHub App et le tour est joué — le reste de cette page couvre l’exécution du CLI dans votre propre pipeline.
Exécuter le CLI dans votre pipeline#
Si vous êtes sur GitLab ou Bitbucket, ou si vous préférez piloter vous-même la localisation sur GitHub, exécutez @lingo.dev/cli comme job dans votre pipeline. La configuration suit les mêmes trois étapes sur toutes les plateformes : configurer le CLI, ajouter votre clé API et choisir un workflow.
Prérequis
Avant de l’ajouter à la CI, vous devez disposer d’une configuration CLI fonctionnelle, avec un fichier .lingo/config.json, et pouvoir exécuter lingo push en local.
Étape 1. Configurer la CLI#
Si ce n’est pas encore fait, suivez le CLI Quickstart. Vous devriez obtenir :
- Un fichier
.lingo/config.jsonà la racine de votre projet (voir Configuration) - Un
LINGO_API_KEYpour le moteur Lingo.dev - La possibilité de générer des traductions localement avec
lingo push
Le CLI fonctionne avec Node 22+. Installez-le dans votre pipeline avec :
npm install -g @lingo.dev/cliÉtape 2. Ajouter votre clé API comme secret CI#
Le lingo push s’authentifie via la variable d’environnement LINGO_API_KEY. Stockez-la dans le gestionnaire de secrets de votre plateforme CI :
- Accédez à Settings > Secrets and variables > Actions
- Cliquez sur New repository secret
- Nom :
LINGO_API_KEY, valeur : votre clé API - Cliquez sur Add secret
Étape 3. Choisir un workflow et ajouter la configuration#
Votre job exécute lingo push pour générer les traductions, puis commit le résultat ou ouvre une pull request à l’aide des outils natifs de votre plateforme. Choisissez le workflow qui convient à votre équipe :
| Workflow | Idéal pour |
|---|---|
| Commit sur main | Les petites équipes qui veulent des mises à jour de traduction fluides et invisibles |
| PR depuis main | Les équipes qui veulent relire les traductions avant qu'elles n'arrivent sur main |
| Commit sur une branche de fonctionnalité | Les équipes qui travaillent avec des branches de fonctionnalité de longue durée |
| PR depuis une branche de fonctionnalité | Les équipes qui veulent un contrôle maximal sur chaque modification de traduction |
Vous hésitez ? Commencez par "Commit sur main" : c'est l'option la plus simple. Vous pourrez en changer plus tard sans modifier votre .lingo/config.json.
Pour les instructions de configuration propres à chaque plateforme et des exemples de workflow, consultez :
Vérifier la configuration#
Une fois votre job CI configuré, poussez une modification pour le déclencher. Le pipeline doit :
- Exécuter
lingo pushpour traduire le contenu nouveau ou modifié - Valider les traductions ou ouvrir une PR (selon votre workflow)
- Mettre à jour le fichier
.lingo/lock.json, qui garde la trace de ce qui a déjà été traduit
Pour vérifier dans la CI que les traductions sont complètes sans en générer de nouvelles, exécutez lingo check :
lingo checkLa commande renvoie alors un code de sortie non nul si du contenu n'est pas traduit — pratique comme garde-fou avant le déploiement. Consultez Modèles avancés pour voir des exemples.
