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

    Примечание

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

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

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

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

    Экспорт

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

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

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

    Сообщения коммитов генерируются автоматически и не могут быть настроены. Если экспортируется как запрос на извлечение, имя запроса на извлечение и имя целевой ветви могут быть настроены.

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

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

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

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

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

    Миграция на новый коннектор GitHub (Beta)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

        • Хранилище и ветвь

        • Путь к подпапке (если используется мониторинг подпапки)

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

        • Режим экспорта: прямое коммитирование или запрос на извлечение, и целевая ветвь

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

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

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

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

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

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

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

    4. Проверьте с помощью тестового экспорта.

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

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

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

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

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

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

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

      После успешной валидации:

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

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

      3. Наблюдайте за одним или двумя циклами экспорта перед выводом устаревшего коннектора из эксплуатации.

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

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

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

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

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

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

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

    Настройки Phrase TMS

    Важно

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

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

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

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

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

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

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

    5. При желании выберите Экспортировать переводы как запросы на извлечение и укажите Ветвь запроса на извлечение.

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

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

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

    8. Укажите Сообщение коммита, если это необходимо.

    9. Нажмите кнопку Авторизовать Phrase.

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

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

    10. Нажмите Сохранить.

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

      Важно

      Если коннектор 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.