Bitbucket Pipelines

Интеграция Lingo.dev для Bitbucket использует официальный Pipe для запуска конвейера локализации. Она либо коммитит переводы напрямую, либо создает pull request с автоматическим разрешением конфликтов через rebase.

Предварительные требования

Сначала выполните настройку CI/CD. Вам понадобятся рабочие i18n.json и LINGODOTDEV_API_KEY, сохраненные как переменные репозитория.

Аутентификация#

Добавьте API-ключ как переменную репозитория: Repository settings > Repository variables.

Для режима pull request также создайте токен доступа Bitbucket:

Repository settings > Access tokens > Create Repository Access Token
Выдайте области доступа: Read & write repositories, Read & write pull requests
Добавьте его как переменную репозитория с именем BB_TOKEN

Примеры рабочего процесса#

Прямой коммит (по умолчанию)#

yaml

image:
  name: atlassian/default-image:2

pipelines:
  branches:
    main:
      - step:
          name: Translate
          script:
            - pipe: lingodotdev/lingo.dev:main

Режим 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-ветка с полной конфигурацией#

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"

Переменные конфигурации#

Переменная	По умолчанию	Описание
`LINGODOTDEV_API_KEY`	Обязательно	API-ключ Lingo.dev
`BB_TOKEN`	Обязательно для режима PR	Токен доступа Bitbucket
`LINGODOTDEV_PULL_REQUEST`	`false`	Создавать pull request вместо прямого коммита
`LINGODOTDEV_PULL_REQUEST_TITLE`	`feat: update translations via @lingodotdev`	Свой заголовок PR
`LINGODOTDEV_COMMIT_MESSAGE`	`feat: update translations via @lingodotdev`	Своё сообщение коммита
`LINGODOTDEV_WORKING_DIRECTORY`	`.`	Рабочая директория для монорепозиториев
`LINGODOTDEV_PROCESS_OWN_COMMITS`	`false`	Обрабатывать коммиты, созданные этой интеграцией

Что дальше#

GitHub Actions

Настройте интеграцию с GitHub Actions

GitLab CI/CD

Настройте интеграцию с GitLab CI/CD

Продвинутые сценарии

Проверки переводов, конфликты слияния, выбор рабочего процесса

Подключите свой движок

Направляйте переводы CI/CD через свой движок

Эта страница была полезной?

Предварительные требования

Аутентификация#

Добавьте API-ключ как переменную репозитория: Repository settings > Repository variables.

Для режима pull request также создайте токен доступа Bitbucket:

Repository settings > Access tokens > Create Repository Access Token
Выдайте области доступа: Read & write repositories, Read & write pull requests
Добавьте его как переменную репозитория с именем BB_TOKEN

Примеры рабочего процесса#

Прямой коммит (по умолчанию)#

yaml

image:
  name: atlassian/default-image:2

pipelines:
  branches:
    main:
      - step:
          name: Translate
          script:
            - pipe: lingodotdev/lingo.dev:main

Режим 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-ветка с полной конфигурацией#

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"

Переменные конфигурации#

Переменная	По умолчанию	Описание
`LINGODOTDEV_API_KEY`	Обязательно	API-ключ Lingo.dev
`BB_TOKEN`	Обязательно для режима PR	Токен доступа Bitbucket
`LINGODOTDEV_PULL_REQUEST`	`false`	Создавать pull request вместо прямого коммита
`LINGODOTDEV_PULL_REQUEST_TITLE`	`feat: update translations via @lingodotdev`	Свой заголовок PR
`LINGODOTDEV_COMMIT_MESSAGE`	`feat: update translations via @lingodotdev`	Своё сообщение коммита
`LINGODOTDEV_WORKING_DIRECTORY`	`.`	Рабочая директория для монорепозиториев
`LINGODOTDEV_PROCESS_OWN_COMMITS`	`false`	Обрабатывать коммиты, созданные этой интеграцией

Что дальше#

GitHub Actions

Настройте интеграцию с GitHub Actions

GitLab CI/CD

Настройте интеграцию с GitLab CI/CD

Продвинутые сценарии

Проверки переводов, конфликты слияния, выбор рабочего процесса

Подключите свой движок

Направляйте переводы CI/CD через свой движок