Интеграции
    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 (Beta) поддерживает только аутентификацию через GitHub App. Опция OAuth из исходного коннектора не поддерживается.

    Экспорт

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    5. При необходимости Выбрать Export translations as pull requests и укажите Pull request ветвь.

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

      1. Нажмите на ссылку, чтобы открыть официальную страницу Phrase коннектор в новой вкладка: https://github.com/apps/phrase-app-connector-eu (EU центр хранения и обработки данных) или https://github.com/apps/phrase-app-connector-us (US центр хранения и обработки данных).

      2. Установите Phrase GitHub app в перевод учетная запись GitHub.

        Примечание

        Если GitHub app не установлен в пользователь учетная запись GitHub, только общедоступные репозитории будут видны для коннектор GitHub.

      3. Завершить процедуру установки, выбрав любые частные репозитории, которые будут видны и доступны для коннектор GitHub.

      4. Вернитесь на страницу Phrase Connectors/Create, чтобы авторизовать GitHub app и подключиться к GitHub.

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

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

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

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

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