Configura la localización continua para GitHub Action, GitLab CI/CD, Bitbucket Pipelines o la CLI independiente. Todos ejecutan la CLI de Lingo.dev en tu pipeline, así que la configuración sigue los mismos tres pasos: configurar la CLI, añadir tu clave de API y elegir un flujo de trabajo.
¿Quieres configurar la GitHub App en su lugar?
La GitHub App no usa este flujo: no hay CLI local, i18n.json ni secreto de clave de API. Instalas la aplicación una sola vez y añades un .lingo/config.json al repositorio. Sigue en su lugar la guía de GitHub App.
Requisitos previos
Antes de añadir CI/CD, necesitas tener lista una configuración de la CLI funcional, con un archivo i18n.json y la posibilidad de ejecutar npx lingo.dev@latest run en local.
Paso 1. Configura la CLI#
Si aún no lo has hecho, sigue la guía de configuración de la CLI. Al terminar, deberías tener:
- Un archivo
i18n.jsonen la raíz de tu proyecto - Una clave de API (ya sea
LINGO_API_KEYpara el motor de Lingo.dev o una clave de proveedor comoOPENAI_API_KEY) - La capacidad de generar traducciones en local con
npx lingo.dev@latest run
Paso 2. Añade tu clave de API como secreto de CI#
Guarda tu clave de API en el gestor de secretos de tu plataforma de CI:
- Ve a Settings > Secrets and variables > Actions
- Haz clic en New repository secret
- Nombre:
LINGODOTDEV_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#
Elige el flujo de trabajo que mejor encaje con tu equipo y sigue después la guía específica de tu plataforma:
| 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 i18n.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 flujo de trabajo de CI, sube un cambio para activarlo. La integración debería:
- Ejecutar el pipeline de traducción
- Hacer commit de las traducciones o abrir una PR, según tu flujo de trabajo
- Actualizar el archivo
i18n.lock
Para comprobar en CI que las traducciones están completas sin generar otras nuevas, usa la marca --frozen:
npx lingo.dev@latest run --frozenEsto devuelve un estado distinto de cero si hay contenido sin traducir; resulta útil como control previo al despliegue. Consulta Patrones avanzados para ver ejemplos.
