Vertaalaanbieders

Volledig achterwaarts compatibel: provider staat standaard op azure, dus bestaande Azure-workflows blijven ongewijzigd — er zijn geen aanpassingen nodig.

Het kiezen van een aanbieder

Stel de provider invoer in op azure (standaard), aws of google en geef vervolgens de inloggegevens van die provider in. Er wordt slechts één provider per actieoproep gebruikt; de actie delegeert deterministisch aan de bijpassende SDK achter een fabriek.

Vergelijking van aanbieders

Azure AI Translator (default)

De standaardprovider. Stel een Azure AI Translator-bron beschikbaar en geef subscriptionKey, endpoint en optioneel region door. Dit is dezelfde configuratie die bestaande workflows al gebruiken.

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

Gebruikt @aws-sdk/client-translate. Geef de voorkeur aan OIDC via aws-actions/configure-aws-credentials zodat er geen langlopende geheimen worden opgeslagen — de actie leest de standaard inloggegevensketen van de AWS SDK. Of awsAccessKeyId passen en expliciet awsSecretAccessKey. Een regio is altijd vereist, via awsRegion of de AWS_REGION omgevingsvariabele.

Official AWS docs

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

OIDC (aanbevolen)

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

Om statische toetsen te gebruiken in plaats van OIDC, laat je de aws-actions/configure-aws-credentials stap vallen en geef awsAccessKeyId / awsSecretAccessKey door (via secrets) plus awsRegion.

Google Cloud Vertaling

Gebruikt @google-cloud/translate (v2). Authenticeer met een API-sleutel (googleApiKey) of een service-account JSON-credential (googleCredentials). Lever precies één; Een optionele googleProjectId wordt afgeleid uit de kwalificatie wanneer deze wordt weggelaten.

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-specifieke specificaties worden gemapt waar een equivalent bestaat. De rest valt terug op verstandige standaardwaarden zodat het gedrag consistent blijft.

Locatiecodes verschillen per aanbieder

Elke provider gebruikt zijn eigen locatiecodes (bijvoorbeeld Vereenvoudigd Chinees wordt zh-Hans op Azure, zh op AWS en zh-CN op Google). Codes worden doorgegeven zoals ze zijn en sturen de uitvoerbestandsnamen aan, dus kies toLocales waarden die je gekozen provider ondersteunt.