Lingo.dev の Bitbucket 連携では、公式 Pipe を使ってローカライゼーションパイプラインを実行します。翻訳を直接コミットすることも、プルリクエストとして作成することもでき、rebase による競合の自動解消にも対応しています。
前提条件
先にCI/CD Setupを完了してください。動作するi18n.jsonと、リポジトリ変数として保存されたLINGODOTDEV_API_KEYが必要です。
認証#
API キーをリポジトリ変数として追加します: Repository settings > Repository variables。
プルリクエストモードを使う場合は、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プルリクエストモード#
yaml
image:
name: atlassian/default-image:2
pipelines:
branches:
main:
- step:
name: Translate
script:
- pipe: lingodotdev/lingo.dev:main
variables:
LINGODOTDEV_PULL_REQUEST: "true"フル設定のフィーチャーブランチ#
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 | 必須 | Lingo.dev API キー |
BB_TOKEN | PR モードで必須 | Bitbucket アクセストークン |
LINGODOTDEV_PULL_REQUEST | false | 直接コミットではなくプルリクエストを作成 |
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 | この連携が作成したコミットも処理対象に含める |
