Bitbucket Pipelines

Bitbucket에서는 파이프라인 스텝 안에서 @lingo.dev/cli를 실행하면 됩니다. 설치 후 lingo push를 실행해 변경된 소스 문자열을 엔진으로 번역한 다음, 결과를 커밋하거나 Bitbucket 기본 도구로 pull request를 열 수 있습니다.

사전 요구 사항

커밋된 .lingo/config.json 파일이 필요합니다. 여기에는 engineId, 소스 및 대상 로캘, 그리고 files 패턴이 포함되어 있어야 합니다. 또한 Lingo.dev API 키는 리포지토리 변수에 저장해야 합니다. 설정 파일을 만들려면 CLI quickstart를 참고하세요.

인증#

CLI는 LINGO_API_KEY 환경 변수로 인증합니다. 파이프라인 스텝에서 사용할 수 있도록 키를 secured 리포지토리 변수로 추가하세요:

Repository settings > Repository variables — LINGO_API_KEY를 추가하고 secured로 설정하세요.

리포지토리에 커밋을 다시 푸시하거나 pull request를 열려면 파이프라인에 Git 쓰기 권한도 필요합니다. 일반적으로는 리포지토리 SSH 키(Repository settings > SSH keys) 또는 Read & write repositories 범위(그리고 PR 모드에서는 pull requests 범위 포함)를 가진 리포지토리 액세스 토큰을 사용하며, 이를 BB_TOKEN 같은 secured 리포지토리 변수로 저장합니다.

워크플로 예제#

직접 커밋(기본값)#

CLI를 설치하고 lingo push를 실행한 뒤, 번역된 파일을 브랜치에 다시 커밋하세요:

yaml

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는 마지막 실행 이후 변경된 내용만 번역하고(.lingo/lock.json에서 추적), 실행이 끝날 때까지 기다린 뒤 결과를 디스크에 기록합니다.

풀 리퀘스트 모드#

main에 직접 커밋하는 대신 전용 브랜치로 번역을 푸시한 다음, Bitbucket 도구로 pull request를 여세요:

yaml

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

모노레포#

설정 파일이 워크스페이스 안에 있다면 하위 디렉터리에서 CLI를 실행하세요. CLI는 작업 디렉터리를 기준으로 .lingo/config.json를 확인합니다:

yaml

image: node:22

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

파이프라인 변수#

변수	필수	설명
`LINGO_API_KEY`	예	Lingo.dev API 키입니다. secured 리포지토리 변수로 저장하세요.
`BB_TOKEN`	푸시/PR 쓰기 권한용	Git이 커밋하거나 pull request를 열 때 사용하는 리포지토리 액세스 토큰(또는 SSH 키)입니다.

그 외 모든 것 — 소스 로캘, 대상 로캘, 파일 패턴, 그리고 어떤 엔진으로 라우팅할지 — 는 파이프라인 변수가 아니라 .lingo/config.json에 들어 있습니다.

배포 전 검증#

소스 문자열 가운데 번역이 누락된 항목이 하나라도 있으면 파이프라인이 실패하도록 lingo check 스텝을 추가하세요:

yaml

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

다음 단계#

GitHub App

GitHub에서 손대지 않고 운영하는 지속적 로컬라이제이션

GitHub Actions

GitHub Actions 작업에서 CLI 실행

GitLab CI/CD

GitLab 파이프라인에서 CLI 실행

고급 패턴

번역 검사, 병합 충돌, 워크플로 선택

사전 요구 사항

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는 마지막 실행 이후 변경된 내용만 번역하고(.lingo/lock.json에서 추적), 실행이 끝날 때까지 기다린 뒤 결과를 디스크에 기록합니다.

풀 리퀘스트 모드#

main에 직접 커밋하는 대신 전용 브랜치로 번역을 푸시한 다음, Bitbucket 도구로 pull request를 여세요:

yaml

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

모노레포#

설정 파일이 워크스페이스 안에 있다면 하위 디렉터리에서 CLI를 실행하세요. CLI는 작업 디렉터리를 기준으로 .lingo/config.json를 확인합니다:

yaml

image: node:22

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

파이프라인 변수#

변수	필수	설명
`LINGO_API_KEY`	예	Lingo.dev API 키입니다. secured 리포지토리 변수로 저장하세요.
`BB_TOKEN`	푸시/PR 쓰기 권한용	Git이 커밋하거나 pull request를 열 때 사용하는 리포지토리 액세스 토큰(또는 SSH 키)입니다.

배포 전 검증#

소스 문자열 가운데 번역이 누락된 항목이 하나라도 있으면 파이프라인이 실패하도록 lingo check 스텝을 추가하세요:

yaml

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

다음 단계#

GitHub App

GitHub에서 손대지 않고 운영하는 지속적 로컬라이제이션

GitHub Actions

GitHub Actions 작업에서 CLI 실행

GitLab CI/CD

GitLab 파이프라인에서 CLI 실행

고급 패턴

번역 검사, 병합 충돌, 워크플로 선택