Käännöspalveluntarjoajat

Täysin taaksepäin yhteensopiva: provider oletuksena on azure, joten olemassa olevat Azure-työnkulut toimivat muuttumattomina — muokkauksia ei tarvita.

Palveluntarjoajan valinta

Aseta provider-syötteeksi azure (oletus), aws tai google ja anna sitten kyseisen palveluntarjoajan tunnukset. Jokaista toimintakutsua käytetään vain yhtä palveluntarjoajaa; toiminta delegoi deterministisesti tehtaan takana olevalle vastaavalle SDK:lle.

Tarjoajien vertailu

Azure AI Translator (default)

Oletuspalveluntarjoaja. Tarjoa Azure AI Translator -resurssi ja läpäise subscriptionKey, endpoint ja halutessasi region. Tämä on sama kokoonpano, jota olemassa olevat työnkulut jo käyttävät.

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

Käyttää @aws-sdk/client-translate. Suosi OIDC:tä aws-actions/configure-aws-credentials:n kautta, jotta pitkäaikaisia salaisuuksia ei tallenneta — toiminto lukee AWS SDK:n oletustunnistusketjun. Vaihtoehtoisesti voit awsAccessKeyId ja awsSecretAccessKey selkeästi. Alue vaaditaan aina, joko awsRegion tai AWS_REGION ympäristömuuttujan kautta.

Official AWS docs

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

OIDC (suositeltava)

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

Jos haluat käyttää staattisia näppäimiä OIDC:n sijaan, poista aws-actions/configure-aws-credentials-vaihe ja välitä awsAccessKeyId / awsSecretAccessKey (secrets:n kautta) plus awsRegion.

Google Cloud Translation

Käyttää @google-cloud/translate (v2). Tunnista joko API-avaimella (googleApiKey) tai palvelutilin JSON-tunnisteella (googleCredentials). Anna täsmälleen yksi; valinnainen googleProjectId päätellen pätevyydestä, jos se jätetään pois.

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 -kuvaus

Palveluntarjoajakohtaiset spesifikaattorit kartoitetaan siellä, missä vastaava on olemassa. Kaikki muu palautuu järkevään oletustilaan, jotta käytös pysyy johdonmukaisena.

Paikalliskoodit vaihtelevat palveluntarjoajasta riippuen

Jokainen palveluntarjoaja käyttää omia paikalliskoodiaan (esimerkiksi Simplified Chinese on zh-Hans Azuressa, zh AWS:ssä ja zh-CN Googlessa). Koodit kulkevat läpi sellaisenaan ja ohjaavat tulostiedostojen nimiä, joten valitse toLocales arvot, joita valitsemasi palveluntarjoaja tukee.