Abahlinzeki bokuhumusha

Ukuhambisana ngokuphelele: provider okuzenzakalelayo ku-azure, ngakho-ke ukuhamba komsebenzi okukhona kwe-Azure kuyaqhubeka kusebenza kungashintshiwe - akukho ukuhlelwa okudingekayo.

Ukukhetha umhlinzeki

Hlela okokufaka provider ku-azure (okumisiwe), aws, noma google, bese unikeze iziqinisekiso zalowo mnikezeli. Umhlinzeki oyedwa kuphela osetshenziswa ngocingo ngalunye lwesenzo; isenzo sidlulisela ngokucacile ku-SDK ehambisanayo ngemuva kwefektri.

Ukuqhathaniswa komhlinzeki

Umhumushi we-Azure AI (okuzenzakalelayo)

Umhlinzeki ozenzakalelayo. Hlinzeka ngomthombo we-Azure AI Translator bese udlulisa subscriptionKey, endpoint, futhi ngokuzikhethela region. Lesi yisimo esifanayo esivele sisetshenziswa yi-Excel.

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

Ukuhumusha kwe-AWS

Sebenzisa @aws-sdk/client-translate. Khetha i-OIDC nge-aws-actions/configure-aws-credentials ukuze kungabikho zimfihlo ezihlala isikhathi eside ezigcinwayo - isenzo sifunda uchungechunge lweziqinisekiso ezizenzakalelayo ze-AWS SDK. Ngenye indlela, dlulisa awsAccessKeyId bese awsSecretAccessKey ngokucacile. Isifunda ngaso sonke isikhathi siyadingeka, nge-awsRegion noma AWS_REGION imvelo eguquguqukayo.

Official AWS docs

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

I-OIDC (Kunconyiwe)

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

Ukusebenzisa okhiye be-static esikhundleni se-OIDC, yehlisa isinyathelo aws-actions/configure-aws-credentials bese udlulisa awsAccessKeyId / awsSecretAccessKey (nge-secrets) kanye ne-awsRegion.

Ukuhumusha kwe-Google Cloud

Sebenzisa @google-cloud/translate (v2). Qinisekisa ngokhiye we-API (googleApiKey) noma isitifiketi se-akhawunti yesevisi ye-JSON (googleCredentials). Nikeza eyodwa ngqo; I-googleProjectId yokuzikhethela ithathwa kusuka ku-credential uma ishiyiwe.

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

Imephu ye-Intent-specifier

Ama-specifiers aqondene nomhlinzeki akhiqizwa lapho kukhona khona okulingana nakho. Konke okunye kubuyela emuva kokuphazamiseka okunengqondo ukuze ukuziphatha kuhlala kungaguquguquki.

Amakhodi endawo ahlukile kumnikezeli ngamunye

Umhlinzeki ngamunye usebenzisa amakhodi akhe endawo (isibonelo isiShayina esenziwe lula zh-Hans ku-Azure, zh ku-AWS, ne-zh-CN ku-Google). Amakhodi adlula njengoba enjalo futhi ashayela amagama amafayela okukhiphayo, ngakho-ke khetha amanani toLocales umhlinzeki wakho okhethiwe asekela.