Step 1: Выберите поставщика перевода
Действие работает с Azure AI Translator, AWS Translate и Google Cloud Translation за единой поверхностью API. Выбирайте одного провайдера на каждый запуск с входом provider — рабочий процесс ведёт себя одинаково независимо от провайдера; Различаются только квалификации. Смотрите Поставщики переводов для полного сравнения.
Step 2: Добавьте учетные данные и рабочий процесс
Храните учетные данные вашего провайдера в виде секретов репозитория GitHub, затем создайте .github/workflows/translate.yml. Выберите вашего провайдера ниже для его конкретной настройки — остальная часть рабочего процесса идентична.
Azure AI Translator
Azure является провайдером по умолчанию, поэтому provider может быть опущен. Обеспечьте ресурс Azure AI Translator в портале Azure, затем храните его учетные данные:
Храните их как секреты хранилища
TRANSLATOR_KEY— Ключ подписки на ресурс.TRANSLATOR_ENDPOINT— региональный адрес конечной точки.TRANSLATOR_REGION— Azure регион ресурса.
Добавьте рабочий процесс
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
permissions: contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - id: translate uses: IEvangelist/resource-translator@v3 with: provider: | azure: subscriptionKey: ${{ secrets.TRANSLATOR_KEY }} endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }} region: ${{ secrets.TRANSLATOR_REGION }} sourceLocale: en toLocales: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationAWS Translate
Установите provider на aws. Предпочитайте OIDC через aws-actions/configure-aws-credentials, чтобы не хранились долговременные секреты — этот этап экспорта AWS_REGION для вас. Чтобы использовать статические ключи, сохраните:
Храните их как секреты хранилища
AWS_ACCESS_KEY_ID— ваш AWS key access ID.AWS_SECRET_ACCESS_KEY— ваш секретный ключ доступа AWS.
Регион всегда необходим — задайте его awsRegion или переменной AWS_REGION среды.
Добавьте рабочий процесс
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
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: translate 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: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationGoogle Cloud Translation
Установите provider на google. Аутентификация либо с помощью JSON-учетной записи сервиса, либо API-ключа — предоставьте ровно один:
Храните их как секреты хранилища
GCP_TRANSLATE_CREDENTIALS— JSON-ключ для сервисной учетной записи (в виде строки JSON).GCP_TRANSLATE_API_KEY— или ключ Google Cloud API.
Необязательный googleProjectId выводится из удостоверения квалификации, если его опускать.
Добавьте рабочий процесс
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
permissions: contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - id: translate 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: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationStep 3: Зафиксировать файл исходного ресурса
Файлы ресурсов используют конвенцию Name.<sourceLocale>.<ext>. Например, Greetings.en.resx становится Greetings.fr.resx, Greetings.de.resx и так далее после забега.
Step 4: Let smart change detection protect your bill
changeDetection defaults to smart and stores a compact .github/resource-translator-state.json manifest in the repo. Commit that file so future runs can reuse stable translations, preserve manual target edits, and send only new, missing, changed, or settings-invalidated keys to the provider. If localized files already exist, run once with snapshotOnly: true to create the manifest without provider calls.
Step 5: Проверьте выход
После завершения рабочего процесса действие открывает три выхода, которые можно подключить к описанию PR: summary-title, summary-details и has-new-translations. Также на странице вакансии через core.summary записывается краткое описание Markdown.