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, agregar tu clave de API y elegir un flujo de trabajo.
¿Prefieres configurar GitHub App?
La GitHub App no usa este flujo: no necesitas una CLI local, i18n.json ni un secreto de clave de API. Instalas la app una sola vez y agregas un .lingo/config.json al repositorio. Sigue la guía de GitHub App.
Requisitos previos
Necesitas tener una configuración de CLI funcionando, con un archivo i18n.json y la capacidad de ejecutar npx lingo.dev@latest run localmente antes de agregar CI/CD.
Paso 1. Configura la CLI#
Si todavía no lo hiciste, sigue la guía de configuración de la CLI. Al final deberías tener:
- Un archivo
i18n.jsonen la raíz de tu proyecto - Una clave de API (ya sea
LINGO_API_KEYpara Lingo.dev motor o una clave de proveedor comoOPENAI_API_KEY) - La capacidad de generar traducciones localmente con
npx lingo.dev@latest run
Paso 2. Agrega tu clave de API como secreto de CI#
Guarda tu clave de API en el administrador 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 agrega la configuración#
Elige el flujo de trabajo que mejor se adapte a tu equipo y luego sigue la guía específica para tu plataforma:
| 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 i18n.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 flujo de trabajo de CI, haz un push de un cambio para activarlo. La integración debería:
- Ejecutar el pipeline de traducción
- Hacer commit de las traducciones o abrir un PR (según tu flujo de trabajo)
- Actualizar el archivo
i18n.lock
Para verificar en CI que las traducciones estén completas sin generar nuevas, usa la bandera --frozen:
npx lingo.dev@latest run --frozenEsto devuelve un estado distinto de cero si hay contenido sin traducir; es útil como control antes del despliegue. Consulta Patrones avanzados para ver ejemplos.
