Abatanga ubusemuzi

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

Guhitamo umutanga

Shyira provider input kuri azure (default), aws, cyangwa google, hanyuma uhe ibyangombwa by'uwo mutangabuhamya. Only one provider is used per action call; the action deterministically delegates to the matching SDK behind a factory.

Kugereranya abatanga serivisi

Azure AI Translator (default)

The default provider. Gutanga ibikoresho bya Azure AI Translator hanyuma unyuze subscriptionKey, endpoint, kandi ku bushake region. Iki ni kimwe n'ibindi bikorwa by'ubucuruzi bimaze gushyirwa mu bikorwa.

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

Uses @aws-sdk/client-translate. Hitamo OIDC ukoresheje aws-actions/configure-aws-credentials kugira ngo hatagira amabanga y'igihe kirekire abikwa - igikorwa gisoma umuyoboro w'indangamuntu wa AWS SDK. Alternatively, pass awsAccessKeyId and awsSecretAccessKey explicitly. Buri gihe hakenewe ubufatanye bw'inzego z'ibanze, awsRegion cyangwa AWS_REGION'ibidukikije.

Official AWS docs

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

OIDC (recommended)

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

Kugirango ukoreshe urufunguzo rwa statique aho kuba OIDC, manuka intambwe ya aws-actions/configure-aws-credentials hanyuma unyuze awsAccessKeyId / awsSecretAccessKey (ukoresheje secrets) kongeraho awsRegion.

Google Cloud Translation

Koresha @google-cloud/translate (v2). Kwemeza ukoresheje urufunguzo rwa API (googleApiKey) cyangwa indangamuntu ya JSON (googleCredentials). Tanga kimwe gusa; an optional googleProjectId is inferred from the credential when omitted.

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

Provider-specific specifiers are mapped where an equivalent exists. Ibindi byose bigaruka ku makosa akwiriye kugira ngo imyitwarire ihoraho.

Locale codes differ per provider

Buri sosiyete ikoresha kode zayo z'aho ziherereye (urugero Igishinwa cyoroheje zh-Hans kuri Azure, zh kuri AWS, na zh-CN kuri Google). Kode zinyura muri as-is kandi zitwara amazina ya dosiye zisohoka, bityo hitamo agaciro toLocales utanga watoranyijwe ashyigikiye.