Configura Localización continua en GitHub, GitLab o Bitbucket. Hay dos opciones compatibles: la GitHub App de Lingo.dev, administrada, o ejecutar @lingo.dev/cli en tu propio pipeline. Elige la que mejor se adapte a tu plataforma y al nivel de control que buscas.
¿Qué opción me conviene usar?#
| Opción | Ideal para | Qué necesitas |
|---|---|---|
| GitHub App | Repositorios alojados en GitHub | Instala la app y haz commit de .lingo/config.json con un engineId. No necesitas runner, secreto 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 con la GitHub App
La GitHub App se ejecuta del lado del servidor. Lee un .lingo/config.json con commit en el repositorio (incluido tu engineId), responde a pushes y pull requests, y no requiere runner, secreto de API key ni lock file. Sigue la guía de la GitHub App y listo: el resto de esta página explica cómo ejecutar el CLI en tu propio pipeline.
Cómo ejecutar el 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 cualquier plataforma: configurar el CLI, agregar tu API key y elegir un flujo de trabajo.
Requisitos previos
Necesitas tener el CLI configurado y funcionando, con un archivo .lingo/config.json y la posibilidad de ejecutar lingo push localmente antes de agregarlo a CI.
Paso 1. Configura la CLI#
Si aún no lo hiciste, sigue la guía de inicio rápido del CLI. Al final deberías tener:
- Un archivo
.lingo/config.jsonen la raíz de tu proyecto (consulta Configuración) - Un
LINGO_API_KEYpara el motor de Lingo.dev - La capacidad de generar traducciones localmente con
lingo push
El CLI funciona con Node 22+. Instálalo en tu pipeline con:
npm install -g @lingo.dev/cliPaso 2. Agrega tu clave de API como secreto de CI#
lingo push se autentica con la variable de entorno LINGO_API_KEY. Guárdala en el administrador 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 agrega la configuración#
Tu job ejecuta lingo push para generar traducciones y luego hace commit del resultado o abre un 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 buscan actualizaciones de traducción invisibles y sin fricción |
| PR desde main | Equipos que quieren revisar las traducciones antes de que lleguen a main |
| Commit a rama de funcionalidades | Equipos con ramas de funcionalidades de larga duración |
| PR desde rama de funcionalidades | 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 simple. Más adelante puedes cambiarla sin modificar tu .lingo/config.json.
Para ver instrucciones de configuración específicas por 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 contenido nuevo y contenido modificado - Hacer commit de las traducciones o abrir un PR (según tu flujo de trabajo)
- Actualizar el archivo
.lingo/lock.json, que lleva el registro de lo que ya se tradujo
Para verificar en CI que las traducciones estén completas sin generar nuevas, ejecuta lingo check:
lingo checkEsto devuelve un estado distinto de cero si hay contenido sin traducir; es útil como control antes del despliegue. Consulta Patrones avanzados para ver ejemplos.
