Übersetzungsanbieter

Vollständig abwärtskompatibel: provider steht standardmäßig auf azure, sodass bestehende Azure-Workflows unverändert bleiben – keine Änderungen erforderlich.

Auswahl eines Anbieters

Stellen Sie die provider Eingabe auf azure (Standard), aws oder google ein und geben Sie dann die Zugangsdaten dieses Anbieters an. Pro Aktionsanruf wird nur ein Anbieter verwendet; die Aktion determiniert deterministisch an das entsprechende SDK hinter einer Fabrik.

Vergleich von Anbietern

Azure AI Translator (default)

Der Standardanbieter. Stellen Sie eine Azure AI Translator-Ressource bereit und übergeben Sie subscriptionKey, endpoint und optional region. Das ist dieselbe Konfiguration, die bereits bestehende Workflows verwenden.

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

Verwendet @aws-sdk/client-translate. Bevorzuge OIDC über aws-actions/configure-aws-credentials, damit keine langjährigen Geheimnisse gespeichert werden – die Aktion liest die Standard-Zugangsdatenkette des AWS SDK. Alternativ kann man awsAccessKeyId bestehen und awsSecretAccessKey explizit. Eine Region ist immer erforderlich, über awsRegion oder die AWS_REGION Umgebungsvariable.

Official AWS docs

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

OIDC (empfohlen)

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

Um statische Tasten statt OIDC zu verwenden, lassen Sie den aws-actions/configure-aws-credentials Schritt weg und geben Sie awsAccessKeyId / awsSecretAccessKey (über secrets) plus awsRegion weiter.

Google Cloud Translation

Verwendet @google-cloud/translate (v2). Authentifizieren Sie sich entweder mit einem API-Schlüssel (googleApiKey) oder einer JSON-Zugangsdaten für ein Servicekonto (googleCredentials). Liefern Sie genau eins; Ein optionales googleProjectId wird aus der Qualifikation abgeleitet, wenn sie ausgelassen wird.

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-spezifierende Abbildung

Providerspezifische Spezifikationen werden dort abgebildet, wo ein Äquivalent existiert. Alles andere fällt auf sinnvolle Standardwerte zurück, damit das Verhalten konstant bleibt.

Die Standortcodes unterscheiden sich je nach Anbieter

Jeder Anbieter verwendet seine eigenen Standortcodes (zum Beispiel ist vereinfachtes Chinesisch auf Azure zh-Hans, zh auf AWS und zh-CN auf Google). Codes werden wie sie sind durchlaufen und steuern die Ausgabe-Dateinamen, also wählen Sie toLocales Werte, die Ihr gewählter Anbieter unterstützt.