Орчуулгын үйлчилгээ үзүүлэгчид

Бүрэн буцаан нийцтэй: 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 Cloud орчуулга

Ашигладаг @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 утгыг сонгоорой.