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

    GitHub (TMS)

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

    사용 가능:

    • Team, Business 및 Enterprise 요금제

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

    사용 가능:

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

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

    팁

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

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

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

    사용 사례

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

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

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

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

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

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

    GitHub (베타)

    참고

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

    인증

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

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

    내보내기

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

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

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

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

    내보내기 경로 및 하위 폴더

    온라인 리포지토리 파일 내보내기 경로가 /(절대 경로)로 시작하는 경우, GitHub (베타) 커넥터는 소스 파일의 하위 폴더 구조를 유지합니다. 번역된 각 파일은 자동 프로젝트 생성(APC)이 모니터링하는 폴더를 기준으로 소스 파일과 동일한 하위 폴더 구조를 유지하여 내보내기 경로 아래로 내보내집니다.

    모니터링되는 폴더에 직접 있는 파일은 내보내기 경로로 직접 내보내집니다. 상대 내보내기 경로의 경우 또는 하위 폴더가 포함되지 않은 경우에는 하위 폴더가 추가되지 않습니다.

    절대 내보내기 경로는 소스 브랜치의 리포지토리 루트에서 시작합니다.

    알려진 제한 사항

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

    • GitHub API 제한으로 인해 50,000개 이상의 파일이 있는 리포지토리의 경우 파일 나열이 올바르게 작동하지 않을 수 있습니다.

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

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

    새 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 (Beta)로 변경하십시오.

      5. 연결을 클릭하십시오.

        Phrase GitHub 앱을 승인할 수 있도록 GitHub로 리디렉션됩니다.

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

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

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

    2. 새 커넥터를 생성하십시오.

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

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

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

      4. 첫 번째 단계에서 설정한 GitHub 앱 설치 항목을 선택하십시오.

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

        • 리포지토리 및 브랜치

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

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

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

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

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

    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. Type을 GitHub로 변경하고 커넥터 이름을 입력하십시오.

    5. 선택적으로 Use custom domain을 활성화하고 API URL을 입력하십시오.

    6. 선택적으로 Export translations as pull requests를 선택하고 Pull request branch를 입력하십시오.

    7. 필요한 경우 Use Github app을 선택하여 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 커넥터를 생성한 경우, 커넥터 설정을 저장한 후에는 인증 방법을 변경할 수 없습니다.

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

    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.