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

    • Существующие настройки 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) с помощью режима пробного запуска.

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

      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 и укажите Pull request branch.

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

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

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

    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.