통합
    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 App에서도 가능합니다.

    사용 사례

    커넥터에는 여러 사용 사례가 있습니다:

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

    • 제출자가 온라인 리포지토리에서 요청에 파일을 직접 추가할 수 있도록 제출자 포털을 설정합니다.

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

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

    • 선택한 파일의 변경 사항을 모니터링하기 위해 지속적인 작업을 설정합니다.

    GitHub (Beta)

    참고

    커넥터는 2026년 6월 현재 베타 상태입니다.

    인증

    GitHub (베타) 커넥터는 개별 사용자 계정 대신 GitHub 앱 설치 토큰을 사용합니다. 토큰은 단기간 사용 가능하며 자동으로 갱신됩니다. 사용자가 조직을 떠나거나 리포지토리 액세스를 잃어도 커넥터는 계속 작동합니다.

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

    내보내기

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

    모든 콘텐츠가 동일한 리포지토리 소유자, 리포지토리 및 분기를 공유할 때 파일이 단일 커밋으로 배치됩니다.

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

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

    알려진 제한 사항

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

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

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

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

    새 GitHub (베타) 커넥터로의 마이그레이션

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

    필수 조건:

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

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

    • 실제 워크플로우를 전환하기 전에 검증할 테스트 분기 또는 비생산 리포지토리입니다.

    다음 단계를 따르십시오:

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

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

      2. 커넥터를 클릭하십시오.

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

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

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

      4. 유형을 GitHub (베타)로 변경하십시오.

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

        Phrase는 Phrase GitHub 앱을 승인하기 위해 GitHub로 리디렉션됩니다.

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

        GitHub는 자동으로 Phrase로 리디렉션됩니다.

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

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

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

      2. 커넥터를 클릭하십시오.

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

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

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

        • 리포지토리 및 분기

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

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

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

        • 풀 리퀘스트 이름 및 대상 분기 이름(풀 리퀘스트 모드를 사용하는 경우)

        동일한 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. 유형을 GitHub로 변경하고 커넥터의 이름을 제공하십시오.

    5. 선택적으로 번역을 풀 요청으로 내보내기를 선택하고 풀 요청 분기를 제공하십시오.

    6. 필요한 경우, 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 커넥터/생성 페이지로 돌아가 GitHub 앱을 인증하고 GitHub에 연결하십시오.

    7. GitHub에 연결을 클릭하십시오. GitHub 앱을 사용하여 연결되지 않은 경우, 인증을 요청하는 팝업 창이나 새 탭이 나타납니다.

    8. 필요한 경우 커밋 메시지를 제공하십시오.

    9. Phrase 승인 버튼을 클릭하십시오.

      GitHub 앱을 사용하는 경우, Phrase App Connector 승인 버튼을 클릭하십시오.

      성공하면, 창/탭이 사라지고 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.