Skip to main content

외부 리소스를 참조하도록 자동 링크 구성

JIRA 이슈, Zendesk 티켓 등의 외부 리소스에 대한 자동 링크를 추가하여 워크플로를 간소화할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

자동 링크는 GitHub Pro, GitHub Team, GitHub Enterprise Cloud 및 GitHub Enterprise Server이(가) 있는 리포지토리에서 사용할 수 있습니다. 자세한 내용은 “GitHub의 플랜”를 참조하세요.

리포지토리에 대한 관리자 권한이 있는 사람이라면 누구나 문제를 연결하고, 요청을 끌어오고, 메시지를 커밋하고, 설명을 외부 타사 서비스에 릴리스하도록 자동 링크 참조를 구성할 수 있습니다.

이제 자동 링크 참조에 영숫자 문자를 사용할 수 있습니다. 원래 도입되었을 때 사용자 지정 자동 링크는 숫자 식별자를 사용하는 외부 리소스로 제한되었습니다. 이제 사용자 지정 자동 링크가 영숫자 및 숫자 식별자에서 작동합니다.

참조 접두사 및 대상 URL을 지정하여 사용자 지정 자동 링크를 정의합니다.

  • 참조 접두사는 겹치는 이름을 가질 수 없습니다. 예를 들어 리포지토리에는 TICKETTICK과 같은 접두사를 사용한 두 개의 사용자 지정 자동 링크가 있을 수 없습니다. 두 접두사 모두 TICKET123a 문자열과 일치하기 때문입니다.
  • 대상 URL에는 연결된 리소스의 참조 식별자를 나타내는 변수가 포함 <num> 됩니다.

이 절차에서는 외부 리소스를 참조하도록 자동 링크를 구성하는 방법을 보여 줍니다. 예를 들어 사용자가 보고한 티켓을 Zendesk를 사용하여 추적하는 경우, 자신이 연 끌어오기 요청에 있는 티켓 번호를 참조하여 문제를 해결할 수 있습니다.

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름 아래에서 Settings(설정)를 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    탭을 보여 주는 리포지토리 헤더의 스크린샷. "설정" 탭이 진한 주황색 윤곽선으로 강조 표시됩니다.

  3. 사이드바의 "통합" 섹션에서 자동 링크 참조를 클릭합니다.

  4. 페이지의 오른쪽 위에서 자동 링크 참조 추가를 클릭합니다.

    "자동 링크 참조" 페이지의

    스크린샷. "자동 링크 참조 추가" 단추는 진한 주황색 윤곽선으로 강조 표시됩니다.

  5. 외부 리소스에서 사용되는 참조 식별자 형식(영숫자 또는 숫자)을 선택합니다.

  6. "참조 접두사" 아래에 짧고 의미 있는 접두사를 입력합니다. 공동 작업자는 이 텍스트를 사용하여 외부 리소스에 대한 자동 링크를 생성합니다.

  7. 생성할 외부 시스템에 대한 링크 형식을 "대상 URL"에 입력합니다. <num> 변수를 참조 식별자의 개체 틀로 사용합니다.

  8. 미리 보기를 검토하고 자동 링크와 외부 참조가 모두 올바른지 확인한 다음 자동 링크 참조 추가를 클릭하여 링크를 정의합니다.

예를 들어 다음을 입력할 수 있습니다.

  • 참조 접두사: JIRA-
  • 대상 URL: https://jira.example.com/issue?query=<num>
  • 미리 보기: JIRA-123https://jira.example.com/issue?query=123으로 변환됩니다