GitHub Actions

공식 Lingo.dev GitHub Action은 푸시가 발생할 때마다 로컬라이제이션 파이프라인을 실행하고, 워크플로에 따라 번역을 직접 커밋하거나 pull request를 생성합니다.

관리형 구성을 선호하시나요?

GitHub App은 GitHub에서 지속적 로컬라이제이션을 실행하는 가장 쉬운 방법입니다. 한 번만 설치하면 runner, API 키 secret, lockfile 없이도 푸시와 pull request에 반응합니다. 번역을 다른 CI 단계와 함께 자체 파이프라인 안에서 실행하고 싶다면 GitHub Action(아래)을 사용하세요.

사전 준비 사항

먼저 CI/CD Setup을 완료하세요. 저장소 secret에 저장된 정상 작동하는 i18n.json와 LINGODOTDEV_API_KEY이 필요합니다.

최소 구성#

.github/workflows/translate.yml 파일을 만드세요:

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

이렇게 설정하면 푸시할 때마다 번역이 main에 직접 커밋됩니다.

워크플로 예시#

main에 커밋#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

main에서 pull request 생성#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

PR 기반 워크플로를 사용하려면 Settings > Actions > General > Allow GitHub Actions to create and approve pull requests를 활성화하세요.

기능 브랜치에 커밋#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

기능 브랜치에서 pull request 생성#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

사용 가능한 입력값#

입력값	기본값	설명
`api-key`	필수	Lingo.dev API 키
`pull-request`	`false`	직접 커밋하는 대신 pull request 생성
`commit-message`	`feat: update translations via @LingoDotDev`	맞춤 커밋 메시지
`pull-request-title`	`feat: update translations via @LingoDotDev`	맞춤 PR 제목
`commit-author-name`	`Lingo.dev`	Git 커밋 작성자 이름
`commit-author-email`	`support@lingo.dev`	Git 커밋 작성자 이메일
`working-directory`	`.`	모노레포용 작업 디렉터리
`process-own-commits`	`false`	이 action이 생성한 커밋 처리
`parallel`	`false`	병렬 모드로 실행
`version`	`latest`	Lingo.dev CLI 버전

다음 단계#

GitHub App

관리형 대안 — runner, secret, lockfile 불필요

고급 패턴

번역 검사, 머지 충돌, 워크플로 선택

GitLab CI/CD

GitLab CI/CD 통합 설정

Bitbucket Pipelines

Bitbucket Pipelines 통합 설정

관리형 구성을 선호하시나요?

사전 준비 사항

먼저 CI/CD Setup을 완료하세요. 저장소 secret에 저장된 정상 작동하는 i18n.json와 LINGODOTDEV_API_KEY이 필요합니다.

최소 구성#

.github/workflows/translate.yml 파일을 만드세요:

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

이렇게 설정하면 푸시할 때마다 번역이 main에 직접 커밋됩니다.

워크플로 예시#

main에 커밋#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

main에서 pull request 생성#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

PR 기반 워크플로를 사용하려면 Settings > Actions > General > Allow GitHub Actions to create and approve pull requests를 활성화하세요.

기능 브랜치에 커밋#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

기능 브랜치에서 pull request 생성#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

사용 가능한 입력값#

입력값	기본값	설명
`api-key`	필수	Lingo.dev API 키
`pull-request`	`false`	직접 커밋하는 대신 pull request 생성
`commit-message`	`feat: update translations via @LingoDotDev`	맞춤 커밋 메시지
`pull-request-title`	`feat: update translations via @LingoDotDev`	맞춤 PR 제목
`commit-author-name`	`Lingo.dev`	Git 커밋 작성자 이름
`commit-author-email`	`support@lingo.dev`	Git 커밋 작성자 이메일
`working-directory`	`.`	모노레포용 작업 디렉터리
`process-own-commits`	`false`	이 action이 생성한 커밋 처리
`parallel`	`false`	병렬 모드로 실행
`version`	`latest`	Lingo.dev CLI 버전

다음 단계#

GitHub App

관리형 대안 — runner, secret, lockfile 불필요

고급 패턴

번역 검사, 머지 충돌, 워크플로 선택

GitLab CI/CD

GitLab CI/CD 통합 설정

Bitbucket Pipelines

Bitbucket Pipelines 통합 설정