Itzulpen hornitzaileak

Erabat atzera bateragarria: provider lehenetsita azure, beraz, Azure lan-fluxuak aldatu gabe jarraitzen dute — ez da aldaketarik behar.

Hornitzaile bat aukeratzea

Ezarri provider sarrera azure (lehenetsia), aws edo google, eta hornitzaile horren kredentzialak eman. Ekintza dei bakoitzeko hornitzaile bakarra erabiltzen da; ekintza determinististak fabrika baten atzean dagoen SDK-ra delegatu egiten du.

Hornitzaileen konparazioa

Azure AI Itzultzailea (lehenetsia)

Hornitzaile lehenetsia. Azure AI Itzultzaile baliabide bat hornitu eta subscriptionKey, endpoint eta aukeraz region. Konfigurazio bera da dagoeneko dauden lan-fluxuek erabiltzen dutena.

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

Erabiltzen @aws-sdk/client-translate. OIDC nahiago aws-actions/configure-aws-credentials bidez, sekretu iraunkorrak ez gordetzeko — ekintzak AWS SDK lehenetsitako kredentzialen katea irakurtzen du. Bestela, awsAccessKeyId eta awsSecretAccessKey esplizituki. Eskualde bat beti behar da, awsRegion edo ingurune aldagai AWS_REGION bidez.

Official AWS docs

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

OIDC (gomendatua)

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

OIDC ordez giltza estatikoak erabiltzeko, aws-actions/configure-aws-credentials pausoa kendu eta pasatu awsAccessKeyId / awsSecretAccessKey (secrets bidez) gehi awsRegion.

Google Cloud Itzulpena

@google-cloud/translate (v2) erabiltzen du. API gako (googleApiKey) edo zerbitzu-kontu JSON kredentzial (googleCredentials) erabiliz autentifikatu. Eman hornidura bat zehazki; Aukerazko googleProjectId bat ateratzen da ziurtagiritik kanpo geratzen denean.

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

Asmo-zehaztatzailearen mapaketa

Hornitzaile espezifikoak baliokide bat dagoenean mapatzen dira. Gainerako guztia lehenetsitako zentzudunetara itzultzen da, portaera koherentea izan dadin.

Tokiko kodeak hornitzailearen arabera desberdinak dira

Hornitzaile bakoitzak bere kode lokal propioak erabiltzen ditu (adibidez, Txinera Sinplifikatua Azure-n zh-Hans, AWSn zh eta Google-n zh-CN). Kodeak horrela pasatzen dira eta irteerako fitxategi izenak gidatzen dituzte, beraz, aukeratu zure hautatutako hornitzaileak onartzen dituen balio toLocales.