అనువాద ప్రొవైడర్లు

పూర్తిగా బ్యాక్ వర్డ్ కంపాటిబుల్: azure కు provider డిఫాల్ట్ అవుతుంది, కాబట్టి ఇప్పటికే ఉన్న Azure వర్క్ ఫ్లోలు మారకుండా పనిచేస్తాయి - సవరణలు అవసరం లేదు.

ప్రొవైడర్ ను ఎంచుకోవడం

provider ఇన్ పుట్ ను azure (డిఫాల్ట్), aws లేదా google కు సెట్ చేసి, ఆపై ఆ ప్రొవైడర్ యొక్క ఆధారాలను అందించండి. ప్రతి చర్య కాల్ కు ఒక ప్రొవైడర్ మాత్రమే ఉపయోగించబడుతుంది; చర్య ఒక కర్మాగారం వెనుక సరిపోలే SDK కి నిర్ణయాత్మకంగా ప్రతిబింబిస్తుంది.

ప్రొవైడర్ పోలిక

Azure AI Translator (డిఫాల్ట్)

డిఫాల్ట్ ప్రొవైడర్. అజ్యూరే AI ట్రాన్స్ లేటర్ రిసోర్స్ ని అందించండి మరియు subscriptionKey, endpoint, మరియు ఐచ్ఛికంగా region పాస్ చేయండి. ఇప్పటికే ఉన్న వర్క్ ఫ్లోలు ఉపయోగించే అదే కాన్ఫిగరేషన్ ఇది.

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 అనువాదం

@aws-sdk/client-translate ఉపయోగిస్తుంది. aws-actions/configure-aws-credentials ద్వారా OIDC కి ప్రాధాన్యత ఇవ్వండి, కాబట్టి దీర్ఘకాల రహస్యాలు నిల్వ చేయబడవు - చర్య AWS SDK డిఫాల్ట్ క్రెడెన్షియల్ గొలుసును చదువుతుంది. ప్రత్యామ్నాయంగా, awsAccessKeyId పాస్ చేయండి మరియు awsSecretAccessKey స్పష్టంగా చేయండి. ఒక ప్రాంతం ఎల్లప్పుడూ awsRegion లేదా AWS_REGION పర్యావరణ వేరియబుల్ ద్వారా అవసరం అవుతుంది.

Official AWS docs

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

OIDC (సిఫార్సు చేయబడింది)

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కి బదులుగా స్టాటిక్ కీలను ఉపయోగించడానికి, aws-actions/configure-aws-credentials దశను డ్రాప్ చేయండి మరియు awsAccessKeyId / awsSecretAccessKey (secrets ద్వారా) ప్లస్ awsRegion పాస్ చేయండి.

గూగుల్ క్లౌడ్ అనువాదం

@google-cloud/translate (v2) ను ఉపయోగిస్తుంది. API కీ (googleApiKey) లేదా సేవ-ఖాతా JSON ఆధారాలు (googleCredentials) తో ప్రమాణీకరించండి. సరిగ్గా ఒకటి సరఫరా చేయండి; మినహాయించబడినప్పుడు క్రెడెన్షియల్ నుండి ఐచ్ఛిక googleProjectId ఊహించబడుతుంది.

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

ఉద్దేశ్యం-స్పెసిఫైయర్ మ్యాపింగ్

ప్రొవైడర్-నిర్దిష్ట స్పెసిఫైయర్లు సమానమైన చోట మ్యాప్ చేయబడతాయి. మిగతా ప్రతిదీ తెలివైన డిఫాల్ట్ లకు తిరిగి వస్తుంది కాబట్టి ప్రవర్తన స్థిరంగా ఉంటుంది.

ప్రతి ప్రొవైడర్ కు లోకల్ కోడ్ లు విభిన్నంగా ఉంటాయి

ప్రతి ప్రొవైడర్ కూడా దాని స్వంత లోకల్ కోడ్ లను ఉపయోగిస్తుంది (ఉదాహరణకు సింప్లిఫైడ్ చైనీస్ అజ్యూర్ పై zh-Hans, AWS పై zh, మరియు గూగుల్ పై zh-CN). కోడ్ లు అలానే వెళతాయి మరియు అవుట్ పుట్ ఫైల్ పేర్లను డ్రైవ్ చేస్తాయి, కాబట్టి మీరు ఎంచుకున్న ప్రొవైడర్ మద్దతు toLocales విలువలను ఎంచుకోండి.