통합
    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 앱에서도 수행할 수 있습니다.

    사용 사례

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

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

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

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

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

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

    GitHub (베타)

    참고

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

    인증

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

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

    내보내기

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

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

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

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

    알려진 제한 사항

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

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

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

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

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

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

    참고

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

    필수 조건:

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

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

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

    • 라이브 워크플로를 전환하기 전에 유효성을 검사할 테스트 분기 또는 비프로덕션 리포지토리.

    다음 단계를 따르십시오:

    1. Phrase GitHub App을 설치하십시오.

      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 App 설치 하에 각각 독립적인 설정을 가진 여러 커넥터를 생성할 수 있습니다.

    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. 필요한 경우 Use Github app을 선택하여 Phrase GitHub 앱 URL을 표시하고 GitHub 앱 인증 흐름을 사용하여 파일을 가져오기/내보내기합니다:

      1. 링크를 클릭하여 새 탭에서 Phrase 커넥터 공식 페이지를 엽니다: 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 앱 인증 흐름을 사용하여 커넥터를 생성한 경우, 커넥터 설정을 저장한 후에는 인증 방법을 변경할 수 없습니다.

    커넥터 삭제

    커넥터를 삭제하려면:

    1. Integrations 페이지에서 삭제할 커넥터를 선택합니다.

    2. Delete을 클릭합니다.

      Delete connector 창이 열립니다.

    3. "delete"를 입력하고 Delete을 클릭합니다.

      커넥터가 삭제되고 커넥터 목록이 표시됩니다.

    참고

    커넥터가 프로젝트 내의 완료되지 않은 작업(휴지통에 있는 작업 포함)에 연결되어 있는 동안에는 삭제할 수 없습니다. 해당 커넥터를 삭제하려고 하면 "커넥터 삭제 실패" 오류가 반환됩니다.

    해결 방법: 커넥터와 연결된 프로젝트를 열고 남아 있는 작업을 완료하거나 삭제하십시오. 설정/휴지통으로 이동하여 비어 있음 상태로 만들어 커넥터에 여전히 연결된 작업을 제거하십시오. 커넥터 삭제를 다시 시도하십시오.

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

    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.