Интеграции
    1. Phrase
    2. Phrase TMS
    3. Интеграции

    GitHub (TMS)

    Контент автоматически переведен с английского языка с помощью Phrase Language AI.

    Доступно для

    • Планы Team, Business и Enterprise

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Доступно для

    • Планы Ultimate и Enterprise (устаревшие)

    Свяжитесь с отделом продаж по вопросам лицензирования.

    Рекомендации

    Для получения информации об интеграции GitHub в Phrase Strings обратитесь к разделу GitHub (Strings).

    Коннектор GitHub позволяет загружать исходные файлы и выгружать целевые файлы непосредственно в репозиторий GitHub или из него.

    Для реализации интеграции коннектор использует API GitHub. Коннектор предоставляет доступ ко всем репозиториям, связанным с учетной записью GitHub. Аутентификацию учетной записи GitHub также можно выполнить в GitHub App.

    Варианты использования

    Существует ряд вариантов использования коннектора:

    • Менеджеры проектов могут добавлять файлы непосредственно в проекты из онлайн-репозитория.

    • Настройте портал отправителя, чтобы позволить отправителям добавлять файлы к запросам непосредственно из онлайн-репозитория.

    • Используйте службу автоматического создания проектов (APC) для автоматического создания новых проектов при обнаружении изменений в размере файла в отслеживаемых файлах или папках.

      • Этот коннектор поддерживает настройку абсолютного пути. Целевые файлы перевода могут храниться только в той же ветке, что и исходный файл.

    • Настройте непрерывные задания для отслеживания изменений в выбранных файлах.

    GitHub (Бета)

    Примечание

    По состоянию на июнь 2026 года коннектор находится в бета-версии.

    Аутентификация

    Коннектор GitHub (бета-версия) использует токен установки приложения GitHub, а не учетную запись отдельного пользователя. Токены недолговечны и обновляются автоматически. Если пользователь покидает организацию или теряет доступ к репозиторию, коннектор продолжает работать.

    Коннектор GitHub (бета-версия) поддерживает только аутентификацию через приложение GitHub. Вариант OAuth из исходного коннектора не поддерживается.

    Экспортировать

    Коннектор GitHub (бета-версия) объединяет все файлы из одного экспорта в один коммит и один запрос на включение (pull request), поэтому CI запускается один раз для каждого экспорта независимо от количества файлов.

    Файлы объединяются в один коммит, если весь контент имеет одного и того же владельца репозитория, репозиторий и ветку.

    Если APC настроен на выгрузку файлов по мере их завершения, каждый файл будет зафиксирован отдельно, а не объединен в один пакет.

    Сообщения коммитов генерируются автоматически и не могут быть изменены. При экспорте в виде запроса на включение (pull request) название запроса и название целевой ветки можно настроить.

    Известные ограничения

    • Коннектор может только перечислять, скачивать и загружать файлы. Удаление или перемещение файлов в GitHub не поддерживается. Любые удаления или переименования должны выполняться непосредственно в GitHub.

    • Список файлов может отображаться некорректно для репозиториев с более чем 50 000 файлов из-за ограничений API GitHub.

    • GitHub Enterprise Server в настоящее время не поддерживается.

    • Новый коннектор не поддерживает поток OAuth из устаревшего коннектора. Если в вашей организации действуют ограничения на установку приложений GitHub, устраните их перед миграцией.

    Переход на новый коннектор GitHub (бета-версия)

    Автоматизированная миграция невозможна из-за изменения модели аутентификации.

    Примечание

    Переключение непрерывного APC с устаревшего коннектора на новый не является миграцией. Phrase рассматривает это как новую конфигурацию коннектора, поэтому APC повторно импортирует исходный файл как новое задание вместо обновления существующего. Файл рассматривается как новый контент, поэтому ранее обработанные слова и единицы машинного перевода (MTU) не переносятся. При переключении коннекторов в середине проекта ожидайте, что количество слов и потребление MTU/кредитов для затронутых файлов будут отражать полный повторный импорт.

    Предварительные требования:

    • Доступ администратора к вашей организации GitHub для установки приложения GitHub App. Установите его на уровне организации, чтобы он охватывал все репозитории, отслеживаемые вашими APC.

    • Установка приложения GitHub App должна иметь доступ к репозиториям с контентом для перевода, в противном случае импорт через APC завершится ошибкой.

    • Существующие настройки APC видны (оставьте старый коннектор открытым во второй вкладке).

    • Тестовая ветка или непроизводственный репозиторий для проверки перед переходом к рабочим процессам в продакшене.

    Выполните следующие действия:

    1. Установите приложение Phrase GitHub

      1. В Phrase TMS на странице Setup_gear.png «Настройки» прокрутите вниз до раздела Интеграции.

      2. Нажмите на «Коннекторы».

        Откроется страница коннекторов.

      3. Нажмите «Новый коннектор».

        Откроется страница «Создать коннектор».

      4. Измените Тип на GitHub (бета).

      5. Нажмите Подключить.

        Phrase перенаправит вас на GitHub для авторизации приложения Phrase GitHub App.

      6. На GitHub выберите организацию или учетную запись и репозитории, к которым нужно предоставить доступ, а затем подтвердите установку. Включите все репозитории, которые в настоящее время отслеживаются существующим(-и) коннектором(-ами).

        GitHub автоматически перенаправляет вас в Phrase.

      7. Выберите учетную запись пользователя или организации для подключения.

    2. Создайте новый коннектор.

      1. В Phrase TMS на странице Setup_gear.png «Настройки» прокрутите вниз до раздела Интеграции.

      2. Нажмите на «Коннекторы».

      3. Нажмите «Новый коннектор».

      4. Выберите установку GitHub App, настроенную на первом этапе.

      5. Скопируйте настройки из существующего коннектора:

        • Репозиторий и ветка

        • Путь к подпапке (если используется отслеживание подпапок)

        • Регулярное выражение фильтра файлов (если настроено)

        • Режим экспорта: прямой коммит или pull request, а также целевая ветка

        • Название запроса на включение (pull request) и название целевой ветки (при использовании режима PR)

        Можно создать несколько коннекторов в рамках одной установки GitHub App, каждый из которых будет иметь независимые настройки.

    3. Воссоздайте существующие APC, используя режим dry-run.

      Пока не удаляйте и не отключайте существующие APC.

      1. Создайте новые APC, указывающие на новый коннектор, дублируя конфигурацию существующих APC.

      2. Включите режим dry-run на каждом новом APC перед его активацией. Режим dry-run сканирует репозиторий и сопоставляет файлы, не запуская задания на перевод.

      3. Проверьте сопоставленные файлы. Убедитесь, что область действия совпадает с той, которую отслеживают существующие APC.

    4. Выполните проверку с помощью тестового экспорта.

      1. Внесите небольшое изменение в файл в отслеживаемой области.

      2. Запустите экспорт через новый коннектор.

      3. Подтвердить

        • Создается один коммит (а не по одному на каждый файл).

        • Коммит отображается от имени GitHub App, а не от личной учетной записи.

        • CI запускается один раз, а не по одному разу для каждого файла.

    5. Переключите рабочие процессы в активный режим.

      После успешной проверки:

      1. Отключите APC на устаревшем коннекторе.

      2. Включите APC на новом коннекторе (отключите режим dry-run).

      3. Отслеживайте работу в течение одного-двух циклов экспорта перед выводом устаревшего коннектора из эксплуатации.

    6. Выведите из эксплуатации устаревший коннектор.

      После подтверждения стабильной работы нового коннектора:

      1. Удалите старые APC.

      2. Удалите устаревший коннектор в разделе «Настройки» → «Коннекторы» → «GitHub (устаревший)».

      3. При необходимости отзовите OAuth-токен для учетной записи пользователя, которая использовалась устаревшим коннектором.

    Настройки GitHub (устаревшие)

    Изменения не требуются.

    Настройки Prase TMS

    Важно

    При доступе с пользовательского домена (например, mydomain.phrase.jp) откройте окно браузера в режиме инкогнито и выполните вход через cloud.memsource.com или us.cloud.memsource.com, чтобы применить аутентификацию, необходимую для создания или сохранения коннектора. После сохранения коннектор будет доступен через пользовательский домен.

    1. Со страницы Setup_gear.png прокрутите вниз до раздела Integrations.

    2. Нажмите на «Коннекторы».

      Откроется страница коннекторов.

    3. Нажмите «Новый коннектор».

      Откроется страница «Создать коннектор».

    4. Измените Тип на GitHub и укажите имя для коннектора.

    5. При необходимости включите Использовать пользовательский домен и укажите URL API.

    6. При необходимости выберите Экспортировать переводы как pull-запросы и укажите Ветку pull-запроса.

    7. При необходимости выберите Использовать приложение GitHub, чтобы отобразить URL-адрес приложения Phrase GitHub и импортировать/экспортировать файлы с помощью процесса авторизации приложения GitHub:

      1. Нажмите на ссылку, чтобы открыть официальную страницу Phrase App Connector в новой вкладке: https://github.com/apps/phrase-app-connector-eu (центр обработки данных в ЕС) или https://github.com/apps/phrase-app-connector-us (центр обработки данных в США).

      2. Установите приложение Phrase GitHub для целевой учетной записи GitHub.

        Примечание

        Если приложение GitHub не установлено для целевой учетной записи GitHub пользователя, коннектору GitHub будут видны только общедоступные репозитории.

      3. Завершите процедуру установки, выбрав любые частные репозитории, которые будут видны и доступны для коннектора GitHub.

      4. Вернитесь на страницу Коннекторы/Создать в Phrase, чтобы авторизовать приложение GitHub и подключиться к GitHub.

    8. Нажмите Подключиться к GitHub. Если подключение выполняется не через приложение GitHub, появится всплывающее окно или новая вкладка с запросом авторизации.

    9. Укажите сообщение коммита, если это требуется.

    10. Нажмите кнопку Authorize Phrase.

      При использовании приложения GitHub нажмите кнопку Authorize Phrase App Connector.

      В случае успеха окно/вкладка исчезнет, и рядом с кнопкой Connect to GitHub появится небольшая галочка.

    11. Нажмите «Сохранить».

      Коннектор добавлен в список на странице «Коннекторы».

      Важно

      Если коннектор GitHub создан с использованием процесса авторизации приложения GitHub, изменить метод авторизации после сохранения настроек коннектора невозможно.

    Была ли эта статья полезной?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.