Översättningsleverantörer

Fullt bakåtkompatibelt: provider är som standard azure, så befintliga Azure-arbetsflöden fortsätter att fungera oförändrade — inga redigeringar krävs.

Val av leverantör

Ställ in provider inmatning till azure (standard), aws eller google och lämna sedan den leverantörens inloggningsuppgifter. Endast en leverantör används per åtgärdsanrop; åtgärden delegerar deterministiskt till den matchande SDK:n bakom en fabrik.

Jämförelse av leverantörer

Azure AI Translator (default)

Standardleverantören. Tillhandahåll en Azure AI Translator-resurs och skicka subscriptionKey, endpoint och eventuellt region. Detta är samma konfiguration som befintliga arbetsflöden redan använder.

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

Använder @aws-sdk/client-translate. Föredra OIDC via aws-actions/configure-aws-credentials så att inga långlivade hemligheter lagras — åtgärden läser AWS SDK:s standardbehörighetskedja. Alternativt, klara awsAccessKeyId och awsSecretAccessKey uttryckligen. En region krävs alltid, via awsRegion eller den AWS_REGION miljövariabeln.

Official AWS docs

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

OIDC (rekommenderas)

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

För att använda statiska tangenter istället för OIDC, ta bort aws-actions/configure-aws-credentials steg och skicka awsAccessKeyId / awsSecretAccessKey (via secrets) plus awsRegion.

Google Cloud Translation

Använder @google-cloud/translate (v2). Autentisera med antingen en API-nyckel (googleApiKey) eller en servicekonto-JSON-legitimation (googleCredentials). Leverera exakt en; En frivillig googleProjectId härleds från legitimationen när den utelämnas.

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

Avsiktsspecifikativ avbildning

Provider-specifika specifierare mappas där en motsvarighet finns. Allt annat faller tillbaka på rimliga standardinställningar så att beteendet förblir konsekvent.

Lokalkoderna skiljer sig mellan leverantörer

Varje leverantör använder sina egna lokalkoder (till exempel är förenklad kinesiska zh-Hans på Azure, zh på AWS och zh-CN på Google). Koder passerar genom som de är och styr utdatafilnamnen, så välj toLocales värden som din valda leverantör stödjer.