Azure DevOps Server를 GitHub에 연결(온-프레미스)

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

필수 조건

• GitHub와 통합:
  • Azure DevOps Server 2020.1.1 패치 2를 설치하여 GitHub.com 리포지토리에 연결합니다. 이 패치가 없으면 GitHub Enterprise Server 리포지토리에만 연결할 수 있습니다.
  • GitHub 조직 또는 계정에 GitHub 용 Azure Boards 앱을 설치합니다.
• 프로젝트 연결: Azure Boards 또는 Azure DevOps 프로젝트에 연결합니다. 아직 프로젝트가 없는 경우 프로젝트를 만듭니다.
• 사용 권한:
  • 프로젝트 컬렉션 관리자 그룹 및 프로젝트의 기여자 그룹의 구성원이 됩니다. 프로젝트를 만든 경우 사용 권한이 있습니다.
  • 연결하는 GitHub Enterprise Server의 관리자여야 합니다.

인증 옵션

지원되는 인증 옵션은 다음과 같습니다.

Azure DevOps Server를 GitHub Enterprise Server에 연결

1. Azure DevOps Server에 대한 웹 포털을 엽니다.

2. Azure DevOps 로고를 선택하여 프로젝트를 연 다음 GitHub Enterprise 리포지토리에 연결하도록 구성하려는 Azure Boards 프로젝트를 선택합니다.

개인용 액세스 토큰으로 연결

1. PAT를 만들려면 개인용 액세스 토큰 만들기를 참조하세요.

   팁

   GitHub PAT를 만들 때 다음 범위를 포함해야 합니다. repo, admin:repo_hook, read:user, user:email

2. GitHub Enterprise 서버의 URL과 해당 서버에서 인식한 개인용 액세스 토큰 자격 증명을 입력합니다. 그런 다음, 연결을 선택합니다.

사용자 이름 및 암호로 연결

1. GitHub Enterprise 서버의 URL과 해당 서버에서 인식한 관리자 계정 자격 증명을 입력합니다. 그런 다음 연결을 선택합니다.

2. 대화 상자에는 GitHub 관리 권한이 있는 모든 리포지토리가 나열됩니다. Mine과 All 사이를 전환하여 다른 사용자가 표시되는지 확인한 다음 추가할 항목을 확인할 수 있습니다. 완료되면 저장을 선택합니다.

   

3. Azure Boards에서 처음으로 GitHub 계정 또는 조직에 연결하려면 GitHub용 Azure Boards 앱도 설치합니다. 연결 확인에 설명된 절차에 따라 통합을 완료합니다.

연결 문제 해결

Azure Boards-GitHub 통합은 연결을 지원하기 위해 다양한 인증 프로토콜을 사용합니다. 사용자의 권한 범위 또는 인증 자격 증명을 변경하면 Azure Boards에 연결된 GitHub 리포지토리가 해지될 수 있습니다.

GitHub용 Azure Boards 앱이 지원하는 통합에 대한 개요는 Azure Boards-GitHub 통합을 참조하세요.

지원되는 인증 옵션

다음 인증 옵션은 연결하려는 GitHub 플랫폼을 기반으로 지원됩니다.

플랫폼

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• 사용자 계정 GitHub.com
• PAT(개인용 액세스 토큰)

• OAuth
• PAT
• 사용자 이름 및 암호

Azure DevOps Server 2020

해당 없음

• PAT
• 사용자 이름 및 암호

Azure DevOps Server 2019

해당 없음

• OAuth
• PAT
• 사용자 이름 및 암호

참고 항목

GitHub용 Azure Boards 앱을 사용하면 Azure Boards 및 Azure DevOps Services가 GitHub.com 및 GitHub Enterprise Server 리포지토리와 통합됩니다. Azure DevOps Server 2019 이상 버전은 GitHub Enterprise Server 리포지토리와의 통합만 지원합니다. 다른 Git 리포지토리와 통합은 지원되지 않습니다.

액세스 문제 해결

GitHub에 대한 Azure Boards 연결에 더 이상 액세스할 수 없는 경우 red-X가 있는 사용자 인터페이스에 경고 상태가 표시됩니다. 경고 위로 마우스를 가져가면 자격 증명이 더 이상 유효하지 않음을 나타냅니다. 문제를 해결하려면 연결을 제거하고 새 연결을 다시 만듭니다.

다음 해결 방법을 고려합니다.

• 연결에서 OAuth를 사용하는 경우:

  • Azure Boards 애플리케이션은 리포지토리 중 하나에 대한 액세스가 거부되었습니다.

  • GitHub를 사용할 수 없거나 연결할 수 없습니다. 이러한 사용 불가는 서비스 중단 또는 온-프레미스 인프라/네트워크 문제로 인해 발생할 수 있습니다. 다음 링크에서 서비스 상태를 확인할 수 있습니다.

    • GitHub
    • Azure DevOps

    GitHub 리포지토리에 대한 연결을 삭제하고 다시 만듭니다. 이 연결을 다시 만들면 GitHub에서 Azure Boards를 다시 인증하라는 메시지가 표시됩니다.

• 연결에서 PAT를 사용하는 경우:

  • PAT가 해지되거나 필요한 권한 범위가 변경되어 충분하지 않을 수 있습니다.

  • 사용자가 GitHub 리포지토리에 대한 관리 권한을 잃었을 수 있습니다.

    PAT를 다시 만들고 토큰 범위에 필요한 권한이 포함되어 있는지 확인합니다. repo, read:user, user:email, admin:repo_hook

선택한 작업 항목 유형에 대한 XML 정의 업데이트

조직에서 호스트된 XML 또는 온-프레미스 XML 프로세스 모델을 사용하여 작업 추적을 사용자 지정하고 GitHub 링크 형식을 작업 항목 양식의 개발 섹션에 통합하려는 경우 해당 작업 항목 형식에 대한 XML 정의를 업데이트해야 합니다.

예를 들어 사용자 스토리와 버그를 GitHub 커밋에 연결하고 작업 항목 양식의 개발 섹션 내에서 요청을 끌어오려면 이러한 작업 항목 유형에 대한 XML 정의를 업데이트해야 합니다.

XML 정의를 수정하려면 호스트된 XML 프로세스 모델에 설명된 단계를 수행합니다. 각 작업 항목 유형:

1. Group Label="Development" 섹션을 찾습니다.
2. 외부 링크 유형인 GitHub 커밋 및 GitHub 끌어오기 요청을 지원하려면 다음 코드 줄을 추가합니다.

이러한 통합을 통해 Azure Boards의 작업 항목에서 직접 GitHub 활동을 원활하게 추적할 수 있습니다.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

업데이트되면 섹션이 다음과 같이 표시됩니다.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

다음 단계

GitHub 커밋 및 끌어오기 요청을 작업 항목에 연결

관련된 문서

• Azure Boards에 대해 알아보시겠습니까?
• GitHub와 Azure Boards 통합 문제 해결
• GitHub Enterprise 서버 리포지토리 빌드