Bitbucket Pipelines

V Bitbucketu spusťte @lingo.dev/cli v kroku pipeline: nainstalujte ho, spusťte lingo push, aby přeložil změněné zdrojové řetězce přes váš engine, a pak výsledky commitněte nebo otevřete pull request pomocí nástrojů Bitbucketu.

Autentizace#

CLI se autentizuje pomocí proměnné prostředí LINGO_API_KEY. Přidejte svůj klíč jako zabezpečenou proměnnou repozitáře, aby byl dostupný pro kroky pipeline:

Repository settings > Repository variables — přidejte LINGO_API_KEY a označte ji jako zabezpečenou.

Aby pipeline mohla pushovat commity nebo otevírat pull requesty zpět do repozitáře, potřebuje Git také oprávnění k zápisu. Standardní možnosti jsou SSH klíč repozitáře (Repository settings > SSH keys) nebo přístupový token repozitáře s oprávněním Read & write repositories (a pull requests pro PR režim), uložený jako zabezpečená proměnná repozitáře, například BB_TOKEN.

Ukázky workflow#

Přímý commit (výchozí)#

Nainstalujte CLI, spusťte lingo push a commitněte přeložené soubory zpět do větve:

image: node:22

pipelines:
  branches:
    main:
      - step:
          name: Translate
          script:
            - npm install -g @lingo.dev/cli
            - lingo push
            - git config user.name "lingo-bot"
            - git config user.email "support@lingo.dev"
            - git add .
            - git diff --cached --quiet || git commit -m "chore: update translations"
            - git push origin HEAD:main

lingo push překládá jen to, co se od posledního spuštění změnilo (sledováno v .lingo/lock.json), počká na dokončení běhu a zapíše výstupy na disk.

Režim pull requestů#

Místo commitování do main pushněte překlady do vyhrazené větve a potom otevřete pull request pomocí nástrojů Bitbucketu:

image: node:22

pipelines:
  branches:
    main:
      - step:
          name: Translate
          script:
            - npm install -g @lingo.dev/cli
            - lingo push
            - git config user.name "lingo-bot"
            - git config user.email "support@lingo.dev"
            - git checkout -b lingo/translations
            - git add .
            - git diff --cached --quiet || git commit -m "feat: update translations"
            - git push origin lingo/translations
            # Open a PR from lingo/translations into main via the Bitbucket UI or API

Monorepo#

Pokud je konfigurace uložená uvnitř workspace, spusťte CLI z podadresáře. CLI vyhodnocuje .lingo/config.json z pracovního adresáře:

image: node:22

pipelines:
  branches:
    main:
      - step:
          name: Translate
          script:
            - cd apps/web
            - npm install -g @lingo.dev/cli
            - lingo push

Proměnné pipeline#

Všechno ostatní — zdrojový jazyk, cílové jazyky, patterny souborů i engine, přes který se směruje — patří do .lingo/config.json, ne do proměnných pipeline.

Ověření před nasazením#

Přidejte krok lingo check, který pipeline ukončí chybou, pokud některému zdrojovému řetězci chybí překlad:

- step:
          name: Check translations
          script:
            - npm install -g @lingo.dev/cli
            - lingo check

Další kroky#