Configura la Localización continua en GitHub, GitLab o Bitbucket. Hay dos opciones compatibles: la GitHub App de Lingo.dev gestionada o ejecutar @lingo.dev/cli en tu propio pipeline. Elige la que mejor encaje con tu plataforma y el nivel de control que buscas.
¿Qué opción me conviene más?#
| Opción | Ideal para | Qué necesitas |
|---|---|---|
| GitHub App | Repositorios alojados en GitHub | Instala la aplicación y haz commit de .lingo/config.json con un engineId. Sin runner, secretos ni CLI. |
@lingo.dev/cli en un runner | GitLab, Bitbucket o GitHub Actions si quieres control total | Node 22+, @lingo.dev/cli, un secreto LINGO_API_KEY y un job que ejecute lingo push. |
¿Usas GitHub? Empieza por la GitHub App
La GitHub App se ejecuta del lado del servidor. Lee un .lingo/config.json incluido en el commit (también tu engineId), reacciona a los pushes y las pull requests, y no necesita runner, secreto de API key ni archivo lock. Sigue la guía de la GitHub App y listo: el resto de esta página explica cómo ejecutar la CLI en tu propio pipeline.
Ejecutar la CLI en tu pipeline#
Si usas GitLab o Bitbucket, o prefieres gestionar la localización tú mismo en GitHub, ejecuta @lingo.dev/cli como un job dentro de tu pipeline. La configuración es la misma en todas las plataformas y se resume en tres pasos: configurar la CLI, añadir tu API key y elegir un flujo de trabajo.
Requisitos previos
Necesitas tener una configuración funcional de la CLI con un archivo .lingo/config.json y poder ejecutar lingo push en local antes de añadirlo a CI.
Paso 1. Configura la CLI#
Si todavía no lo has hecho, sigue la guía rápida de la CLI. Deberías acabar con lo siguiente:
- Un archivo
.lingo/config.jsonen la raíz de tu proyecto (consulta Configuración) - Un
LINGO_API_KEYpara el Motor de localización de Lingo.dev - La capacidad de generar traducciones en local con
lingo push
La CLI funciona con Node 22 o superior. Instálala en tu pipeline con:
npm install -g @lingo.dev/cliPaso 2. Añade tu clave de API como secreto de CI#
lingo push se autentica mediante la variable de entorno LINGO_API_KEY. Guárdala en el gestor de secretos de tu plataforma de CI:
- Ve a Settings > Secrets and variables > Actions
- Haz clic en New repository secret
- Nombre:
LINGO_API_KEY, valor: tu clave de API - Haz clic en Add secret
Paso 3. Elige un flujo de trabajo y añade la configuración#
Tu job ejecuta lingo push para generar traducciones y después hace commit del resultado o abre una pull request con las herramientas de tu propia plataforma. Elige el flujo de trabajo que mejor se adapte a tu equipo:
| Flujo de trabajo | Ideal para |
|---|---|
| Commit a main | Equipos pequeños que quieren actualizaciones de traducción automáticas, invisibles y sin fricción |
| PR desde main | Equipos que quieren revisar las traducciones antes de que lleguen a main |
| Commit a la rama de funcionalidad | Equipos con ramas de funcionalidad de larga duración |
| PR desde la rama de funcionalidad | Equipos que quieren el máximo control sobre cada cambio de traducción |
¿No sabes cuál elegir? Empieza con "Commit a main": es la opción más sencilla. Más adelante puedes cambiar sin tocar tu .lingo/config.json.
Si buscas instrucciones de configuración específicas para cada plataforma y ejemplos de flujos de trabajo, consulta:
Verifica la configuración#
Después de configurar tu job de CI, haz push de un cambio para activarlo. El pipeline debería:
- Ejecutar
lingo pushpara traducir el contenido nuevo y el contenido modificado - Hacer commit de las traducciones o abrir una PR, según tu flujo de trabajo
- Actualizar el archivo
.lingo/lock.json, que lleva el registro de lo que ya se ha traducido
Para comprobar en CI que las traducciones están completas sin generar otras nuevas, ejecuta lingo check:
lingo checkEsto devuelve un estado distinto de cero si hay contenido sin traducir; resulta útil como control previo al despliegue. Consulta Patrones avanzados para ver ejemplos.
