La integración de Lingo.dev para Bitbucket usa un Pipe oficial para ejecutar el pipeline de localización. Hace commit de las traducciones directamente o crea pull requests, con resolución automática de conflictos mediante rebase.
Requisitos previos
Primero, completa la configuración de CI/CD. Necesitas un i18n.json y un LINGODOTDEV_API_KEY funcionales guardados como variables del repositorio.
Autenticación#
Agrega tu clave de API como variable del repositorio: Repository settings > Repository variables.
Si usas el modo pull request, también debes crear un token de acceso de Bitbucket:
- Repository settings > Access tokens > Create Repository Access Token
- Asigna estos permisos: Read & write repositories, Read & write pull requests
- Agrégalo como variable del repositorio con el nombre
BB_TOKEN
Ejemplos de flujo de trabajo#
Commit directo (predeterminado)#
yaml
image:
name: atlassian/default-image:2
pipelines:
branches:
main:
- step:
name: Translate
script:
- pipe: lingodotdev/lingo.dev:mainModo pull request#
yaml
image:
name: atlassian/default-image:2
pipelines:
branches:
main:
- step:
name: Translate
script:
- pipe: lingodotdev/lingo.dev:main
variables:
LINGODOTDEV_PULL_REQUEST: "true"Feature branch con configuración completa#
yaml
image:
name: atlassian/default-image:2
pipelines:
branches:
feat/*:
- step:
name: Translate
script:
- pipe: lingodotdev/lingo.dev:main
variables:
LINGODOTDEV_API_KEY: "${MY_LINGODOTDEV_API_KEY}"
BB_TOKEN: "${MY_ACCESS_TOKEN}"
LINGODOTDEV_PULL_REQUEST: "true"
LINGODOTDEV_PULL_REQUEST_TITLE: "feat: update translations"
LINGODOTDEV_COMMIT_MESSAGE: "feat: update translations"
LINGODOTDEV_WORKING_DIRECTORY: "apps/web"Variables de configuración#
| Variable | Predeterminado | Descripción |
|---|---|---|
LINGODOTDEV_API_KEY | Obligatorio | Clave de API de Lingo.dev |
BB_TOKEN | Obligatorio para el modo PR | Token de acceso de Bitbucket |
LINGODOTDEV_PULL_REQUEST | false | Crea un pull request en lugar de hacer commit directo |
LINGODOTDEV_PULL_REQUEST_TITLE | feat: update translations via @lingodotdev | Título personalizado del PR |
LINGODOTDEV_COMMIT_MESSAGE | feat: update translations via @lingodotdev | Mensaje de commit personalizado |
LINGODOTDEV_WORKING_DIRECTORY | . | Directorio de trabajo para monorepos |
LINGODOTDEV_PROCESS_OWN_COMMITS | false | Procesa los commits realizados por esta integración |
