Bafetoledi

Fully backward compatible: provider defaults to azure, so existing Azure workflows keep working unchanged — no edits required.

Kgetho Mofani

Ngwala provider go azure (default), aws, google, gomme o fe moabi wa tshedimošo yeo. Only one provider is used per action call; the action deterministically delegates to the matching SDK behind a factory.

Provider comparison

Azure AI Translator (default)

Mofani yo a fošagetšego. Provide an Azure AI Translator resource and pass subscriptionKey, endpoint, and optionally region. Ye ke mokgwa wo o swanago le wo o šetšego o šomišitšwe.

Official Azure docs

• Azure Translator documentation
• Translate API reference
• Custom Translator overview
• Language support

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 Translate

Diriša @aws-sdk/client-translate. Prefer OIDC via aws-actions/configure-aws-credentials so no long-lasting secrets are stored — the action reads the AWS SDK default credential chain. Ka tsela ye nngwe, fetiša awsAccessKeyId gomme awsSecretAccessKey ka go kwagala. Ka mehla go nyakega selete, ka awsRegion goba ka tikologo ye e AWS_REGION.

Official AWS docs

• Amazon Translate overview
• TranslateText API reference
• Setting formality
• Using brevity
• Custom terminology
• Parallel data
• Supported languages

OIDC (e šišintšwe)

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"]'

Go diriša dinotlelo tše di sa fetogego sebakeng sa OIDC, tlogela kgato ya aws-actions/configure-aws-credentials gomme o fete awsAccessKeyId / awsSecretAccessKey (ka secrets) le awsRegion.

Google Cloud Translation

Diriša @google-cloud/translate (v2). Netefatša ka senotlelo sa API (googleApiKey) goba setifikeiti sa JSON sa akhaonte ya tirelo (googleCredentials). Fana ka e tee fela; Setifikeiti sa boikgethelo se googleProjectId tšewa go tšwa go setifikeiti ge se tlogetšwe.

Official Google docs

• Cloud Translation documentation
• Cloud Translation setup
• Translating text
• Supported languages

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"]'

Intent-specifier mapping

Ditlhalošo tše di kgethegilego tša mofani di bewa moo go nago le sebopego sa go lekana. Dilo tše dingwe ka moka di wela morago go diphošo tše di kwagalago, ka fao maitshwaro a dula a sa fetoge.

Locale codes differ per provider

Moabi yo mongwe le yo mongwe o diriša dikhoutu tša gagwe tša selegae (mohlala, Simplified Chinese is zh-Hans on Azure, zh on AWS, and zh-CN on Google). Dikhoutu di feta bjalo ka ge di le gomme di otlela maina a faele ya tšweletšo, ka fao kgetha boleng bjo toLocales moabi wa gago yo o kgethilwego a bo thekgago.