Интеграции
    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 настроен на выгрузку файлов по мере их завершения, каждый файл будет зафиксирован (committed) отдельно, а не объединен в пакет.

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

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

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

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

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

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

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

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

    Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

      4. Измените Type на GitHub (Beta).

      5. Нажмите Connect.

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

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

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

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

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

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

      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 прокрутите вниз до раздела Интеграции.

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

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

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

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

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

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

    6. При необходимости выберите Экспортировать переводы как запросы на включение (pull requests) и укажите Ветку запроса на включение.

    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. Нажмите кнопку Авторизовать Phrase.

      Если вы используете приложение GitHub, нажмите кнопку Авторизовать Phrase App Connector.

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

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

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

      Важно

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

    Удаление коннектора

    Чтобы удалить коннектор:

    1. На странице Интеграции выберите коннектор, который нужно удалить.

    2. Нажмите Удалить.

      Откроется окно Удалить коннектор.

    3. Введите «delete» и нажмите Удалить.

      Коннектор удалён, и отображается список коннекторов.

    Примечание

    Коннектор нельзя удалить, пока он связан с незавершенными заданиями в проекте, включая задания, находящиеся в корзине. При попытке удалить такой коннектор возвращается ошибка «Не удалось удалить коннектор».

    Решение: Откройте проект, связанный с коннектором, и завершите или удалите все оставшиеся задания. Перейдите в Настройки/Корзина и очистите ее, чтобы удалить все задания, которые все еще связаны с коннектором. Повторите попытку удаления коннектора.

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

    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.