Интеграции
    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 App. Опция OAuth из оригинального коннектора не поддерживается.

    Экспорт

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

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

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

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

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

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

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

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

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

    Переключение на новый коннектор 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, а также перевод ветвь

        • Имя 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 на новом коннектор (удалить режим пробного запуска).

      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. Изменить Type на GitHub и укажите имя для коннектор.

    5. При необходимости Включить Use custom domain и укажите интерфейс приложений API URL.

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

    7. При необходимости Выбрать Use Github app, чтобы отобразить 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 Connectors/Create, чтобы авторизовать приложение GitHub и подключиться к GitHub.

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

    9. Укажите Commit message, если это требуется.

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

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

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

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

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

      Важно

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

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

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

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

    2. Нажмите Delete.

      Откроется окно Delete connector.

    3. Введите \"delete\" и нажмите Delete.

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

    Примечание

    Коннектор нельзя удалить, пока он связан с незавершенными заданиями в проекте, включая задания, находящиеся в корзине. При попытке удалить такой коннектор возвращается ошибка \"Failed to delete connector\".

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

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

    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.