lingo ci는 CI 작업 안에서 로컬라이제이션 파이프라인을 실행한 뒤, 결과를 다시 리포지토리에 반영합니다. 브랜치에 커밋하거나 pull request를 여는 방식 중 하나를 사용할 수 있습니다. GitHub Actions, GitLab CI, Bitbucket Pipelines 같은 플랫폼도 자동으로 감지해 git identity, remote, 브랜치를 알아서 설정해 줍니다.
기본 사용법#
bash
lingo ci기본적으로 번역 단계를 실행한 다음, 새 번역이 있으면 현재 브랜치에 바로 커밋합니다.
단계 선택하기#
--step는 번역 단계로 실행할 명령을 선택합니다(기본값: localize). push/pull 파일 워크플로를 사용할 때는 push를 사용하세요:
bash
lingo ci --step push사용 가능한 단계: localize, ship, push, extract.
커밋 vs. pull request#
브랜치에 커밋하거나(기본값), 전용 lingo.dev/* 브랜치에서 PR을 열거나 업데이트할 수 있습니다:
bash
lingo ci --step push --pull-request유용한 플래그:
| 플래그 | 설명 |
|---|---|
--pull-request | 기본 브랜치에 커밋하는 대신 PR을 열거나 업데이트합니다. |
--commit-message <msg> | 커밋 메시지입니다. 기본값: feat: update translations via @lingodotdev. |
--pull-request-title <title> | PR 제목입니다. |
--commit-author-name / --commit-author-email | Git 작성자입니다. 기본값은 Lingo.dev / support@lingo.dev입니다. |
--working-directory <dir> | 먼저 하위 디렉터리로 cd합니다 — monorepos에서 유용합니다. |
--gpg-sign | 설정된 GPG 키로 커밋에 서명합니다. |
--process-own-commits | 마지막 커밋 작성자가 이미 Lingo.dev여도 실행을 건너뛰지 않습니다. |
GitHub Actions 예시#
API 키(lingo login --api-key, 또는 secret으로 설정)를 사용해 인증하고, 기본 브랜치에 merge될 때마다 실행하세요:
yaml
name: Translate
on:
push:
branches: [main]
jobs:
localize:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npx @lingo.dev/cli@latest ci --step push --pull-request
env:
LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}이렇게 하면 main에 push할 때마다 새로 추가되거나 변경된 소스를 번역하고, 결과를 검토할 수 있도록 PR을 엽니다.
