Mettez en place la localisation continue pour GitHub Actions, GitLab CI/CD, Bitbucket Pipelines ou la CLI autonome. Tous exécutent la CLI Lingo.dev dans votre pipeline : la configuration suit donc les mêmes trois étapes : configurer la CLI, ajouter votre clé API et choisir un workflow.
Vous préférez configurer la GitHub App ?
La GitHub App ne suit pas ce processus : pas de CLI locale, pas de i18n.json ni de secret de clé API. Il suffit d'installer l'application une fois, puis d'ajouter un .lingo/config.json au dépôt. Suivez plutôt le guide de la GitHub App.
Prérequis
Avant d'ajouter la CI/CD, vous devez disposer d'une configuration CLI opérationnelle, avec un fichier i18n.json, et pouvoir exécuter npx lingo.dev@latest run localement.
Étape 1. Configurer la CLI#
Si ce n'est pas déjà fait, suivez le guide Configuration de la CLI. À la fin, vous devriez avoir :
- Un fichier
i18n.jsonà la racine du projet - Une clé API (soit
LINGO_API_KEYpour le moteur Lingo.dev, soit une clé fournisseur commeOPENAI_API_KEY) - La possibilité de générer des traductions localement avec
npx lingo.dev@latest run
Étape 2. Ajouter votre clé API comme secret CI#
Stockez votre clé API dans le gestionnaire de secrets de votre plateforme CI :
- Accédez à Settings > Secrets and variables > Actions
- Cliquez sur New repository secret
- Nom :
LINGODOTDEV_API_KEY, valeur : votre clé API - Cliquez sur Add secret
Étape 3. Choisir un workflow et ajouter la configuration#
Choisissez le workflow qui correspond à votre équipe, puis suivez le guide adapté à votre plateforme :
| 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 i18n.json.
Pour les instructions de configuration propres à chaque plateforme et des exemples de workflow, consultez :
Vérifier la configuration#
Une fois votre workflow CI configuré, poussez une modification pour le déclencher. L'intégration devrait :
- Exécuter le pipeline de traduction
- Valider les traductions ou ouvrir une PR (selon votre workflow)
- Mettre à jour le fichier
i18n.lock
Pour vérifier dans la CI que les traductions sont complètes sans en générer de nouvelles, utilisez l'option --frozen :
npx lingo.dev@latest run --frozenLa 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.
