Oversættelsesudbydere

Fuldt bagudkompatibel: provider er som standard azure, så eksisterende Azure-arbejdsgange fortsætter uændret — ingen redigeringer nødvendige.

Valg af udbyder

Indstil provider input til azure (standard), aws eller google, og giv derefter udbyderens legitimationsoplysninger. Kun én udbyder bruges pr. aktionskald; handlingen delegerer deterministisk til det matchende SDK bag en fabrik.

Udbydersammenligning

Azure AI Translator (default)

Standardudbyderen. Provisioner en Azure AI Translator-ressource og overfør subscriptionKey, endpoint og eventuelt region. Dette er den samme konfiguration, som eksisterende arbejdsgange allerede bruger.

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

Bruger @aws-sdk/client-translate. Foretrukk OIDC via aws-actions/configure-aws-credentials, så ingen langlivede hemmeligheder gemmes — handlingen læser AWS SDK's standard-credentialkæde. Alternativt kan du bestå awsAccessKeyId og awsSecretAccessKey eksplicit. Et område er altid påkrævet, via awsRegion eller den AWS_REGION miljøvariabel.

Official AWS docs

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

OIDC (anbefalet)

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

For at bruge statiske taster i stedet for OIDC, smid aws-actions/configure-aws-credentials step og overfør awsAccessKeyId / awsSecretAccessKey (via secrets) plus awsRegion.

Google Cloud Oversættelse

Bruger @google-cloud/translate (v2). Autentificér med enten en API-nøgle (googleApiKey) eller en servicekonto JSON-legitimation (googleCredentials). Lever præcis én; En valgfri googleProjectId udledes af legitimationen, når den udelades.

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

Udbyderspecifikke specifikationer mappes, hvor en ækvivalent findes. Alt andet falder tilbage på fornuftige standardindstillinger, så adfærden forbliver ensartet.

Lokalkoderne varierer fra udbyder til udbyder

Hver udbyder bruger sine egne lokalkoder (for eksempel er forenklet kinesisk zh-Hans på Azure, zh på AWS og zh-CN på Google). Koder passerer gennem som de er og styrer outputfilnavnene, så vælg toLocales værdier, din valgte udbyder understøtter.