Furnizori de traduceri

Complet compatibil cu versiunile înapoi: provider implicit pe azure, astfel încât fluxurile de lucru existente din Azure continuă să funcționeze neschimbate — fără modificări necesare.

Alegerea unui furnizor

Setează intrarea provider la azure (implicit), aws sau google, apoi furnizează datele de autentificare ale acelui furnizor. Se folosește un singur furnizor pentru fiecare apel de acțiune; acțiunea delegă determinist către SDK-ul corespunzător din spatele unei fabrici.

Comparație furnizori

Azure AI Translator (implicit)

Furnizorul implicit. Asigură o resursă Azure AI Translator și trece subscriptionKey, endpoint și opțional region. Aceasta este aceeași configurație pe care deja o folosesc fluxurile de lucru existente.

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

Folosește @aws-sdk/client-translate. Preferă OIDC prin aws-actions/configure-aws-credentials astfel încât să nu fie stocate secrete de lungă durată — acțiunea citește lanțul implicit de credențiale AWS SDK. Alternativ, transmite awsAccessKeyId și awsSecretAccessKey explicit. Este întotdeauna necesară o regiune, prin awsRegion sau variabila de mediu AWS_REGION.

Official AWS docs

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

OIDC (recomandat)

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

Pentru a folosi chei statice în loc de OIDC, elimină pasul aws-actions/configure-aws-credentials și treci awsAccessKeyId / awsSecretAccessKey (prin secrets) plus awsRegion.

Traducerea Google Cloud

Folosește @google-cloud/translate (v2). Autentificați-vă fie cu o cheie API (googleApiKey), fie cu o credențială JSON a contului de serviciu (googleCredentials). Furnizează exact unul; un googleProjectId opțional este dedus din acreditare când este omis.

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

Maparea specificatorului de intenție

Specificatorii specifici furnizorului sunt mapați acolo unde există un echivalent. Tot restul se întoarce la valori implicite rezonabile, astfel încât comportamentul rămâne consecvent.

Codurile locale diferă de la un furnizor la altul

Fiecare furnizor folosește propriile coduri locale (de exemplu, Chineza simplificată este zh-Hans pe Azure, zh pe AWS și zh-CN pe Google). Codurile trec așa cum sunt și controlează numele fișierelor de ieșire, așa că alege toLocales valori pe care furnizorul selectat le suportă.