Котормо провайдерлери

Толук артка шайкеш: provider демейки azure режиминде иштейт, ошондуктан Azure иш агымдары өзгөрүүсүз иштейт — түзөтүү талап кылынбайт.

Провайдерди тандоо

provider киргизүүнү azure (демейки), aws же google кылып коюп, ошол провайдердин идентификациялык маалыматтарын бериңиз. Ар бир аракет чакыруу үчүн бир гана провайдер колдонулат; аракет детерминисттик түрдө заводдун артындагы дал келген SDKга делегат берет.

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

Azure AI Translator (default)

Демейки провайдер. Azure AI Translator ресурсун камсыздап, 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"]'

Максат-спецификаторду чагылдыруу

Провайдерге тиешелүү спецификаторлор эквивалент бар жерде картага түшүрүлөт. Калган нерселер акылга сыярлык демейки режимдерге кайтып келет, ошондуктан жүрүм-турум туруктуу бойдон калат.

Жергиликтүү коддор ар бир провайдерге жараша айырмаланат

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