통합
    1. Phrase
    2. Phrase TMS
    3. 통합

    GitHub (TMS)

    컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

    사용 가능:

    • Team, Business 및 Enterprise 요금제

    라이센스 질문은 영업팀에 문의하십시오.

    사용 가능:

    • Ultimate 및 Enterprise 요금제 (레거시)

    라이센스 질문은 영업팀에 문의하십시오.

    팁

    Phrase Strings의 GitHub 통합에 대한 자세한 내용은 GitHub (Strings)을 참조하십시오.

    GitHub 커넥터를 사용하면 GitHub 리포지토리에서 직접 소스 파일을 다운로드하고 대상 파일을 업로드할 수 있습니다.

    이 커넥터는 GitHub API를 사용하여 통합을 구현합니다. 이 커넥터를 사용하면 GitHub 계정과 연결된 모든 리포지토리에 액세스할 수 있습니다. GitHub 계정 인증은 GitHub 앱에서도 수행할 수 있습니다.

    사용 사례

    커넥터 여러 사용 사례가 있습니다.

    • 프로젝트 관리자는 온라인 리포지토리에서 프로젝트에 직접 파일을 추가할 수 있습니다.

    • 제출자 포털을 설정하여 제출자가 온라인 리포지토리에서 직접 요청에 파일을 추가할 수 있도록 하십시오.

    • 모니터링되는 파일 또는 폴더에서 파일 크기 변경이 감지되면 자동 프로젝트 생성(APC)을 사용하여 새 프로젝트가 자동으로 생성되도록 하십시오.

      • 이 커넥터는 절대 경로 설정을 지원합니다. 대상 번역 파일은 소스 파일과 동일한 브랜치에만 저장할 수 있습니다.

    • 연속 작업을 설정하여 선택한 파일의 변경 사항을 모니터링하십시오.

    GitHub(베타)

    참고

    이 커넥터는 2026년 6월 기준으로 베타 버전입니다.

    인증

    GitHub (베타) 커넥터는 개별 사용자 계정 대신 GitHub 앱 설치 토큰을 사용합니다. 토큰은 수명이 짧으며 자동으로 갱신됩니다. 사용자가 조직을 떠나거나 리포지토리 액세스 권한을 잃더라도 커넥터는 계속 작동합니다.

    GitHub (베타) 커넥터는 GitHub 앱 인증만 지원합니다. 기존 커넥터의 OAuth 옵션은 지원되지 않습니다.

    내보내기

    GitHub (베타) 커넥터는 단일 내보내기의 모든 파일을 하나의 커밋과 하나의 풀 리퀘스트로 일괄 처리하므로, 파일 수와 관계없이 내보내기당 CI가 한 번 실행됩니다.

    모든 콘텐츠가 동일한 리포지토리 소유자, 리포지토리 및 브랜치를 공유하는 경우 파일이 단일 커밋으로 일괄 처리됩니다.

    APC가 파일이 개별적으로 완료될 때마다 업로드하도록 구성된 경우, 각 파일은 일괄 처리되지 않고 별도로 커밋됩니다.

    커밋 메시지는 자동으로 생성되며 사용자 지정할 수 없습니다. 풀 리퀘스트로 내보내는 경우, 풀 리퀘스트 이름과 대상 브랜치 이름을 사용자 지정할 수 있습니다.

    알려진 제한 사항

    • 이 커넥터는 파일 나열, 다운로드 및 업로드만 가능합니다. GitHub에서는 파일 삭제 또는 이동이 지원되지 않습니다. 모든 삭제 또는 이름 변경은 GitHub에서 직접 수행해야 합니다.

    • GitHub API 제한으로 인해 50,000개 이상의 파일이 있는 리포지토리에서는 파일 목록 표시가 제대로 작동하지 않을 수 있습니다.

    • 현재 GitHub Enterprise Server는 지원되지 않습니다.

    • 새 커넥터는 레거시 커넥터의 OAuth 흐름을 지원하지 않습니다. 조직에 GitHub 앱 설치에 대한 제한이 있는 경우, 마이그레이션 전에 해당 문제를 해결하십시오.

    새 GitHub (베타) 커넥터로 전환하기

    인증 모델 변경으로 인해 자동화된 마이그레이션은 불가능합니다.

    참고

    연속 APC를 레거시 커넥터에서 새 커넥터로 전환하는 것은 마이그레이션이 아닙니다. Phrase는 이를 새로운 커넥터 구성으로 취급하므로, APC는 기존 작업을 업데이트하는 대신 소스 파일을 새 작업으로 다시 가져옵니다. 파일이 새로운 콘텐츠로 취급되므로 이전에 처리된 단어와 기계 번역 단위(MTU)는 이전되지 않습니다. 프로젝트 중간에 커넥터를 전환하면 영향을 받는 파일에 대한 단어 수와 MTU/크레딧 사용량이 전체 재가져오기를 반영하게 됩니다.

    전제 조건:

    • GitHub App을 설치하기 위한 귀하의 GitHub 조직에 대한 관리자 액세스 권한. 모든 APC 모니터링 리포지토리를 포함하도록 조직 수준에서 설치하십시오.

    • GitHub App 설치는 번역할 콘텐츠가 있는 리포지토리에 액세스할 수 있어야 합니다. 그렇지 않으면 APC를 통한 가져오기가 실패합니다.

    • 기존 APC 설정이 표시됩니다(이전 커넥터를 두 번째 탭에 열어 두십시오).

    • 실시간 워크플로를 전환하기 전에 검증할 테스트 브랜치 또는 비운영 리포지토리.

    다음 단계를 따르십시오:

    1. Phrase GitHub 앱 설치

      1. Phrase TMS의 설정 Setup_gear.png 페이지에서 통합 섹션으로 스크롤하십시오.

      2. 커넥터을 클릭합니다.

        커넥터 페이지가 열립니다.

      3. 새 커넥터를 클릭하십시오.

        커넥터 만들기 페이지가 열립니다.

      4. 유형을(를) GitHub (Beta)(으)로 변경하십시오.

      5. 연결을(를) 클릭하십시오.

        Phrase가 GitHub로 리디렉션되어 Phrase GitHub App을 승인합니다.

      6. GitHub에서 액세스 권한을 부여할 조직 또는 계정과 리포지토리를 선택한 다음 설치를 확인하십시오. 기존 커넥터가 현재 모니터링하는 모든 리포지토리를 포함하십시오.

        GitHub가 자동으로 Phrase로 리디렉션합니다.

      7. 연결할 사용자 또는 조직 계정을 선택하십시오.

    2. 새 커넥터를 만드십시오.

      1. Phrase TMS의 설정 Setup_gear.png 페이지에서 통합 섹션으로 스크롤하십시오.

      2. 커넥터을 클릭합니다.

      3. 새 커넥터를 클릭하십시오.

      4. 첫 번째 단계에서 설정한 GitHub App 설치를 선택하십시오.

      5. 기존 커넥터에서 설정을 복사하십시오:

        • 리포지토리 및 브랜치

        • 하위 폴더 경로 (하위 폴더 모니터링을 사용하는 경우)

        • 파일 필터 정규식 (구성된 경우)

        • 내보내기 모드: 직접 커밋 또는 풀 리퀘스트, 그리고 대상 브랜치

        • 풀 리퀘스트 이름 및 대상 브랜치 이름 (PR 모드를 사용하는 경우)

        동일한 GitHub 앱 설치 하에 각각 독립적인 설정을 가진 여러 커넥터를 생성할 수 있습니다.

    3. 드라이런 모드를 사용하여 기존 APC를 다시 생성하십시오.

      기존 APC를 아직 삭제하거나 비활성화하지 마십시오.

      1. 기존 APC 구성을 미러링하여 새 커넥터를 가리키는 새 APC를 생성하십시오.

      2. 활성화하기 전에 각 새 APC에서 드라이런 모드를 활성화하십시오. 드라이런 모드는 저장소를 스캔하고 번역 작업을 트리거하지 않고 파일을 일치시킵니다.

      3. 일치하는 파일을 검토하십시오. 범위가 기존 APC가 모니터링하는 것과 일치하는지 확인하십시오.

    4. 테스트 내보내기로 유효성을 검사하십시오.

      1. 모니터링되는 범위 내의 파일에 작은 변경을 가하십시오.

      2. 새 커넥터를 통해 내보내기를 트리거하십시오.

      3. 확인

        • 단일 커밋이 생성됩니다 (파일당 하나가 아님).

        • 커밋은 개인 계정이 아닌 GitHub 앱 ID로 나타납니다.

        • 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. 선택적으로 사용자 지정 도메인 사용을 활성화하고 API URL을 입력하십시오.

    6. 선택적으로 번역을 풀 리퀘스트로 내보내기를 선택하고 풀 리퀘스트 브랜치를 입력하십시오.

    7. 필요한 경우 GitHub 앱 사용을 선택하여 Phrase GitHub 앱 URL을 표시하고 GitHub 앱 인증 흐름을 사용하여 파일을 가져오거나 내보내십시오:

      1. 링크를 클릭하여 새 탭에서 Phrase App Connector 공식 페이지를 여십시오: https://github.com/apps/phrase-app-connector-eu(EU 데이터 센터) 또는 https://github.com/apps/phrase-app-connector-us(US 데이터 센터).

      2. 대상 GitHub 계정에 Phrase 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" 오류가 반환됩니다.

    해결 방법: 커넥터와 연결된 프로젝트를 열고 남아 있는 작업을 완료하거나 삭제하십시오. Settings/Recycle bin으로 이동하여 비워 커넥터에 여전히 연결된 작업을 제거하십시오. 커넥터 삭제를 다시 시도하십시오.

    도움이 되었습니까?
    ★ ★ ★ ★ ★

    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.