Интеграции
    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.

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

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

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

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

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

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

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

    GitHub (бета-версия)

    Примечание

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

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

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

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

    Экспорт

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

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

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

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

    Путь экспорта и подпапки

    Если значение поля «Путь экспорта файлов онлайн-репозитория» начинается с / (абсолютный путь), коннектор GitHub (бета-версия) сохраняет структуру подпапок исходных файлов. Каждый переведённый файл экспортируется в подпапку пути экспорта, соответствующую расположению исходного файла относительно папки, отслеживаемой автоматическим созданием проектов (APC).

    Файл, находящийся непосредственно в отслеживаемой папке, экспортируется непосредственно по пути экспорта. Подпапка не добавляется для относительного пути экспорта или если подпапки не включены.

    Абсолютный путь экспорта начинается от корня репозитория исходной ветки.

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

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

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

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

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

    Переключение на новый коннектор GitHub (бета-версия)

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

    Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

      4. Измените Тип на GitHub (бета-версия).

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

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

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

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

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

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

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

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

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

      4. Выберите приложение GitHub, установленное на первом шаге.

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

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

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

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

        • Режим экспорта: прямой коммит или запрос на включение (pull request), а также целевая ветка

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

        В рамках одной установки GitHub App можно создать несколько коннекторов с независимыми настройками для каждого.

    3. Воссоздайте существующие APC, используя режим пробного запуска.

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

      1. Создайте новые APC, настроенные на работу с новым коннектором, и перенесите в них настройки существующих APC.

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

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

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

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

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

      3. Проверьте:

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

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

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

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

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

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

      2. Включите APC на новом коннекторе (отключите режим пробного запуска).

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

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

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

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

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

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

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

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

    Настройки Prase TMS

    Важно

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

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

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

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

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

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

    4. В поле «Тип» выберите GitHub и укажите название коннектора.

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

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

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

      1. Перейдите по ссылке, чтобы открыть официальную страницу коннектора Phrase App в новой вкладке: 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. Нажмите кнопку «Авторизовать Phrase».

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

      В случае успеха окно/вкладка закроется, и рядом с кнопкой Подключиться к 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.