Аударма провайдерлері

Толығымен артқа үйлесімді: provider әдепкі azure-ге орнатылады, сондықтан қолданыстағы Azure жұмыс процестері өзгеріссіз жұмыс істейді — түзетулер қажет емес.

Провайдерді таңдау

provider кірісін azure (әдепкі), aws немесе google-ге қойып, сол провайдердің тіркеу деректерін енгізіңіз. Әр әрекет шақыруында тек бір провайдер қолданылады; әрекет сәйкес SDK-ны зауыттың артында детерминистік түрде береді.

Провайдерлерді салыстыру

Azure AI Translator (default)

Әдепкі провайдер. Azure 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 Translate

Пайдаланады @aws-sdk/client-translate. OIDC-ді aws-actions/configure-aws-credentials арқылы қалаймын, сонда ұзақ мерзімді құпиялар сақталмайды — әрекет 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 Бұлттық аудармасы

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

Мақсат-спецификаторды бейнелеу

Провайдерге тән спецификаторлар эквиваленті бар жерде сәйкестендіріледі. Қалғаны бәрі ақылға қонымды әдепкі режимдерге оралады, сондықтан мінез-құлық тұрақты болады.

Жергілікті кодтар әр провайдерге байланысты әртүрлі

Әр провайдер өз жергілікті кодтарын қолданады (мысалы, Simplified Chinese Azure-де zh-Hans, AWS-те zh, Google-да zh-CN). Кодтар сол күйінде өтеді және шығыс файл атауларын басқарады, сондықтан таңдаған провайдеріңіз қолдайтын toLocales мәндерді таңдаңыз.