번역 제공자 · 리소스 번역기

완전 하위 호환: provider 기본적으로 azure 설정되어 기존 Azure 워크플로우가 변경되지 않고 계속 작동하며 편집이 필요 없습니다.

제공자 선택

provider 입력을 azure(기본값), aws, 또는 google로 설정한 후 해당 제공자의 자격 증명을 제공합니다. 각 액션 콜마다 한 명의 제공자만 사용됩니다; 이 동작은 공장 뒤에 있는 매칭 SDK에 결정론적으로 위임됩니다.

제공자 비교

Azure AI 번역기

제공자 가치: Azure(기본값)
SDK: @azure-rest/ai-translation-text

subscriptionKey, 엔드포인트, 리전 (선택 사항)

AWS 번역

제공자 가치: AWS
SDK: @aws-sdk/client-translate

OIDC / 기본 체인, 또는 awsAccessKeyID + awsSecretAccessKey; awsRegion

구글 클라우드 번역

제공자 가치: 구글 검색해 보세요
SDK: @google-cloud/translate

googleApiKey 또는 googleCredentials (service-account JSON)

Azure AI 번역기 (기본값)

기본 제공자입니다. Azure AI 번역기 리소스를 제공하고, subscriptionKey, endpoint, 선택적으로 region을 패스하세요. 기존 워크플로우들이 이미 사용하는 것과 동일한 구성입니다.

Official Azure docs

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            azure:
              subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
              endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
              region: ${{ secrets.TRANSLATOR_REGION }}
          sourceLocale: en
          toLocales: '["es","fr","de"]'

AWS 번역

@aws-sdk/client-translate 사용해. aws-actions/configure-aws-credentials를 통한 OIDC를 선호하여 장기 비밀이 저장되지 않도록 하세요 — 이 동작은 AWS SDK 기본 자격 증명 체인을 읽습니다. 또는 awsAccessKeyId을 전달하고 명시적으로 awsSecretAccessKey 수도 있습니다. 항상 awsRegion나 AWS_REGION 환경 변수를 통해 지역이 필요합니다.

Official AWS docs

OIDC (권장)

permissions:
  id-token: write # for aws-actions/configure-aws-credentials OIDC
  contents: write
  pull-requests: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789012:role/gh-actions-translate
          aws-region: us-east-1

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            aws:
              region: us-east-1 # or rely on AWS_REGION from the step above
              formality: FORMAL
              brevity: true
          sourceLocale: en
          toLocales: '["es","fr","de"]'

OIDC 대신 정적 키를 사용하려면 aws-actions/configure-aws-credentials 단계를 내리고 awsAccessKeyId / awsSecretAccessKey(secrets 통해) 플러스 awsRegion를 패스하세요.

구글 클라우드 번역

@google-cloud/translate (v2)를 사용합니다. API 키(googleApiKey) 또는 서비스 계정 JSON 자격 증명(googleCredentials)으로 인증하세요. 정확히 한 개만 제공하세요; 자격 증명이 누락되면 선택적 googleProjectId이 추론됩니다.

Official Google docs

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            google:
              # Provide EITHER a service-account JSON credential...
              credentials: ${{ secrets.GCP_TRANSLATE_CREDENTIALS }}
              # ...OR an API key:
              # apiKey: ${{ secrets.GCP_TRANSLATE_API_KEY }}
              model: nmt
          sourceLocale: en
          toLocales: '["es","fr","de"]'

의도-명세자 매핑

제공자 특화 지정자는 동등한 조건이 존재하는 곳에 매핑됩니다. 나머지는 모두 합리적인 기본값으로 돌아가서 행동이 일관성을 유지합니다.

textType

Azure: textType (평범 / html)
AWS: 무시됨 (토글 없음)
구글: 형식 (텍스트 / HTML)

profanityAction

Azure: 전폭적인 지원
AWS: 마스킹 표시 / 삭제됨 →
구글: 무시됨

categoryId

Azure: 커스텀 번역기
AWS: 무시됨
구글: 무시됨

allowFallback

Azure: 지원
AWS: 무시됨
구글: 무시됨

awsFormality

Azure: Ignored
AWS: Formality setting
구글: Ignored

awsBrevity

Azure: Ignored
AWS: Brevity mode
구글: Ignored

awsTerminologyNames

Azure: Ignored
AWS: Custom terminology
구글: Ignored

awsParallelDataNames

Azure: Ignored
AWS: Parallel data
구글: Ignored

googleModel

Azure: Ignored
AWS: Ignored
구글: Translation model

googleApiEndpoint

Azure: Ignored
AWS: Ignored
구글: API endpoint override

지역 코드는 제공자마다 다릅니다

각 제공업체는 자체 로컬 코드를 사용합니다(예를 들어, 간체 중국어는 Azure, zh은 AWS, zh-CN은 Google에서 zh-Hans). 코드는 현재 상태를 통해 전달되어 출력 파일 이름을 구동하므로, 선택한 제공자가 지원하는 toLocales 값을 선택하세요.